This document lists Tigerbrew and Linuxbrew as interesting forks, not
branches (they used to be "Interesting Branches (aka forks)" but that
changed in b7455469), so "Interesting Taps & Branches" is a more fitting
title.

The term "branches" is also presumably confusing to folks with a shallow
understanding of GitHub and/or git who may not realize how GitHub forks
and git branches are related.

We're moving more stuff to Homebrew Cask which is better maintained and run.

Closes Homebrew/homebrew#50632.

Signed-off-by: Xu Cheng <xucheng@me.com>

Remove duplication, link to the API documentation more often,
tweak wording, add `@UniqMartin` as a maintainer, note `@jacknagel`'s
and `@adamv`'s significant past contributions to Homebrew, delete some
outdated or unneeded documentation, add some missing `Formula` API.
entries and simplify/improve `CONTRIBUTING.md`.

Closes Homebrew/homebrew#46179.

Closes Homebrew/homebrew#46618.

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

Closes Homebrew/homebrew#46243.

Signed-off-by: Baptiste Fontaine <batifon@yahoo.fr>

Always use the `<user/repo>` format as used by the `brew tap` command.
Also fixed a link to `homebrew/head-only` and sorted a list in `FAQ.md`
in alphabetical order.

Closes Homebrew/homebrew#45535.

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

Closes Homebrew/homebrew#41262.

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

Closes Homebrew/homebrew#40478.

Signed-off-by: Dominyk Tiller <dominyktiller@gmail.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>

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>

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>

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>

Closes Homebrew/homebrew#33211.