Merge pull request #19640 from Homebrew/sponsors-maintainers-man-completions

Update manpage and completions.

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

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'

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]' \

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

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)
+[\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)\.
+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 \.\.\.]"