mirrors/brew
1
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2025-07-14 16:09:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Acceptable Formulae: base on current thinking.

Browse Source
This commit is contained in:
Mike McQuaid 2018-04-26 08:26:57 +01:00 committed by GitHub
parent ae6ae30857
commit 27ec9dae5f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/Acceptable-Formulae.md
View File

@ -13,20 +13,15 @@ We now accept versioned formulae as long as they [meet the requirements](Version
### We don’t like tools that upgrade themselves ### We don’t like tools that upgrade themselves
Software that can upgrade itself does not integrate well with Homebrew's own Software that can upgrade itself does not integrate well with Homebrew's own
upgrade functionality. upgrade functionality. The self-update functionality should be disabled if at all possible.
### We don’t like install-scripts that download things ### We don’t like install-scripts that download unversioned things
Because that circumvents our hash-checks, makes finding/fixing bugs We don't like install scripts that are pulling from the `master` branch of Git repositories or unversioned, unchecksummed tarballs. These should use `resource` blocks instead. Note that we now allow tools like `pip`, `cargo`, `gem` to download things during installation.
harder, often breaks patches and disables the caching. Almost always you
can add a resource to the formula file to handle the
separate download and then the installer script will not attempt to load
that stuff on demand. Or there is a command-line switch where you can
point it to the downloaded archive in order to avoid loading.
### We don’t like binary formulae ### We don’t like binary formulae
Our policy is that formulae in the core tap Our policy is that formulae in the core tap
([homebrew/core](https://github.com/Homebrew/homebrew-core)) must be open-source ([homebrew/core](https://github.com/Homebrew/homebrew-core)) must be open-source
and either built from source or produce cross-platform binaries (e.g. Java). and either built from source or produce cross-platform binaries (e.g. Java, Mono).
Binary-only formulae should go to Binary-only formulae should go to
[Homebrew Cask](https://github.com/caskroom/homebrew-cask). [Homebrew Cask](https://github.com/caskroom/homebrew-cask).
@ -41,7 +36,7 @@ due to upstream changes and we can’t provide [bottles](Bottles.md) for them.
### Niche (or self-submitted) stuff ### Niche (or self-submitted) stuff
The software in question must: The software in question must:
* be maintained (e.g. upstream is still making new releases) * be maintained (e.g. it works without patching on all supported macOS releases and has no outstanding, unpatched security vulnerabilites)
* be known * be known
* be stable (e.g. not declared "unstable" or "beta" by upstream) * be stable (e.g. not declared "unstable" or "beta" by upstream)
* be used * be used