mirrors/brew
1
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2025-07-14 16:09:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

manpages: update.

Browse Source
This commit is contained in:
Mike McQuaid 2020-04-20 08:27:28 +01:00
parent 9d6eb41fc5
commit 66eb11d55c
No known key found for this signature in database
GPG Key ID: 48A898132FD8EE70
2 changed files with 101 additions and 103 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
docs/Manpage.md
View File

@ -44,13 +44,17 @@ If no search term is provided, all locally available formulae are listed.
### `analytics` [*`subcommand`*] ### `analytics` [*`subcommand`*]
If `on` or `off` is passed, turn Homebrew's analytics on or off respectively. Control Homebrew's anonymous aggregate user behaviour analytics. Read more at
<https://docs.brew.sh/Analytics>.
If `state` is passed, display the current anonymous user behaviour analytics `brew analytics` [`state`]:
state. Read more at <https://docs.brew.sh/Analytics>. Display the current state of Homebrew's analytics.
If `regenerate-uuid` is passed, regenerate the UUID used in Homebrew's `brew analytics` [`on`|`off`]:
analytics. Turn Homebrew's analytics on or off respectively.
`brew analytics regenerate-uuid`:
Regenerate the UUID used for Homebrew's analytics.
### `cleanup` [*`options`*] [*`formula`*|*`cask`*] ### `cleanup` [*`options`*] [*`formula`*|*`cask`*]
@ -437,7 +441,7 @@ Consider adding evaluation of this command's output to your dotfiles (e.g. `~/.p
Symlink all of the specified *`version`* of *`formula`*'s installation into Symlink all of the specified *`version`* of *`formula`*'s installation into
Homebrew's prefix. Homebrew's prefix.
### `tap` [*`options`*] *`user`*`/`*`repo`* [*`URL`*] ### `tap` [*`options`*] [*`user`*`/`*`repo`*] [*`URL`*]
Tap a formula repository. Tap a formula repository.
@ -588,7 +592,7 @@ If *`formula`* is provided, display the file or directory used to cache *`formul
Display Homebrew's Cellar path. *Default:* `$(brew --prefix)/Cellar`, or if that Display Homebrew's Cellar path. *Default:* `$(brew --prefix)/Cellar`, or if that
directory doesn't exist, `$(brew --repository)/Cellar`. directory doesn't exist, `$(brew --repository)/Cellar`.
If *`formula`* is provided, display the location in the cellar where *`formula`* If *`formula`* is provided, display the location in the Cellar where *`formula`*
would be installed, without any sort of versioned directory as the last path. would be installed, without any sort of versioned directory as the last path.
### `--env` [*`options`*] [*`formula`*] ### `--env` [*`options`*] [*`formula`*]
@ -608,7 +612,7 @@ list is formatted for export to `bash`(1) unless `--plain` is passed.
Display Homebrew's install path. *Default:* `/usr/local` on macOS and Display Homebrew's install path. *Default:* `/usr/local` on macOS and
`/home/linuxbrew/.linuxbrew` on Linux. `/home/linuxbrew/.linuxbrew` on Linux.
If *`formula`* is provided, display the location in the cellar where *`formula`* is If *`formula`* is provided, display the location in the Cellar where *`formula`* is
or would be installed. or would be installed.
### `--repository`, `--repo` [*`user`*`/`*`repo`*] ### `--repository`, `--repo` [*`user`*`/`*`repo`*]
@ -848,14 +852,14 @@ Generate Homebrew's manpages.
### `pr-automerge` [*`options`*] ### `pr-automerge` [*`options`*]
Finds pull requests that can be automatically merged using `brew pr-publish`. Find pull requests that can be automatically merged using `brew pr-publish`.
* `--tap`: * `--tap`:
Target repository tap (default: `homebrew/core`) Target tap repository (default: `homebrew/core`).
* `--with-label`: * `--with-label`:
Pull requests must have this label (default: `ready to merge`) Pull requests must have this label (default: `ready to merge`).
* `--without-labels`: * `--without-labels`:
Pull requests must not have these labels (default: `do not merge`, `new formula`) Pull requests must not have these labels (default: `do not merge`, `new formula`).
* `--publish`: * `--publish`:
Run `brew pr-publish` on matching pull requests. Run `brew pr-publish` on matching pull requests.
* `--ignore-failures`: * `--ignore-failures`:
@ -863,17 +867,17 @@ Finds pull requests that can be automatically merged using `brew pr-publish`.
### `pr-publish` [*`options`*] *`pull_request`* [*`pull_request`* ...] ### `pr-publish` [*`options`*] *`pull_request`* [*`pull_request`* ...]
Publishes bottles for a pull request with GitHub Actions. Requires write access Publish bottles for a pull request with GitHub Actions. Requires write access to
to the repository. the `homebrew/core` repository.
### `pr-pull` [*`options`*] *`pull_request`* [*`pull_request`* ...] ### `pr-pull` [*`options`*] *`pull_request`* [*`pull_request`* ...]
Download and publish bottles, and apply the bottle commit from a pull request Download and publish bottles, and apply the bottle commit from a pull request
with artifacts generated from GitHub Actions. Requires write access to the with artifacts generated by GitHub Actions. Requires write access to the
repository. repository.
* `--no-publish`: * `--no-publish`:
Download the bottles, apply the bottle commit, and upload the bottles to Bintray, but don't publish them. Download the bottles, apply the bottle commit and upload the bottles to Bintray, but don't publish them.
* `--no-upload`: * `--no-upload`:
Download the bottles and apply the bottle commit, but don't upload to Bintray. Download the bottles and apply the bottle commit, but don't upload to Bintray.
* `-n`, `--dry-run`: * `-n`, `--dry-run`:
@ -891,7 +895,7 @@ repository.
* `--bintray-org`: * `--bintray-org`:
Upload to the specified Bintray organisation (default: homebrew). Upload to the specified Bintray organisation (default: homebrew).
* `--tap`: * `--tap`:
Target repository tap (default: homebrew/core). Target tap repository (default: homebrew/core).
### `prof` *`command`* ### `prof` *`command`*
@ -902,8 +906,8 @@ Run Homebrew with the Ruby profiler, e.g. `brew prof readall`.
Get a patch from a GitHub commit or pull request and apply it to Homebrew. Get a patch from a GitHub commit or pull request and apply it to Homebrew.
Optionally, publish updated bottles for any formulae changed by the patch. Optionally, publish updated bottles for any formulae changed by the patch.
Each *`patch`* may be the number of a pull request in `homebrew/core`, the URL of Each *`patch`* may be the number of a pull request in `homebrew/core` or the URL
any pull request or commit on GitHub. of any pull request or commit on GitHub.
* `--bump`: * `--bump`:
For one-formula PRs, automatically reword commit message to our preferred format. For one-formula PRs, automatically reword commit message to our preferred format.
@ -1049,52 +1053,46 @@ These options are applicable across multiple subcommands.
## OFFICIAL EXTERNAL COMMANDS ## OFFICIAL EXTERNAL COMMANDS
### `cask` *`subcommand`*: ### `cask` *`subcommand`*
Install macOS applications distributed as binaries. See `brew-cask`(1). Install macOS applications distributed as binaries. See `brew-cask`(1).
**Homebrew/homebrew-cask**: <https://github.com/Homebrew/homebrew-cask> **Homebrew/homebrew-cask**: <https://github.com/Homebrew/homebrew-cask>
### `bundle` *`subcommand`* ### `bundle` [*`subcommand`*]
Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store
and Whalebrew. and Whalebrew.
`brew bundle` [`install`] `brew bundle` [`install`]:
Install or upgrade all dependencies in a `Brewfile`.
Install or upgrade all dependencies in a `Brewfile`. `brew bundle dump`:
Write all installed casks/formulae/images/taps into a `Brewfile`.
`brew bundle dump` `brew bundle cleanup`:
Uninstall all dependencies not listed in a `Brewfile`.
Write all installed casks/formulae/images/taps into a `Brewfile`. `brew bundle check`:
Check if all dependencies are installed in a `Brewfile`.
`brew bundle cleanup` `brew bundle exec` *`command`*:
Run an external command in an isolated build environment.
Uninstall all dependencies not listed in a `Brewfile`. `brew bundle list`:
List all dependencies present in a `Brewfile`. By default, only Homebrew
`brew bundle check`
Check if all dependencies are installed in a `Brewfile`.
`brew bundle exec` *`command`*
Run an external command in an isolated build environment.
`brew bundle list`
List all dependencies present in a Brewfile. By default, only Homebrew
dependencies are listed. dependencies are listed.
* `--file`: * `--file`:
Read the `Brewfile` from this file. Use `--file=-` to pipe to stdin/stdout. Read the `Brewfile` from this location. Use `--file=-` to pipe to stdin/stdout.
* `--global`: * `--global`:
Read the `Brewfile` from `~/.Brewfile`. Read the `Brewfile` from `~/.Brewfile`.
* `-v`, `--verbose`: * `-v`, `--verbose`:
`install` output is printed from commands as they are run. `check` prints all missing dependencies. `install` prints output from commands as they are run. `check` lists all missing dependencies.
* `--no-upgrade`: * `--no-upgrade`:
`install` won't run `brew upgrade` on outdated dependencies. Note they may still be upgraded by `brew install` if needed. `install` won't run `brew upgrade` on outdated dependencies. Note they may still be upgraded by `brew install` if needed.
* `-f`, `--force`: * `-f`, `--force`:
`dump` overwrites an existing `Brewfile`. `cleanup` actually perform the cleanup operations. `dump` overwrites an existing `Brewfile`. `cleanup` actually performs its cleanup operations.
* `--no-lock`: * `--no-lock`:
`install` won't output a `Brewfile.lock.json`. `install` won't output a `Brewfile.lock.json`.
* `--all`: * `--all`:
@ -1110,38 +1108,38 @@ dependencies are listed.
* `--whalebrew`: * `--whalebrew`:
`list` Whalebrew dependencies. `list` Whalebrew dependencies.
* `--describe`: * `--describe`:
`dump` a description comment above each line, unless the dependency does not have a description. `dump` adds a description comment above each line, unless the dependency does not have a description.
* `--no-restart`: * `--no-restart`:
`dump` does not add `restart_service` to formula lines. `dump` does not add `restart_service` to formula lines.
* `--zap`: * `--zap`:
`cleanup` casks using the `zap` command instead of `uninstall`. `cleanup` casks using the `zap` command instead of `uninstall`.
### `services` *`subcommand`* ### `services` [*`subcommand`*]
Manage background services with macOS' `launchctl`(1) daemon manager. Manage background services with macOS' `launchctl`(1) daemon manager.
If `sudo` is passed, operate on `/Library/LaunchDaemons` (started at boot). If `sudo` is passed, operate on `/Library/LaunchDaemons` (started at boot).
Otherwise, operate on `~/Library/LaunchAgents` (started at login). Otherwise, operate on `~/Library/LaunchAgents` (started at login).
[`sudo`] `brew services` [`list`] [`sudo`] `brew services` [`list`]:
List all running services for the current user (or root). List all running services for the current user (or root).
[`sudo`] `brew services run` (*`formula`*|`--all`) [`sudo`] `brew services run` (*`formula`*|`--all`):
Run the service *`formula`* without registering to launch at login (or boot). Run the service *`formula`* without registering to launch at login (or boot).
[`sudo`] `brew services start` (*`formula`*|`--all`) [`sudo`] `brew services start` (*`formula`*|`--all`):
Start the service *`formula`* immediately and register it to launch at login (or Start the service *`formula`* immediately and register it to launch at login
boot). (or boot).
[`sudo`] `brew services stop` (*`formula`*|`--all`) [`sudo`] `brew services stop` (*`formula`*|`--all`):
Stop the service *`formula`* immediately and unregister it from launching at Stop the service *`formula`* immediately and unregister it from launching at
login (or boot). login (or boot).
[`sudo`] `brew services restart` (*`formula`*|`--all`) [`sudo`] `brew services restart` (*`formula`*|`--all`):
Stop (if necessary) and start the service *`formula`* immediately and register Stop (if necessary) and start the service *`formula`* immediately and register
it to launch at login (or boot). it to launch at login (or boot).
[`sudo`] `brew services cleanup` [`sudo`] `brew services cleanup`:
Remove all unused services. Remove all unused services.
* `--all`: * `--all`:

92
manpages/brew.1
View File

@ -39,13 +39,19 @@ Perform a substring search of cask tokens and formula names for \fItext\fR\. If
.SH "COMMANDS" .SH "COMMANDS"
. .
.SS "\fBanalytics\fR [\fIsubcommand\fR]" .SS "\fBanalytics\fR [\fIsubcommand\fR]"
If \fBon\fR or \fBoff\fR is passed, turn Homebrew\'s analytics on or off respectively\. Control Homebrew\'s anonymous aggregate user behaviour analytics\. Read more at \fIhttps://docs\.brew\.sh/Analytics\fR\.
. .
.P .P
If \fBstate\fR is passed, display the current anonymous user behaviour analytics state\. Read more at \fIhttps://docs\.brew\.sh/Analytics\fR\. \fBbrew analytics\fR [\fBstate\fR]
Display the current state of Homebrew\'s analytics\.
. .
.P .P
If \fBregenerate\-uuid\fR is passed, regenerate the UUID used in Homebrew\'s analytics\. \fBbrew analytics\fR [\fBon\fR|\fBoff\fR]
Turn Homebrew\'s analytics on or off respectively\.
.
.P
\fBbrew analytics regenerate\-uuid\fR
Regenerate the UUID used for Homebrew\'s analytics\.
. .
.SS "\fBcleanup\fR [\fIoptions\fR] [\fIformula\fR|\fIcask\fR]" .SS "\fBcleanup\fR [\fIoptions\fR] [\fIformula\fR|\fIcask\fR]"
Remove stale lock files and outdated downloads for all formulae and casks, and remove old versions of installed formulae\. If arguments are specified, only do this for the given formulae and casks\. Remove stale lock files and outdated downloads for all formulae and casks, and remove old versions of installed formulae\. If arguments are specified, only do this for the given formulae and casks\.
@ -575,7 +581,7 @@ The variables \fBHOMEBREW_PREFIX\fR, \fBHOMEBREW_CELLAR\fR and \fBHOMEBREW_REPOS
.SS "\fBswitch\fR \fIformula\fR \fIversion\fR" .SS "\fBswitch\fR \fIformula\fR \fIversion\fR"
Symlink all of the specified \fIversion\fR of \fIformula\fR\'s installation into Homebrew\'s prefix\. Symlink all of the specified \fIversion\fR of \fIformula\fR\'s installation into Homebrew\'s prefix\.
. .
.SS "\fBtap\fR [\fIoptions\fR] \fIuser\fR\fB/\fR\fIrepo\fR [\fIURL\fR]" .SS "\fBtap\fR [\fIoptions\fR] [\fIuser\fR\fB/\fR\fIrepo\fR] [\fIURL\fR]"
Tap a formula repository\. Tap a formula repository\.
. .
.P .P
@ -761,7 +767,7 @@ Show the cache file used when pouring a bottle\.
Display Homebrew\'s Cellar path\. \fIDefault:\fR \fB$(brew \-\-prefix)/Cellar\fR, or if that directory doesn\'t exist, \fB$(brew \-\-repository)/Cellar\fR\. Display Homebrew\'s Cellar path\. \fIDefault:\fR \fB$(brew \-\-prefix)/Cellar\fR, or if that directory doesn\'t exist, \fB$(brew \-\-repository)/Cellar\fR\.
. .
.P .P
If \fIformula\fR is provided, display the location in the cellar where \fIformula\fR would be installed, without any sort of versioned directory as the last path\. If \fIformula\fR is provided, display the location in the Cellar where \fIformula\fR would be installed, without any sort of versioned directory as the last path\.
. .
.SS "\fB\-\-env\fR [\fIoptions\fR] [\fIformula\fR]" .SS "\fB\-\-env\fR [\fIoptions\fR] [\fIformula\fR]"
Summarise Homebrew\'s build environment as a plain list\. Summarise Homebrew\'s build environment as a plain list\.
@ -781,7 +787,7 @@ Generate plain output even when piped\.
Display Homebrew\'s install path\. \fIDefault:\fR \fB/usr/local\fR on macOS and \fB/home/linuxbrew/\.linuxbrew\fR on Linux\. Display Homebrew\'s install path\. \fIDefault:\fR \fB/usr/local\fR on macOS and \fB/home/linuxbrew/\.linuxbrew\fR on Linux\.
. .
.P .P
If \fIformula\fR is provided, display the location in the cellar where \fIformula\fR is or would be installed\. If \fIformula\fR is provided, display the location in the Cellar where \fIformula\fR is or would be installed\.
. .
.SS "\fB\-\-repository\fR, \fB\-\-repo\fR [\fIuser\fR\fB/\fR\fIrepo\fR]" .SS "\fB\-\-repository\fR, \fB\-\-repo\fR [\fIuser\fR\fB/\fR\fIrepo\fR]"
Display where Homebrew\'s \fB\.git\fR directory is located\. Display where Homebrew\'s \fB\.git\fR directory is located\.
@ -1089,19 +1095,19 @@ Return a failing status code if changes are detected in the manpage outputs\. Th
This is now done automatically by \fBbrew update\fR\. This is now done automatically by \fBbrew update\fR\.
. .
.SS "\fBpr\-automerge\fR [\fIoptions\fR]" .SS "\fBpr\-automerge\fR [\fIoptions\fR]"
Finds pull requests that can be automatically merged using \fBbrew pr\-publish\fR\. Find pull requests that can be automatically merged using \fBbrew pr\-publish\fR\.
. .
.TP .TP
\fB\-\-tap\fR \fB\-\-tap\fR
Target repository tap (default: \fBhomebrew/core\fR) Target tap repository (default: \fBhomebrew/core\fR)\.
. .
.TP .TP
\fB\-\-with\-label\fR \fB\-\-with\-label\fR
Pull requests must have this label (default: \fBready to merge\fR) Pull requests must have this label (default: \fBready to merge\fR)\.
. .
.TP .TP
\fB\-\-without\-labels\fR \fB\-\-without\-labels\fR
Pull requests must not have these labels (default: \fBdo not merge\fR, \fBnew formula\fR) Pull requests must not have these labels (default: \fBdo not merge\fR, \fBnew formula\fR)\.
. .
.TP .TP
\fB\-\-publish\fR \fB\-\-publish\fR
@ -1112,14 +1118,14 @@ Run \fBbrew pr\-publish\fR on matching pull requests\.
Include pull requests that have failing status checks\. Include pull requests that have failing status checks\.
. .
.SS "\fBpr\-publish\fR [\fIoptions\fR] \fIpull_request\fR [\fIpull_request\fR \.\.\.]" .SS "\fBpr\-publish\fR [\fIoptions\fR] \fIpull_request\fR [\fIpull_request\fR \.\.\.]"
Publishes bottles for a pull request with GitHub Actions\. Requires write access to the repository\. Publish bottles for a pull request with GitHub Actions\. Requires write access to the \fBhomebrew/core\fR repository\.
. .
.SS "\fBpr\-pull\fR [\fIoptions\fR] \fIpull_request\fR [\fIpull_request\fR \.\.\.]" .SS "\fBpr\-pull\fR [\fIoptions\fR] \fIpull_request\fR [\fIpull_request\fR \.\.\.]"
Download and publish bottles, and apply the bottle commit from a pull request with artifacts generated from GitHub Actions\. Requires write access to the repository\. Download and publish bottles, and apply the bottle commit from a pull request with artifacts generated by GitHub Actions\. Requires write access to the repository\.
. .
.TP .TP
\fB\-\-no\-publish\fR \fB\-\-no\-publish\fR
Download the bottles, apply the bottle commit, and upload the bottles to Bintray, but don\'t publish them\. Download the bottles, apply the bottle commit and upload the bottles to Bintray, but don\'t publish them\.
. .
.TP .TP
\fB\-\-no\-upload\fR \fB\-\-no\-upload\fR
@ -1155,7 +1161,7 @@ Upload to the specified Bintray organisation (default: homebrew)\.
. .
.TP .TP
\fB\-\-tap\fR \fB\-\-tap\fR
Target repository tap (default: homebrew/core)\. Target tap repository (default: homebrew/core)\.
. .
.SS "\fBprof\fR \fIcommand\fR" .SS "\fBprof\fR \fIcommand\fR"
Run Homebrew with the Ruby profiler, e\.g\. \fBbrew prof readall\fR\. Run Homebrew with the Ruby profiler, e\.g\. \fBbrew prof readall\fR\.
@ -1164,7 +1170,7 @@ Run Homebrew with the Ruby profiler, e\.g\. \fBbrew prof readall\fR\.
Get a patch from a GitHub commit or pull request and apply it to Homebrew\. Optionally, publish updated bottles for any formulae changed by the patch\. Get a patch from a GitHub commit or pull request and apply it to Homebrew\. Optionally, publish updated bottles for any formulae changed by the patch\.
. .
.P .P
Each \fIpatch\fR may be the number of a pull request in \fBhomebrew/core\fR, the URL of any pull request or commit on GitHub\. Each \fIpatch\fR may be the number of a pull request in \fBhomebrew/core\fR or the URL of any pull request or commit on GitHub\.
. .
.TP .TP
\fB\-\-bump\fR \fB\-\-bump\fR
@ -1343,55 +1349,43 @@ Override warnings and enable potentially unsafe operations\.
. .
.SH "OFFICIAL EXTERNAL COMMANDS" .SH "OFFICIAL EXTERNAL COMMANDS"
. .
.SS "\fBcask\fR \fIsubcommand\fR:" .SS "\fBcask\fR \fIsubcommand\fR"
Install macOS applications distributed as binaries\. See \fBbrew\-cask\fR(1)\. Install macOS applications distributed as binaries\. See \fBbrew\-cask\fR(1)\.
. .
.P .P
\fBHomebrew/homebrew\-cask\fR \fBHomebrew/homebrew\-cask\fR
\fIhttps://github\.com/Homebrew/homebrew\-cask\fR \fIhttps://github\.com/Homebrew/homebrew\-cask\fR
. .
.SS "\fBbundle\fR \fIsubcommand\fR" .SS "\fBbundle\fR [\fIsubcommand\fR]"
Bundler for non\-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store and Whalebrew\. Bundler for non\-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store and Whalebrew\.
. .
.P .P
\fBbrew bundle\fR [\fBinstall\fR] \fBbrew bundle\fR [\fBinstall\fR]
. Install or upgrade all dependencies in a \fBBrewfile\fR\.
.P
Install or upgrade all dependencies in a \fBBrewfile\fR\.
. .
.P .P
\fBbrew bundle dump\fR \fBbrew bundle dump\fR
. Write all installed casks/formulae/images/taps into a \fBBrewfile\fR\.
.P
Write all installed casks/formulae/images/taps into a \fBBrewfile\fR\.
. .
.P .P
\fBbrew bundle cleanup\fR \fBbrew bundle cleanup\fR
. Uninstall all dependencies not listed in a \fBBrewfile\fR\.
.P
Uninstall all dependencies not listed in a \fBBrewfile\fR\.
. .
.P .P
\fBbrew bundle check\fR \fBbrew bundle check\fR
. Check if all dependencies are installed in a \fBBrewfile\fR\.
.P
Check if all dependencies are installed in a \fBBrewfile\fR\.
. .
.P .P
\fBbrew bundle exec\fR \fIcommand\fR \fBbrew bundle exec\fR \fIcommand\fR
. Run an external command in an isolated build environment\.
.P
Run an external command in an isolated build environment\.
. .
.P .P
\fBbrew bundle list\fR \fBbrew bundle list\fR
. List all dependencies present in a \fBBrewfile\fR\. By default, only Homebrew dependencies are listed\.
.P
List all dependencies present in a Brewfile\. By default, only Homebrew dependencies are listed\.
. .
.TP .TP
\fB\-\-file\fR \fB\-\-file\fR
Read the \fBBrewfile\fR from this file\. Use \fB\-\-file=\-\fR to pipe to stdin/stdout\. Read the \fBBrewfile\fR from this location\. Use \fB\-\-file=\-\fR to pipe to stdin/stdout\.
. .
.TP .TP
\fB\-\-global\fR \fB\-\-global\fR
@ -1399,7 +1393,7 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
. .
.TP .TP
\fB\-v\fR, \fB\-\-verbose\fR \fB\-v\fR, \fB\-\-verbose\fR
\fBinstall\fR output is printed from commands as they are run\. \fBcheck\fR prints all missing dependencies\. \fBinstall\fR prints output from commands as they are run\. \fBcheck\fR lists all missing dependencies\.
. .
.TP .TP
\fB\-\-no\-upgrade\fR \fB\-\-no\-upgrade\fR
@ -1407,7 +1401,7 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
. .
.TP .TP
\fB\-f\fR, \fB\-\-force\fR \fB\-f\fR, \fB\-\-force\fR
\fBdump\fR overwrites an existing \fBBrewfile\fR\. \fBcleanup\fR actually perform the cleanup operations\. \fBdump\fR overwrites an existing \fBBrewfile\fR\. \fBcleanup\fR actually performs its cleanup operations\.
. .
.TP .TP
\fB\-\-no\-lock\fR \fB\-\-no\-lock\fR
@ -1439,7 +1433,7 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
. .
.TP .TP
\fB\-\-describe\fR \fB\-\-describe\fR
\fBdump\fR a description comment above each line, unless the dependency does not have a description\. \fBdump\fR adds a description comment above each line, unless the dependency does not have a description\.
. .
.TP .TP
\fB\-\-no\-restart\fR \fB\-\-no\-restart\fR
@ -1449,29 +1443,35 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
\fB\-\-zap\fR \fB\-\-zap\fR
\fBcleanup\fR casks using the \fBzap\fR command instead of \fBuninstall\fR\. \fBcleanup\fR casks using the \fBzap\fR command instead of \fBuninstall\fR\.
. .
.SS "\fBservices\fR \fIsubcommand\fR" .SS "\fBservices\fR [\fIsubcommand\fR]"
Manage background services with macOS\' \fBlaunchctl\fR(1) daemon manager\. Manage background services with macOS\' \fBlaunchctl\fR(1) daemon manager\.
. .
.P .P
If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boot)\. Otherwise, operate on \fB~/Library/LaunchAgents\fR (started at login)\. If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boot)\. Otherwise, operate on \fB~/Library/LaunchAgents\fR (started at login)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services\fR [\fBlist\fR] List all running services for the current user (or root)\. [\fBsudo\fR] \fBbrew services\fR [\fBlist\fR]
List all running services for the current user (or root)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services run\fR (\fIformula\fR|\fB\-\-all\fR) Run the service \fIformula\fR without registering to launch at login (or boot)\. [\fBsudo\fR] \fBbrew services run\fR (\fIformula\fR|\fB\-\-all\fR)
Run the service \fIformula\fR without registering to launch at login (or boot)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services start\fR (\fIformula\fR|\fB\-\-all\fR) Start the service \fIformula\fR immediately and register it to launch at login (or boot)\. [\fBsudo\fR] \fBbrew services start\fR (\fIformula\fR|\fB\-\-all\fR)
Start the service \fIformula\fR immediately and register it to launch at login (or boot)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services stop\fR (\fIformula\fR|\fB\-\-all\fR) Stop the service \fIformula\fR immediately and unregister it from launching at login (or boot)\. [\fBsudo\fR] \fBbrew services stop\fR (\fIformula\fR|\fB\-\-all\fR)
Stop the service \fIformula\fR immediately and unregister it from launching at login (or boot)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services restart\fR (\fIformula\fR|\fB\-\-all\fR) Stop (if necessary) and start the service \fIformula\fR immediately and register it to launch at login (or boot)\. [\fBsudo\fR] \fBbrew services restart\fR (\fIformula\fR|\fB\-\-all\fR)
Stop (if necessary) and start the service \fIformula\fR immediately and register it to launch at login (or boot)\.
. .
.P .P
[\fBsudo\fR] \fBbrew services cleanup\fR Remove all unused services\. [\fBsudo\fR] \fBbrew services cleanup\fR
Remove all unused services\.
. .
.TP .TP
\fB\-\-all\fR \fB\-\-all\fR