aboutsummaryrefslogtreecommitdiffstats
path: root/share/man/man1
diff options
context:
space:
mode:
authorilovezfs2016-04-04 03:18:55 -0700
committerilovezfs2016-04-05 07:25:27 -0700
commitfad235d8e82ae57b2004429a0297f313aafa3186 (patch)
tree02b3a8bfbfa5c0ae7deafc0b70fdb52c6bff0b6e /share/man/man1
parent1b7e13df4f936dd318a23698b7b69bd2ca0e2487 (diff)
downloadbrew-fad235d8e82ae57b2004429a0297f313aafa3186.tar.bz2
tap: support --full even if installed
Makes `tap` re-runnable and unshallows when requested with `--full`. Tapping with a different URL raises an exception. The homebrew/core tap cannot be untapped with `untap` so running `brew tap --full homebrew/core` is now a built-in way to get a full clone of this tap without resorting to workarounds. Closes #17. Signed-off-by: ilovezfs <ilovezfs@icloud.com>
Diffstat (limited to 'share/man/man1')
-rw-r--r--share/man/man1/brew.15
1 files changed, 4 insertions, 1 deletions
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 8f1167f31..c9adf6bea 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -416,7 +416,10 @@ With \fIURL\fR unspecified, taps a formula repository from GitHub using HTTPS\.
With \fIURL\fR specified, taps a formula repository from anywhere, using any transport protocol that \fBgit\fR handles\. The one\-argument form of \fBtap\fR simplifies but also limits\. This two\-argument command makes no assumptions, so taps can be cloned from places other than GitHub and using protocols other than HTTPS, e\.g\., SSH, GIT, HTTP, FTP(S), RSYNC\.
.
.IP
-By default, the repository is cloned as a shallow copy (\fB\-\-depth=1\fR), but if \fB\-\-full\fR is passed, a full clone will be used\.
+By default, the repository is cloned as a shallow copy (\fB\-\-depth=1\fR), but if \fB\-\-full\fR is passed, a full clone will be used\. To convert a shallow copy to a full copy, you can retap passing \fB\-\-full\fR without first untapping\.
+.
+.IP
+\fBtap\fR is re\-runnable and exits successfully if there\'s nothing to do\. However, retapping with a different \fIURL\fR will cause an exception, so first \fBuntap\fR if you need to modify the \fIURL\fR\.
.
.TP
\fBtap\fR \fB\-\-repair\fR