If a formula's class name contains an uppercase-spelled acronym, the
messages given by `brew install` can be pretty confusing (it recommends
a formula named exactly the same…)
ClosesHomebrew/homebrew#49639.
Signed-off-by: Tim D. Smith <git@tim-smith.us>
Based on recent feedback on some pull requests, I touched up the section about adding tests to formula.
I wanted to make it clearer that the examples demonstrate how to create files on the fly and add a pointer to the tinyxml2 formula (DomT4 pointed it out to me as a good example).
ClosesHomebrew/homebrew#49641.
Signed-off-by: Dominyk Tiller <dominyktiller@gmail.com>
`Formula-Cookbook.md` contains leftover git conflict markers introduced
in 15f291ddaa05cc010456a733b799382175c29dd4.
This commit removes the conflict makers and a duplicated paragraph.
ClosesHomebrew/homebrew#46836.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
Remove duplication, link to the API documentation more often,
tweak wording, add `@UniqMartin` as a maintainer, note `@jacknagel`'s
and `@adamv`'s significant past contributions to Homebrew, delete some
outdated or unneeded documentation, add some missing `Formula` API.
entries and simplify/improve `CONTRIBUTING.md`.
ClosesHomebrew/homebrew#46179.
ClosesHomebrew/homebrew#46618.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
Providing specific reference to the --strict option for brew audit.
ClosesHomebrew/homebrew#43155.
ClosesHomebrew/homebrew#43156.
Signed-off-by: Dominyk Tiller <dominyktiller@gmail.com>
The new one uses sha256 instead of md5 and
the urls still work and are all https, too.
ClosesHomebrew/homebrew#40455.
Signed-off-by: Dominyk Tiller <dominyktiller@gmail.com>
I feel like we’re probably fighting a losing battle here, but here’s a
bundle more updates to the example formula to cover some ground not
already covered.
ClosesHomebrew/homebrew#36644.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
Acceptable-Formulae:
* Makes the language around stable versions stricter.
* Fixes the Homebrew/Head-only lack-of-hyphen.
* Adds Homebrew/Devel-only.
Formula-Cookbook:
* Adds a link to Interesting-Taps-&-Branches.
* Fixes the Python language to match Tim’s latest guidelines.
* Adds a note on options that aren’t ` build-with? ` or `
build-without? `.
Interesting-Taps-&-Branches:
* Slightly modifies the Versions language to better match what the
repository actually ships.
* Adds Homebrew/Devel-only to the language.
ClosesHomebrew/homebrew#35298.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
Use $HOMEBREW_PREFIX instead of `/usr/local` when talking about
formula file path.
ClosesHomebrew/homebrew#34568.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
Mike probably wants to cast an eye over all of this, but in summary:
In the Example Formula:
* Updates with a revision example.
* Updates with a mirror mirror (Whoa meta).
* Replaces the bottles with more modern examples.
* Adds the Yosemite binary dependency options.
* Improves the plist documentation
In the Bottles doc:
* Modernises the expected bottle readout.
* Adds double quotes.
In the FAQ:
* Updates the bottle language to reflect Yosemite’s arrival and the
Bot’s new minimum OS bottle generation.
In the Formula-Cookbook:
* Adds a mega block on the OpenSSL situation in Homebrew, complete with
examples and explanation.
* Changes the X11 dependency example to optional to reflect Jack’s
recently-expressed pattern in other formulae.
* Explains why and how formulae are sometimes revisioned, and the
mechanism behind that.
* Updates the Ldapvi `otool` readout to reflect the new usage of
OpenSSL. Setting a good example and all that.
* Updates the Python language to match Tim’s new Python handling.
* Updates the naming block to explain how Homebrew handles name
conflicts, complete with examples.
* Updates (a tiny bit) the sandbox creation in /tmp to reflect the
current style.
* Updates the chmod to move away from +x towards 0555 instead.
* Labels the `enable-ham` option depreciated rather than old. Slightly
firmer.
* Updates the bottle block instructions to reflect Homebrew’s audit
mechanism not crying about it locally.
ClosesHomebrew/homebrew#34275.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
