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>
* Moved the `pip` homepage to something that points more directly at
`pip`.
* Adds a note on `test do`. All the maintainers and the bot check the
existence of such things these days, but I guess if anyone stumbles
across the document it’s useful to say.
* GiX is formally dead, and has two blessed forks.
* Typo on contributor.
ClosesHomebrew/homebrew#35467.
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>
`brew-gem`'s link is 404.
`brew-pip` has reached EOL.
Thus I updates the link of `brew-gem`, and remove descriptions
about `brew-pip`.
Thanks @DomT4 for pointing out brew-gem's new home.
ClosesHomebrew/homebrew#34569.
Signed-off-by: Jack Nagel <jacknagel@gmail.com>
How-to-use-keg-only-outside-of-brew:
* A new piece of documentation detailing how to deal with using
keg_only formula outside of Brew itself. We’ve had a lot of questions
and issues about this recently, and the solutions aren’t as easy and
explicit to find elsewhere, so detailing it here may help reduce some
of the questions we’ve seen recently.
* I possibly whinged too much in the second section. I’m open to
criticism and being called whiny.
* Details flags, prepending the $PATH, and dealing with pkg-config.
ClosesHomebrew/homebrew#34608.
Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>
More proposed documentation updates.
Acceptable Formulae:
* Adds Perl to the list of stuff we offer Dupes of in the Core.
* Notes that OS X’s OpenSSL is usually horribly outdated.
* Removes the incorrect space between font and forge.
Common Issues:
* We said three issues, we listed four. Oops.
External Commands:
* The cache is usually at /Library rather than ~/Library, and the rest
of the documentation says /Library, so this makes the referencing
consistent.
FAQ:
* Adds a tiny section on pinning formulae.
Interesting-Taps-And-Branches:
* Notes gaming-emulation software belongs in Homebrew/Games as well.
* nolith/Embedded hasn’t been touched for 28 months. I’ve cut it.
* anarchivist/forensics hasn’t been touched for 35 months. I’ve cut it.
* codebutler’s GTK+ experiment seems to have been terminated after one
commit. I’ve cut it.
* paxam/linux hasn’t been touched for 34 months. I’ve cut it.
* rmyers/homebrew hasn’t been touched in 42 months. I’ve cut it.
* nddrylliog/winbrew has moved, I’ve changed the URL to the new one.
Winbrew.md:
* Removed. It’s referenced in the prior file, and doesn’t really need
its own.
ClosesHomebrew/homebrew#34599.
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>
