From e2014aea1fa74bab99aec433f57794c56c3a6865 Mon Sep 17 00:00:00 2001
From: Mike McQuaid <mike@mikemcquaid.com>
Date: Sun, 6 Dec 2015 22:18:16 +0000
Subject: [PATCH] Overhaul, simplify and cleanup documentation.

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>
---
 Formula/brew-gem.rb | 2 +-
 Formula/brew-pip.rb | 2 +-
 Formula/docbook.rb  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Formula/brew-gem.rb b/Formula/brew-gem.rb
index 649c7adec5..289ee78d0b 100644
--- a/Formula/brew-gem.rb
+++ b/Formula/brew-gem.rb
@@ -1,5 +1,5 @@
 class BrewGem < Formula
-  desc "Install rubygems as homebrew formulas"
+  desc "Install rubygems as homebrew formulae"
   homepage "https://github.com/sportngin/brew-gem"
   url "https://github.com/sportngin/brew-gem/archive/v0.5.2.tar.gz"
   sha256 "77ed5b2e4f3b15a9d316691c9e0fb8c25367d313d7f6426d03d733866ec4f75f"
diff --git a/Formula/brew-pip.rb b/Formula/brew-pip.rb
index 4d15c61fd7..24a9088047 100644
--- a/Formula/brew-pip.rb
+++ b/Formula/brew-pip.rb
@@ -1,5 +1,5 @@
 class BrewPip < Formula
-  desc "Install pip packages as homebrew formulas"
+  desc "Install pip packages as homebrew formulae"
   homepage "https://github.com/hanxue/brew-pip"
   url "https://github.com/hanxue/brew-pip/archive/0.4.1.tar.gz"
   sha256 "9049a6db97188560404d8ecad2a7ade72a4be4338d5241097d3e3e8e215cda28"
diff --git a/Formula/docbook.rb b/Formula/docbook.rb
index 3344000a00..43945ad85b 100644
--- a/Formula/docbook.rb
+++ b/Formula/docbook.rb
@@ -67,7 +67,7 @@ class Docbook < Formula
     ENV["XML_CATALOG_FILES"] = "#{etc}/xml/catalog"
 
     # only create catalog file if it doesn't exist already to avoid content added
-    # by other formulas to be removed
+    # by other formulae to be removed
     unless File.file?("#{etc}/xml/catalog")
       system "xmlcatalog", "--noout", "--create", "#{etc}/xml/catalog"
     end