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 <formula> is usually the name of the formula to install, but may also be
the URL for an arbitrary formula. the URL for an arbitrary formula.
If `--force` is passed, will install <formula> even if it is already If `--force` is passed, will install <formula> if it exists, even if it
installed. This can be used to re-install a formula without removing is blacklisted.
it first.
If `--debug` is passed and brewing fails, open a shell inside the If `--debug` is passed and brewing fails, open a shell inside the
temporary directory used for compiling. 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\. \fIformula\fR is usually the name of the formula to install, but may also be the URL for an arbitrary formula\.
. .
.IP .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 .IP
If \fB\-\-debug\fR is passed and brewing fails, open a shell inside the temporary directory used for compiling\. 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\. Search for \fItext\fR on the MacPorts or Fink package search page\.
. .
.TP .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 \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\. 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\. 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 .TP
\fBuntap\fR \fItap\fR
Remove a tapped repository\.
.
.TP
\fBupdate [\-\-rebase]\fR \fBupdate [\-\-rebase]\fR
Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\fR(1)\. Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\fR(1)\.
. .