Homebrew/homebrew — pull request #34275 by DomT4 (2014-11-18 03:55:03+00:00)
Title: Documentation Updates

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:
* Tries to explain a configure script if already generated does not require the autotools.
* 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 0755 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.