Clarify `install --force`

Since 5bddaf2e ("Stop supportinb `brew install --force`), the --force
argument is still useful but only to overcome the blacklist
restrictions. Document this.

Signed-off-by: Jack Nagel <jacknagel@gmail.com>

2 files changed, 14 insertions, 4 deletions

diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md
index a59eaecba..b96f03b76 100644
--- a/Library/Contributions/manpages/brew.1.md
+++ b/Library/Contributions/manpages/brew.1.md
@@ -145,9 +145,8 @@ For the full command list, see the COMMANDS section.
     <formula> is usually the name of the formula to install, but may also be
     the URL for an arbitrary formula.
 
-    If `--force` is passed, will install <formula> even if it is already
-    installed. This can be used to re-install a formula without removing
-    it first.
+    If `--force` is passed, will install <formula> if it exists, even if it
+    is blacklisted.
 
     If `--debug` is passed and brewing fails, open a shell inside the
     temporary directory used for compiling.
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 2a8b25dd6..edbecaf12 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -168,7 +168,7 @@ Install \fIformula\fR\.
 \fIformula\fR is usually the name of the formula to install, but may also be the URL for an arbitrary formula\.
 .
 .IP
-If \fB\-\-force\fR is passed, will install \fIformula\fR even if it is already installed\. This can be used to re\-install a formula without removing it first\.
+If \fB\-\-force\fR is passed, will install \fIformula\fR if it exists, even if it is blacklisted\.
 .
 .IP
 If \fB\-\-debug\fR is passed and brewing fails, open a shell inside the temporary directory used for compiling\.
@@ -275,6 +275,13 @@ Perform a substring search of formula names for \fItext\fR\. If \fItext\fR is su
 Search for \fItext\fR on the MacPorts or Fink package search page\.
 .
 .TP
+\fBtap\fR \fItap\fR
+Tap a new formula repository from GitHub\.
+.
+.IP
+\fItap\fR is of the form \fIuser\fR/\fIrepo\fR, e\.g\. \fBbrew tap homebrew/dupes\fR\.
+.
+.TP
 \fBtest\fR \fIformula\fR
 A few formulae provide a test method\. \fBbrew test <formula>\fR runs this test method\. There is no standard output or return code, but it should generally indicate to the user if something is wrong with the installed formula\.
 .
@@ -286,6 +293,10 @@ Example: \fBbrew install jruby && brew test jruby\fR
 Unsymlink \fIformula\fR from the Homebrew prefix\. This can be useful for temporarily disabling a formula: \fBbrew unlink foo && commands && brew link foo\fR\.
 .
 .TP
+\fBuntap\fR \fItap\fR
+Remove a tapped repository\.
+.
+.TP
 \fBupdate [\-\-rebase]\fR
 Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\fR(1)\.
 .