diff --git a/completions/bash/brew b/completions/bash/brew index 4d42ad8e0e..c607d1ddac 100644 --- a/completions/bash/brew +++ b/completions/bash/brew @@ -664,6 +664,7 @@ _brew_bundle() { --no-upgrade --no-vscode --quiet + --services --tap --upgrade --verbose @@ -2334,6 +2335,7 @@ _brew_services() { --file --help --json + --keep --max-wait --no-wait --quiet diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish index c9d896ac9e..b1b661635c 100644 --- a/completions/fish/brew.fish +++ b/completions/fish/brew.fish @@ -519,6 +519,7 @@ __fish_brew_complete_arg 'bundle' -l no-restart -d '`dump` does not add `restart __fish_brew_complete_arg 'bundle' -l no-upgrade -d '`install` does not run `brew upgrade` on outdated dependencies. `check` does not check for outdated dependencies. Note they may still be upgraded by `brew install` if needed. This is enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set' __fish_brew_complete_arg 'bundle' -l no-vscode -d '`dump` without VSCode (and forks/variants) extensions. This is enabled by default if `$HOMEBREW_BUNDLE_DUMP_NO_VSCODE` is set' __fish_brew_complete_arg 'bundle' -l quiet -d 'Make some output more quiet' +__fish_brew_complete_arg 'bundle' -l services -d 'Temporarily start services while running the `exec` or `sh` command' __fish_brew_complete_arg 'bundle' -l tap -d '`list` or `dump` Homebrew tap dependencies' __fish_brew_complete_arg 'bundle' -l upgrade -d '`install` runs `brew upgrade` on outdated dependencies, even if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set. ' __fish_brew_complete_arg 'bundle' -l verbose -d '`install` prints output from commands as they are run. `check` lists all missing dependencies' @@ -1542,6 +1543,7 @@ __fish_brew_complete_arg 'services' -l debug -d 'Display any debugging informati __fish_brew_complete_arg 'services' -l file -d 'Use the service file from this location to `start` the service' __fish_brew_complete_arg 'services' -l help -d 'Show this message' __fish_brew_complete_arg 'services' -l json -d 'Output as JSON' +__fish_brew_complete_arg 'services' -l keep -d 'When stopped, don\'t unregister the service from launching at login (or boot)' __fish_brew_complete_arg 'services' -l max-wait -d 'Wait at most this many seconds for `stop` to finish stopping a service. Omit this flag or set this to zero (0) seconds to wait indefinitely' __fish_brew_complete_arg 'services' -l no-wait -d 'Don\'t wait for `stop` to finish stopping the service' __fish_brew_complete_arg 'services' -l quiet -d 'Make some output more quiet' diff --git a/completions/zsh/_brew b/completions/zsh/_brew index 2b842ed92d..f103fd0f72 100644 --- a/completions/zsh/_brew +++ b/completions/zsh/_brew @@ -662,6 +662,7 @@ _brew_bundle() { '--no-upgrade[`install` does not run `brew upgrade` on outdated dependencies. `check` does not check for outdated dependencies. Note they may still be upgraded by `brew install` if needed. This is enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set]' \ '(--all --vscode)--no-vscode[`dump` without VSCode (and forks/variants) extensions. This is enabled by default if `$HOMEBREW_BUNDLE_DUMP_NO_VSCODE` is set]' \ '--quiet[Make some output more quiet]' \ + '--services[Temporarily start services while running the `exec` or `sh` command]' \ '--tap[`list` or `dump` Homebrew tap dependencies]' \ '(--install)--upgrade[`install` runs `brew upgrade` on outdated dependencies, even if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set. ]' \ '--verbose[`install` prints output from commands as they are run. `check` lists all missing dependencies]' \ @@ -1896,6 +1897,7 @@ _brew_services() { '--file[Use the service file from this location to `start` the service]' \ '--help[Show this message]' \ '--json[Output as JSON]' \ + '--keep[When stopped, don'\''t unregister the service from launching at login (or boot)]' \ '(--no-wait)--max-wait[Wait at most this many seconds for `stop` to finish stopping a service. Omit this flag or set this to zero (0) seconds to wait indefinitely]' \ '(--max-wait)--no-wait[Don'\''t wait for `stop` to finish stopping the service]' \ '--quiet[Make some output more quiet]' \ diff --git a/docs/Manpage.md b/docs/Manpage.md index 7a875de2de..8ba357ed83 100644 --- a/docs/Manpage.md +++ b/docs/Manpage.md @@ -251,6 +251,10 @@ flags which will help with finding keg-only dependencies like `openssl`, : Run `install` before continuing to other operations e.g. `exec`. +`--services` + +: Temporarily start services while running the `exec` or `sh` command. + `-f`, `--force` : `install` runs with `--force`/`--overwrite`. `dump` overwrites an existing @@ -1391,17 +1395,17 @@ If `sudo` is passed, operate on `/Library/LaunchDaemons` or : Start the service *`formula`* immediately and register it to launch at login (or boot). -\[`sudo`\] `brew services stop` (*`formula`*\|`--all`) +\[`sudo`\] `brew services stop` (`--keep`) (`--no-wait`\|`--max-wait=`) (*`formula`*\|`--all`) : Stop the service *`formula`* immediately and unregister it from launching at - login (or boot). + login (or boot), unless `--keep` is specified. \[`sudo`\] `brew services kill` (*`formula`*\|`--all`) : Stop the service *`formula`* immediately but keep it registered to launch at login (or boot). -\[`sudo`\] `brew services restart` (*`formula`*\|`--all`) +\[`sudo`\] `brew services restart` (*`formula`*\|`--all`\|`--file=`) : Stop (if necessary) and start the service *`formula`* immediately and register it to launch at login (or boot). @@ -1435,6 +1439,10 @@ If `sudo` is passed, operate on `/Library/LaunchDaemons` or : Don't wait for `stop` to finish stopping the service. +`--keep` + +: When stopped, don't unregister the service from launching at login (or boot). + ### `setup-ruby` \[*`command`* ...\] Installs and configures Homebrew's Ruby. If `command` is passed, it will only diff --git a/manpages/brew.1 b/manpages/brew.1 index 5602db94a2..d9d58c2e06 100644 --- a/manpages/brew.1 +++ b/manpages/brew.1 @@ -153,6 +153,9 @@ Read from or write to the \fBBrewfile\fP from \fB$HOMEBREW_BUNDLE_FILE_GLOBAL\fP \fB\-\-install\fP Run \fBinstall\fP before continuing to other operations e\.g\. \fBexec\fP\&\. .TP +\fB\-\-services\fP +Temporarily start services while running the \fBexec\fP or \fBsh\fP command\. +.TP \fB\-f\fP, \fB\-\-force\fP \fBinstall\fP runs with \fB\-\-force\fP/\fB\-\-overwrite\fP\&\. \fBdump\fP overwrites an existing \fBBrewfile\fP\&\. \fBcleanup\fP actually performs its cleanup operations\. .TP @@ -874,13 +877,13 @@ Run the service \fIformula\fP without registering to launch at login (or boot)\. [\fBsudo\fP] \fBbrew services start\fP (\fIformula\fP|\fB\-\-all\fP|\fB\-\-file=\fP) Start the service \fIformula\fP immediately and register it to launch at login (or boot)\. .TP -[\fBsudo\fP] \fBbrew services stop\fP (\fIformula\fP|\fB\-\-all\fP) -Stop the service \fIformula\fP immediately and unregister it from launching at login (or boot)\. +[\fBsudo\fP] \fBbrew services stop\fP (\fB\-\-keep\fP) (\fB\-\-no\-wait\fP|\fB\-\-max\-wait=\fP) (\fIformula\fP|\fB\-\-all\fP) +Stop the service \fIformula\fP immediately and unregister it from launching at login (or boot), unless \fB\-\-keep\fP is specified\. .TP [\fBsudo\fP] \fBbrew services kill\fP (\fIformula\fP|\fB\-\-all\fP) Stop the service \fIformula\fP immediately but keep it registered to launch at login (or boot)\. .TP -[\fBsudo\fP] \fBbrew services restart\fP (\fIformula\fP|\fB\-\-all\fP) +[\fBsudo\fP] \fBbrew services restart\fP (\fIformula\fP|\fB\-\-all\fP|\fB\-\-file=\fP) Stop (if necessary) and start the service \fIformula\fP immediately and register it to launch at login (or boot)\. .TP [\fBsudo\fP] \fBbrew services cleanup\fP @@ -903,6 +906,9 @@ Output as JSON\. .TP \fB\-\-no\-wait\fP Don\[u2019]t wait for \fBstop\fP to finish stopping the service\. +.TP +\fB\-\-keep\fP +When stopped, don\[u2019]t unregister the service from launching at login (or boot)\. .SS "\fBsetup\-ruby\fP \fR[\fIcommand\fP \.\.\.]" Installs and configures Homebrew\[u2019]s Ruby\. If \fBcommand\fP is passed, it will only run Bundler if necessary for that command\. .SS "\fBshellenv\fP \fR[\fIshell\fP \.\.\.]"