aboutsummaryrefslogtreecommitdiffstats
path: root/docs/Acceptable-Formulae.md
diff options
context:
space:
mode:
authorMike McQuaid2017-01-04 10:53:21 +0000
committerMike McQuaid2017-01-04 10:53:21 +0000
commit127e9def5084063cf33e8acb26a970556ef51148 (patch)
tree7d46e96e7730cd6c00dfa756699ba838931a7854 /docs/Acceptable-Formulae.md
parentfc11f633b29e6a2c9c4d49d5fd5452549b328193 (diff)
downloadbrew-127e9def5084063cf33e8acb26a970556ef51148.tar.bz2
Cleanup documentation site
GitHub now nicely generates a documentation site for us at http://brew.sh/brew based on our docs folder. Optimise the output of this and the GitHub docs directory for readability and the various user groupings.
Diffstat (limited to 'docs/Acceptable-Formulae.md')
-rw-r--r--docs/Acceptable-Formulae.md23
1 files changed, 12 insertions, 11 deletions
diff --git a/docs/Acceptable-Formulae.md b/docs/Acceptable-Formulae.md
index ac65d0802..12084fad7 100644
--- a/docs/Acceptable-Formulae.md
+++ b/docs/Acceptable-Formulae.md
@@ -29,16 +29,16 @@ There are exceptions:
#### Examples
- Formula | Reason
- --- | ---
- ruby, python, perl | People want newer versions
- bash | macOS's bash is stuck at 3.2 because newer versions are licensed under GPLv3
- zsh | This was a mistake, but it’s too late to remove it
- emacs, vim | [Too popular to move to dupes](https://github.com/Homebrew/homebrew/pull/21594#issuecomment-21968819)
- subversion | Originally added for 10.5, but people want the latest version
- libcurl | Some formulae require a newer version than macOS provides
- openssl | macOS's openssl is deprecated & outdated.
- libxml2 | Historically, macOS's libxml2 has been buggy
+| Formula | Reason |
+|--------------------|-------------------------------------------------------------------------------------------------------|
+| ruby, python, perl | People want newer versions |
+| bash | macOS's bash is stuck at 3.2 because newer versions are licensed under GPLv3 |
+| zsh | This was a mistake, but it’s too late to remove it |
+| emacs, vim | [Too popular to move to dupes](https://github.com/Homebrew/homebrew/pull/21594#issuecomment-21968819) |
+| subversion | Originally added for 10.5, but people want the latest version |
+| libcurl | Some formulae require a newer version than macOS provides |
+| openssl | macOS's openssl is deprecated & outdated. |
+| libxml2 | Historically, macOS's libxml2 has been buggy |
We also maintain [a tap](https://github.com/Homebrew/homebrew-dupes) that
contains many duplicates not otherwise found in Homebrew.
@@ -80,7 +80,8 @@ useful to people. Just install the stuff! Having to faff around with
foo-ruby foo-perl etc. sucks.
### Niche (or self-submitted) Stuff<a name="Niche_Stuff"></a>
-The software in question must be
+The software in question must be:
+
* maintained (e.g. upstream is still making new releases)
* known
* stable (e.g. not declared "unstable" or "beta" by upstream)