From 2852b2836da3d8e395a88397c8cf29f72cf03817 Mon Sep 17 00:00:00 2001 From: Jack Nagel Date: Sun, 18 Mar 2012 16:00:48 -0500 Subject: [PATCH] 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 --- Library/Contributions/manpages/brew.1.md | 5 ++--- share/man/man1/brew.1 | 13 ++++++++++++- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md index a59eaecba7..b96f03b762 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. 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 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 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 2a8b25dd62..edbecaf125 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 \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)\. .