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.
But this paragraph is not talking about dependencies on autotools formulae, it is talking about modifying the generated by `brew create`. Specifically, it is instructing the user to remove the commented-out cmake text (https://github.com/Homebrew/homebrew/blob/a6542db73b207c119e859bee8af2a12a3a3e6e50/Library/Homebrew/cmd/create.rb#L137 and https://github.com/Homebrew/homebrew/blob/a6542db73b207c119e859bee8af2a12a3a3e6e50/Library/Homebrew/cmd/create.rb#L158) if there is a configure script present.