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>
This commit is contained in:
Jack Nagel 2012-03-18 16:00:48 -05:00
parent 267f58a7d6
commit 2852b2836d
2 changed files with 14 additions and 4 deletions

View File

@ -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.

View File

@ -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)\.
.