diff --git a/Library/Homebrew/cmd/outdated.rb b/Library/Homebrew/cmd/outdated.rb index 7e93644161..b0092a862e 100644 --- a/Library/Homebrew/cmd/outdated.rb +++ b/Library/Homebrew/cmd/outdated.rb @@ -1,4 +1,4 @@ -#: * `outdated` [`--quiet`|`--verbose`|`--json=v1`]: +#: * `outdated` [`--quiet`|`--verbose`|`--json=v1`] [`--fetch-HEAD`]: #: Show formulae that have an updated version available. #: #: By default, version information is displayed in interactive shells, and @@ -11,6 +11,10 @@ #: #: If `--json=` is passed, the output will be in JSON format. The only #: valid version is `v1`. +#: +#: If `--fetch-HEAD` is passed, fetch upstream repository to detect that HEAD +#: formula is outdated. Otherwise HEAD-installation is considered outdated if +#: new stable or devel version is bumped after that installation. require "formula" require "keg" diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb index 1933c05010..2306e9061b 100644 --- a/Library/Homebrew/cmd/upgrade.rb +++ b/Library/Homebrew/cmd/upgrade.rb @@ -1,10 +1,14 @@ -#: * `upgrade` [] [`--cleanup`] []: +#: * `upgrade` [] [`--cleanup`] [`--fetch-HEAD`] []: #: Upgrade outdated, unpinned brews. #: #: Options for the `install` command are also valid here. #: #: If `--cleanup` is specified then remove previously installed version(s). #: +#: If `--fetch-HEAD` is passed, fetch upstream repository to detect that HEAD +#: formula is outdated. Otherwise HEAD-installation is considered outdated if +#: new stable or devel version is bumped after that installation. +#: #: If are given, upgrade only the specified brews (but do so even #: if they are pinned; see `pin`, `unpin`). diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html index ad1b1f3920..b9b6bf3c00 100644 --- a/share/doc/homebrew/brew.1.html +++ b/share/doc/homebrew/brew.1.html @@ -294,7 +294,7 @@ spaces.

If --all is passed, show options for all formulae.

If --installed is passed, show options for all installed formulae.

-
outdated [--quiet|--verbose|--json=v1]

Show formulae that have an updated version available.

+
outdated [--quiet|--verbose|--json=v1] [--fetch-HEAD]

Show formulae that have an updated version available.

By default, version information is displayed in interactive shells, and suppressed otherwise.

@@ -305,7 +305,11 @@ precedence over --verbose).

If --verbose is passed, display detailed version information.

If --json=version is passed, the output will be in JSON format. The only -valid version is v1.

+valid version is v1.

+ +

If --fetch-HEAD is passed, fetch upstream repository to detect that HEAD +formula is outdated. Otherwise HEAD-installation is considered outdated if +new stable or devel version is bumped after that installation.

pin formulae

Pin the specified formulae, preventing them from being upgraded when issuing the brew upgrade command. See also unpin.

prune [--dry-run]

Remove dead symlinks from the Homebrew prefix. This is generally not @@ -436,12 +440,16 @@ source. This is useful for creating patches for the software.

If --merge is specified then git merge is used to include updates (rather than git rebase).

-
upgrade [install-options] [--cleanup] [formulae]

Upgrade outdated, unpinned brews.

+
upgrade [install-options] [--cleanup] [--fetch-HEAD] [formulae]

Upgrade outdated, unpinned brews.

Options for the install command are also valid here.

If --cleanup is specified then remove previously installed formula version(s).

+

If --fetch-HEAD is passed, fetch upstream repository to detect that HEAD +formula is outdated. Otherwise HEAD-installation is considered outdated if +new stable or devel version is bumped after that installation.

+

If formulae are given, upgrade only the specified brews (but do so even if they are pinned; see pin, unpin).

uses [--installed] [--recursive] [--include-build] [--include-optional] [--skip-recommended] [--devel|--HEAD] formulae

Show the formulae that specify formulae as a dependency. When given diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1 index 8777111038..f3c5f38995 100644 --- a/share/man/man1/brew.1 +++ b/share/man/man1/brew.1 @@ -392,7 +392,7 @@ If \fB\-\-all\fR is passed, show options for all formulae\. If \fB\-\-installed\fR is passed, show options for all installed formulae\. . .TP -\fBoutdated\fR [\fB\-\-quiet\fR|\fB\-\-verbose\fR|\fB\-\-json=v1\fR] +\fBoutdated\fR [\fB\-\-quiet\fR|\fB\-\-verbose\fR|\fB\-\-json=v1\fR] [\fB\-\-fetch\-HEAD\fR] Show formulae that have an updated version available\. . .IP @@ -407,6 +407,9 @@ If \fB\-\-verbose\fR is passed, display detailed version information\. .IP If \fB\-\-json=\fR\fIversion\fR is passed, the output will be in JSON format\. The only valid version is \fBv1\fR\. . +.IP +If \fB\-\-fetch\-HEAD\fR is passed, fetch upstream repository to detect that HEAD formula is outdated\. Otherwise HEAD\-installation is considered outdated if new stable or devel version is bumped after that installation\. +. .TP \fBpin\fR \fIformulae\fR Pin the specified \fIformulae\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR command\. See also \fBunpin\fR\. @@ -597,7 +600,7 @@ Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\f If \fB\-\-merge\fR is specified then \fBgit merge\fR is used to include updates (rather than \fBgit rebase\fR)\. . .TP -\fBupgrade\fR [\fIinstall\-options\fR] [\fB\-\-cleanup\fR] [\fIformulae\fR] +\fBupgrade\fR [\fIinstall\-options\fR] [\fB\-\-cleanup\fR] [\fB\-\-fetch\-HEAD\fR] [\fIformulae\fR] Upgrade outdated, unpinned brews\. . .IP @@ -607,6 +610,9 @@ Options for the \fBinstall\fR command are also valid here\. If \fB\-\-cleanup\fR is specified then remove previously installed \fIformula\fR version(s)\. . .IP +If \fB\-\-fetch\-HEAD\fR is passed, fetch upstream repository to detect that HEAD formula is outdated\. Otherwise HEAD\-installation is considered outdated if new stable or devel version is bumped after that installation\. +. +.IP If \fIformulae\fR are given, upgrade only the specified brews (but do so even if they are pinned; see \fBpin\fR, \fBunpin\fR)\. . .TP