diff options
| author | Baptiste Fontaine | 2015-11-21 14:42:46 +0100 |
|---|---|---|
| committer | Baptiste Fontaine | 2015-11-23 22:05:16 +0100 |
| commit | 2838fe493ece18e27d1dde16e28405f9938c8bcc (patch) | |
| tree | 433ae24fa8fa83f8b23f9fce59b8600937f8ab64 /share | |
| parent | e8c8b876af9f966a63c802b7fcbbe2c8fabebe48 (diff) | |
| download | brew-2838fe493ece18e27d1dde16e28405f9938c8bcc.tar.bz2 | |
Docs: deprecate homebrew/head-only
Closes Homebrew/homebrew#46243.
Signed-off-by: Baptiste Fontaine <batifon@yahoo.fr>
Diffstat (limited to 'share')
| -rw-r--r-- | share/doc/homebrew/Acceptable-Formulae.md | 9 | ||||
| -rw-r--r-- | share/doc/homebrew/Formula-Cookbook.md | 2 | ||||
| -rw-r--r-- | share/doc/homebrew/Interesting-Taps-&-Branches.md | 2 |
3 files changed, 8 insertions, 5 deletions
diff --git a/share/doc/homebrew/Acceptable-Formulae.md b/share/doc/homebrew/Acceptable-Formulae.md index 9554c8b3d..d59972ff6 100644 --- a/share/doc/homebrew/Acceptable-Formulae.md +++ b/share/doc/homebrew/Acceptable-Formulae.md @@ -66,9 +66,12 @@ Formulae in the core repository must have a stable version tagged by the upstream project. Tarballs are preferred to git checkouts, and tarballs should include the version in the filename whenever possible. -Software that does not provide a stable, tagged version, or had guidance to -always install the most recent version, should be put in -[homebrew/head-only](https://github.com/Homebrew/homebrew-head-only) or [homebrew/devel-only](https://github.com/Homebrew/homebrew-devel-only). +Software that only provides a development/beta, tagged version should be put in +[homebrew/devel-only](https://github.com/Homebrew/homebrew-devel-only). +We don’t accept software without a tagged version because they regularly break +due to upstream changes; we can’t provide [bottles](Bottles.md) for them; and +we don’t have an automatic update mechanism for `head-only` formulae which +makes them very quickly outdated. ### Bindings First check that there is not already a binding available via diff --git a/share/doc/homebrew/Formula-Cookbook.md b/share/doc/homebrew/Formula-Cookbook.md index ac6f8a85e..356ae2814 100644 --- a/share/doc/homebrew/Formula-Cookbook.md +++ b/share/doc/homebrew/Formula-Cookbook.md @@ -67,7 +67,7 @@ Before contributing, make sure your package: * isn't in another [Homebrew tap](https://github.com/Homebrew) * isn't already waiting to be merged (check the [issue tracker](https://github.com/Homebrew/homebrew/issues)) * is still supported by upstream -* has a stable, tagged version (i.e. not just a GitHub repository with no versions). See [Interesting-Taps-&-Branches](Interesting-Taps-&-Branches.md) for where pre-release and head-only versions belong. +* has a stable, tagged version (i.e. not just a GitHub repository with no versions). See [Interesting-Taps-&-Branches](Interesting-Taps-&-Branches.md) for where pre-release versions belong. * passes all `brew audit --strict --online $FORMULA` tests. Make sure you search thoroughly (all aliases!). We don’t want you to waste your time. diff --git a/share/doc/homebrew/Interesting-Taps-&-Branches.md b/share/doc/homebrew/Interesting-Taps-&-Branches.md index 9313be359..93d0168c4 100644 --- a/share/doc/homebrew/Interesting-Taps-&-Branches.md +++ b/share/doc/homebrew/Interesting-Taps-&-Branches.md @@ -22,7 +22,7 @@ Homebrew has the capability to add (and remove) multiple taps to your local inst * [homebrew/games](https://github.com/Homebrew/homebrew-games): Game or gaming-emulation related formulae. -* [homebrew/head-only](https://github.com/Homebrew/homebrew-head-only): A tap for brews that only have unstable, unreleased versions. +* [homebrew/head-only](https://github.com/Homebrew/homebrew-head-only): A tap for brews that only have unstable, unreleased versions. This tap is **deprecated** and doesn’t accept new formulae. * [homebrew/nginx](https://github.com/Homebrew/homebrew-nginx): Feature rich Nginx tap for modules. |