From 5a90e7190b0e06379ea2c94561e5914af9370f0b Mon Sep 17 00:00:00 2001 From: Martin Afanasjew Date: Mon, 9 May 2016 15:37:01 +0200 Subject: [PATCH] fetch: document --retry option (#225) --- Library/Homebrew/cmd/fetch.rb | 5 ++++- share/doc/homebrew/brew.1.html | 5 ++++- share/man/man1/brew.1 | 5 ++++- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/Library/Homebrew/cmd/fetch.rb b/Library/Homebrew/cmd/fetch.rb index 1dd6da4b35..249f00fafd 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`] : +#: * `fetch` [`--force`] [`--retry`] [`-v`] [`--devel`|`--HEAD`] [`--deps`] [`--build-from-source`|`--force-bottle`] : #: Download the source packages for the given . #: 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 . #: #: 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 bd6f9f5cf5..6322abf164 100644 --- a/share/doc/homebrew/brew.1.html +++ b/share/doc/homebrew/brew.1.html @@ -139,7 +139,7 @@ installing.

if any problems are found.

edit

Open all of Homebrew for editing.

edit formula

Open formula in the editor.

-
fetch [--force] [-v] [--devel|--HEAD] [--deps] [--build-from-source|--force-bottle] formulae

Download the source packages for the given 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.

If --HEAD or --devel 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.

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/man/man1/brew.1 b/share/man/man1/brew.1 index 9db7b58c4e..99514666f6 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