fetch: document --retry option (#225)

3 files changed, 12 insertions, 3 deletions

diff --git a/Library/Homebrew/cmd/fetch.rb b/Library/Homebrew/cmd/fetch.rb
index 1dd6da4b3..249f00faf 100644
--- a/Library/Homebrew/cmd/fetch.rb
+++ b/Library/Homebrew/cmd/fetch.rb
@@ -1,4 +1,4 @@
-#:  * `fetch` [`--force`] [`-v`] [`--devel`|`--HEAD`] [`--deps`] [`--build-from-source`|`--force-bottle`] <formulae>:
+#:  * `fetch` [`--force`] [`--retry`] [`-v`] [`--devel`|`--HEAD`] [`--deps`] [`--build-from-source`|`--force-bottle`] <formulae>:
 #:    Download the source packages for the given <formulae>.
 #:    For tarballs, also print SHA-256 checksums.
 #:
@@ -10,6 +10,9 @@
 #:
 #:    If `--force` is passed, remove a previously cached version and re-fetch.
 #:
+#:    If `--retry` is passed, retry if a download fails or re-download if the
+#:    checksum of a previously cached version no longer matches.
+#:
 #:    If `--deps` is passed, also download dependencies for any listed <formulae>.
 #:
 #:    If `--build-from-source` is passed, download the source rather than a
diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html
index bd6f9f5cf..6322abf16 100644
--- a/share/doc/homebrew/brew.1.html
+++ b/share/doc/homebrew/brew.1.html
@@ -139,7 +139,7 @@ installing.</p></dd>
 if any problems are found.</p></dd>
 <dt class="flush"><code>edit</code></dt><dd><p>Open all of Homebrew for editing.</p></dd>
 <dt><code>edit</code> <var>formula</var></dt><dd><p>Open <var>formula</var> in the editor.</p></dd>
-<dt><code>fetch</code> [<code>--force</code>] [<code>-v</code>] [<code>--devel</code>|<code>--HEAD</code>] [<code>--deps</code>] [<code>--build-from-source</code>|<code>--force-bottle</code>] <var>formulae</var></dt><dd><p>Download the source packages for the given <var>formulae</var>.
+<dt><code>fetch</code> [<code>--force</code>] [<code>--retry</code>] [<code>-v</code>] [<code>--devel</code>|<code>--HEAD</code>] [<code>--deps</code>] [<code>--build-from-source</code>|<code>--force-bottle</code>] <var>formulae</var></dt><dd><p>Download the source packages for the given <var>formulae</var>.
 For tarballs, also print SHA-256 checksums.</p>
 
 <p>If <code>--HEAD</code> or <code>--devel</code> is passed, fetch that version instead of the
@@ -150,6 +150,9 @@ This is useful for seeing if an existing VCS cache has been updated.</p>
 
 <p>If <code>--force</code> is passed, remove a previously cached version and re-fetch.</p>
 
+<p>If <code>--retry</code> is passed, retry if a download fails or re-download if the
+checksum of a previously cached version no longer matches.</p>
+
 <p>If <code>--deps</code> is passed, also download dependencies for any listed <var>formulae</var>.</p>
 
 <p>If <code>--build-from-source</code> is passed, download the source rather than a
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 9db7b58c4..99514666f 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -189,7 +189,7 @@ Open all of Homebrew for editing\.
 Open \fIformula\fR in the editor\.
 .
 .TP
-\fBfetch\fR [\fB\-\-force\fR] [\fB\-v\fR] [\fB\-\-devel\fR|\fB\-\-HEAD\fR] [\fB\-\-deps\fR] [\fB\-\-build\-from\-source\fR|\fB\-\-force\-bottle\fR] \fIformulae\fR
+\fBfetch\fR [\fB\-\-force\fR] [\fB\-\-retry\fR] [\fB\-v\fR] [\fB\-\-devel\fR|\fB\-\-HEAD\fR] [\fB\-\-deps\fR] [\fB\-\-build\-from\-source\fR|\fB\-\-force\-bottle\fR] \fIformulae\fR
 Download the source packages for the given \fIformulae\fR\. For tarballs, also print SHA\-256 checksums\.
 .
 .IP
@@ -202,6 +202,9 @@ If \fB\-v\fR is passed, do a verbose VCS checkout, if the URL represents a VCS\.
 If \fB\-\-force\fR is passed, remove a previously cached version and re\-fetch\.
 .
 .IP
+If \fB\-\-retry\fR is passed, retry if a download fails or re\-download if the checksum of a previously cached version no longer matches\.
+.
+.IP
 If \fB\-\-deps\fR is passed, also download dependencies for any listed \fIformulae\fR\.
 .
 .IP