People want to install things like GIMP using Homebrew so let's make it
easier for them to find a decent installation method.

Closes Homebrew/homebrew#34496.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

Use $HOMEBREW_PREFIX instead of `/usr/local` when talking about
formula file path.

Closes Homebrew/homebrew#34568.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

Closes Homebrew/homebrew#34398.

Closes Homebrew/homebrew#34445.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

Mentioned in Homebrew/homebrew#34484.

Closes Homebrew/homebrew#34228.

Closes Homebrew/homebrew#34246.

We don't want to do so when building bottles or we can end up with some weird stuff being bottled unintentionally (and it'll run twice; once before bottling, once afterwards).

Fixes Homebrew/homebrew#34349.

Closes Homebrew/homebrew#34397.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

- allow using (UPSTREAM_)GIT_URL to find the tap name
- push bottles to a remote based on the tap name

Closes Homebrew/homebrew#34350.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

These classes are never instantiated with arguments, so we can get rid
of the unnecessary array splatting.

This formula no longer works on anything newer than Lion (See Homebrew/homebrew#34039),
so handing it over to Misty’s Tigerbrew fork where it could still be
useful. As far as tap_migrations goes though, it's being moved to the
boneyard due to Misty's fork not technically being a 'tap'.

Closes Homebrew/homebrew#34348.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>

Update man page to reflect change per issue Homebrew/homebrew#27813 (commit 9362781).

Closes Homebrew/homebrew#34317.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>

Closes Homebrew/homebrew#34312.
Closes Homebrew/homebrew#34358.

This handles the case where e.g. a default_formula cannot be installed
on Yosemite which causes the build to fail.

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.

Closes Homebrew/homebrew#34275.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

Closes Homebrew/homebrew#34159.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>

Closes Homebrew/homebrew#34230.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>

Options such as --userimg=<path> should be parsed as an option with an
equals in its name ("userimg=") and without the path argument in
Option.name

Closes Homebrew/homebrew#34219.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>