docs: update manpages

This commit is contained in:
Jonathan Chang 2020-07-16 17:34:46 +10:00
parent 299db98dbf
commit 1efb55d953
2 changed files with 26 additions and 2 deletions

View File

@ -356,9 +356,15 @@ otherwise.
* `-v`, `--verbose`: * `-v`, `--verbose`:
Include detailed version information. Include detailed version information.
* `--json`: * `--json`:
Print output in JSON format. Currently the default and only accepted value for *`version`* is `v1`. See the docs for examples of using the JSON output: <https://docs.brew.sh/Querying-Brew> Print output in JSON format. Currently the default and only accepted value for *`version`* is `v1`. See the docs for examples of using the JSON output: <https://docs.brew.sh/Querying-Brew>. By default, this option treats all arguments as formulae. To treat arguments as casks, use the --cask option.
* `--fetch-HEAD`: * `--fetch-HEAD`:
Fetch the upstream repository to detect if the HEAD installation of the formula is outdated. Otherwise, the repository's HEAD will only be checked for updates when a new stable or development version has been released. Fetch the upstream repository to detect if the HEAD installation of the formula is outdated. Otherwise, the repository's HEAD will only be checked for updates when a new stable or development version has been released.
* `--greedy`:
Print outdated casks with `auto_updates` or `version :latest`
* `--formula`:
Treat all arguments as formulae
* `--cask`:
Treat all arguments as casks
### `pin` *`formula`* ### `pin` *`formula`*
@ -556,6 +562,8 @@ the upgraded formulae or, every 30 days, for all formulae.
Print install times for each formula at the end of the run. Print install times for each formula at the end of the run.
* `-n`, `--dry-run`: * `-n`, `--dry-run`:
Show what would be upgraded, but do not actually upgrade anything. Show what would be upgraded, but do not actually upgrade anything.
* `--greedy`:
Upgrade casks with `auto_updates` or `version :latest`
### `uses` [*`options`*] *`formula`* ### `uses` [*`options`*] *`formula`*

View File

@ -477,12 +477,24 @@ Include detailed version information\.
. .
.TP .TP
\fB\-\-json\fR \fB\-\-json\fR
Print output in JSON format\. Currently the default and only accepted value for \fIversion\fR is \fBv1\fR\. See the docs for examples of using the JSON output: \fIhttps://docs\.brew\.sh/Querying\-Brew\fR Print output in JSON format\. Currently the default and only accepted value for \fIversion\fR is \fBv1\fR\. See the docs for examples of using the JSON output: \fIhttps://docs\.brew\.sh/Querying\-Brew\fR\. By default, this option treats all arguments as formulae\. To treat arguments as casks, use the \-\-cask option\.
. .
.TP .TP
\fB\-\-fetch\-HEAD\fR \fB\-\-fetch\-HEAD\fR
Fetch the upstream repository to detect if the HEAD installation of the formula is outdated\. Otherwise, the repository\'s HEAD will only be checked for updates when a new stable or development version has been released\. Fetch the upstream repository to detect if the HEAD installation of the formula is outdated\. Otherwise, the repository\'s HEAD will only be checked for updates when a new stable or development version has been released\.
. .
.TP
\fB\-\-greedy\fR
Print outdated casks with \fBauto_updates\fR or \fBversion :latest\fR
.
.TP
\fB\-\-formula\fR
Treat all arguments as formulae
.
.TP
\fB\-\-cask\fR
Treat all arguments as casks
.
.SS "\fBpin\fR \fIformula\fR" .SS "\fBpin\fR \fIformula\fR"
Pin the specified \fIformula\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR \fIformula\fR command\. See also \fBunpin\fR\. Pin the specified \fIformula\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR \fIformula\fR command\. See also \fBunpin\fR\.
. .
@ -722,6 +734,10 @@ Print install times for each formula at the end of the run\.
\fB\-n\fR, \fB\-\-dry\-run\fR \fB\-n\fR, \fB\-\-dry\-run\fR
Show what would be upgraded, but do not actually upgrade anything\. Show what would be upgraded, but do not actually upgrade anything\.
. .
.TP
\fB\-\-greedy\fR
Upgrade casks with \fBauto_updates\fR or \fBversion :latest\fR
.
.SS "\fBuses\fR [\fIoptions\fR] \fIformula\fR" .SS "\fBuses\fR [\fIoptions\fR] \fIformula\fR"
Show formulae that specify \fIformula\fR as a dependency\. When given multiple formula arguments, show the intersection of formulae that use \fIformula\fR\. By default, \fBuses\fR shows all formulae that specify \fIformula\fR as a required or recommended dependency for their stable builds\. Show formulae that specify \fIformula\fR as a dependency\. When given multiple formula arguments, show the intersection of formulae that use \fIformula\fR\. By default, \fBuses\fR shows all formulae that specify \fIformula\fR as a required or recommended dependency for their stable builds\.
. .