From f47afa31f225e651803de13fea95f375ee9576e7 Mon Sep 17 00:00:00 2001
From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com>
Date: Fri, 29 Sep 2023 00:05:40 +0000
Subject: [PATCH] Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
---
docs/Manpage.md | 18 +++++++++++-------
manpages/brew.1 | 18 +++++++++++-------
2 files changed, 22 insertions(+), 14 deletions(-)
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 08de85affe538..97f63b5fc73e8 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -1848,7 +1848,7 @@ This sanitized build environment ignores unrequested dependencies, which makes s
* `--file`:
Read the `Brewfile` from this location. Use `--file=-` to pipe to stdin/stdout.
* `--global`:
- Read the `Brewfile` from `~/.Brewfile`.
+ Read the `Brewfile` from `~/.Brewfile` or the `HOMEBREW_BUNDLE_FILE_GLOBAL` environment variable, if set.
* `-v`, `--verbose`:
`install` prints output from commands as they are run. `check` lists all missing dependencies.
* `--no-upgrade`:
@@ -1856,7 +1856,7 @@ This sanitized build environment ignores unrequested dependencies, which makes s
* `-f`, `--force`:
`dump` overwrites an existing `Brewfile`. `cleanup` actually performs its cleanup operations.
* `--cleanup`:
- `install` performs cleanup operation, same as running `cleanup --force`.
+ `install` performs cleanup operation, same as running `cleanup --force`. This is enabled by default if HOMEBREW_BUNDLE_INSTALL_CLEANUP is set.
* `--no-lock`:
`install` won't output a `Brewfile.lock.json`.
* `--all`:
@@ -1874,7 +1874,7 @@ This sanitized build environment ignores unrequested dependencies, which makes s
* `--vscode`:
`list` VSCode extensions.
* `--describe`:
- `dump` adds 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. This is enabled by default if HOMEBREW_BUNDLE_DUMP_DESCRIBE is set.
* `--no-restart`:
`dump` does not add `restart_service` to formula lines.
* `--zap`:
@@ -1887,13 +1887,15 @@ If the output is not to a tty, print the appropriate handler script for your she
### `services` [*`subcommand`*]
-Manage background services with macOS' `launchctl`(1) daemon manager.
+Manage background services with macOS' `launchctl`(1) daemon manager or
+Linux's `systemctl`(1) service manager.
-If `sudo` is passed, operate on `/Library/LaunchDaemons` (started at boot).
-Otherwise, operate on `~/Library/LaunchAgents` (started at login).
+If `sudo` is passed, operate on `/Library/LaunchDaemons`/`/usr/lib/systemd/system` (started at boot).
+Otherwise, operate on `~/Library/LaunchAgents`/`~/.config/systemd/user` (started at login).
-[`sudo`] `brew services` [`list`] (`--json`)
+[`sudo`] `brew services` [`list`] (`--json`) (`--debug`)
List information about all managed services for the current user (or root).
+Provides more output from Homebrew and `launchctl`(1) or `systemctl`(1) if run with `--debug`.
[`sudo`] `brew services info` (*`formula`*|`--all`|`--json`)
List all managed services for the current user (or root).
@@ -1918,6 +1920,8 @@ Otherwise, operate on `~/Library/LaunchAgents` (started at login).
* `--file`:
Use the service file from this location to `start` the service.
+* `--sudo-service-user`:
+ When run as root on macOS, run the service(s) as this user.
* `--all`:
Run *`subcommand`* on all services.
* `--json`:
diff --git a/manpages/brew.1 b/manpages/brew.1
index 6f5f0efe2c52f..712d730cafaab 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -2622,7 +2622,7 @@ Read the \fBBrewfile\fR from this location\. Use \fB\-\-file=\-\fR to pipe to st
.
.TP
\fB\-\-global\fR
-Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
+Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR or the \fBHOMEBREW_BUNDLE_FILE_GLOBAL\fR environment variable, if set\.
.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
@@ -2638,7 +2638,7 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
.
.TP
\fB\-\-cleanup\fR
-\fBinstall\fR performs cleanup operation, same as running \fBcleanup \-\-force\fR\.
+\fBinstall\fR performs cleanup operation, same as running \fBcleanup \-\-force\fR\. This is enabled by default if HOMEBREW_BUNDLE_INSTALL_CLEANUP is set\.
.
.TP
\fB\-\-no\-lock\fR
@@ -2674,7 +2674,7 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
.
.TP
\fB\-\-describe\fR
-\fBdump\fR adds 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\. This is enabled by default if HOMEBREW_BUNDLE_DUMP_DESCRIBE is set\.
.
.TP
\fB\-\-no\-restart\fR
@@ -2688,14 +2688,14 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
Print instructions for setting up the command\-not\-found hook for your shell\. If the output is not to a tty, print the appropriate handler script for your shell\.
.
.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 or Linux\'s \fBsystemctl\fR(1) service manager\.
.
.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/\fB/usr/lib/systemd/system\fR (started at boot)\. Otherwise, operate on \fB~/Library/LaunchAgents\fR/\fB~/\.config/systemd/user\fR (started at login)\.
.
.P
-[\fBsudo\fR] \fBbrew services\fR [\fBlist\fR] (\fB\-\-json\fR)
- List information about all managed services for the current user (or root)\.
+[\fBsudo\fR] \fBbrew services\fR [\fBlist\fR] (\fB\-\-json\fR) (\fB\-\-debug\fR)
+ List information about all managed services for the current user (or root)\. Provides more output from Homebrew and \fBlaunchctl\fR(1) or \fBsystemctl\fR(1) if run with \fB\-\-debug\fR\.
.
.P
[\fBsudo\fR] \fBbrew services info\fR (\fIformula\fR|\fB\-\-all\fR|\fB\-\-json\fR)
@@ -2730,6 +2730,10 @@ If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boo
Use the service file from this location to \fBstart\fR the service\.
.
.TP
+\fB\-\-sudo\-service\-user\fR
+When run as root on macOS, run the service(s) as this user\.
+.
+.TP
\fB\-\-all\fR
Run \fIsubcommand\fR on all services\.
.