Closes Homebrew/homebrew#36916.

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

Also add support to `brew uses` to ignore build or optional dependencies.

Closes Homebrew/homebrew#36154.
Closes Homebrew/homebrew#36656.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.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.

Closes Homebrew/homebrew#36644.

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

Closes Homebrew/homebrew#36179.
Closes Homebrew/homebrew#36184.

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

Closes Homebrew/homebrew#36252.

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

Closes Homebrew/homebrew#36087.

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

Some clarification on these given discussion in https://github.com/Homebrew/homebrew/pull/35853

.

Closes Homebrew/homebrew#35880.

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

Closes Homebrew/homebrew#35529.

Signed-off-by: Jack Nagel <jacknagel@gmail.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.

Closes Homebrew/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.

Closes Homebrew/homebrew#35298.

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

Closes Homebrew/homebrew#35080.

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

@gapple has taken the mantle of brew services: https://github.com/Homebrew/homebrew/issues/28657#issuecomment-58318215



Closes Homebrew/homebrew#35090.

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

Some minor changes to reflect Homebrew/homebrew#34989, and other bits and pieces.

Closes Homebrew/homebrew#35023.

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

prepend_path doesn't do anything if path doesn't already exist, so use
prepend_create_path.

Closes Homebrew/homebrew#34793.

Closes Homebrew/homebrew#34859.

Signed-off-by: Misty De Meo <mistydemeo@gmail.com>

Closes Homebrew/homebrew#34785.

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.

Closes Homebrew/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.

Closes Homebrew/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.

Closes Homebrew/homebrew#34599.

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

which is not necessarily the same as the prefix.

Closes Homebrew/homebrew#34571.

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#34228.

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>

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>

The bigger, uglier brother of Homebrew/homebrew#34090.

Closes Homebrew/homebrew#34106.

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

The link to the Homebrew dupes repo was broken because of a typo.

Closes Homebrew/homebrew#33931.

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