admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

Merge pull request #20361 from Homebrew/manpage-updates

Browse Source 
Manpage: source wording & formatting fixes
This commit is contained in:
Eric Knibbe 2025-08-02 11:47:31 +00:00 committed by GitHub
commit aecd2b3447
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
33 changed files with 211 additions and 192 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Library/Homebrew/cmd/--prefix.rb
View File

@ -52,6 +52,7 @@ module Homebrew
description: "List files in Homebrew's prefix not installed by Homebrew." description: "List files in Homebrew's prefix not installed by Homebrew."
switch "--installed", switch "--installed",
description: "Outputs nothing and returns a failing status code if <formula> is not installed." description: "Outputs nothing and returns a failing status code if <formula> is not installed."
conflicts "--unbrewed", "--installed" conflicts "--unbrewed", "--installed"
named_args :formula named_args :formula

8
Library/Homebrew/cmd/bundle.rb
View File

@ -51,15 +51,15 @@ module Homebrew
`brew bundle remove` <name> [...]: `brew bundle remove` <name> [...]:
Remove entries that match `name` from your `Brewfile`. Use `--formula`, `--cask`, `--tap`, `--mas`, `--whalebrew` or `--vscode` to remove only entries of the corresponding type. Passing `--formula` also removes matches against formula aliases and old formula names. Remove entries that match `name` from your `Brewfile`. Use `--formula`, `--cask`, `--tap`, `--mas`, `--whalebrew` or `--vscode` to remove only entries of the corresponding type. Passing `--formula` also removes matches against formula aliases and old formula names.
`brew bundle exec` [--check] <command>: `brew bundle exec` [`--check`] <command>:
Run an external command in an isolated build environment based on the `Brewfile` dependencies. Run an external command in an isolated build environment based on the `Brewfile` dependencies.
This sanitized build environment ignores unrequested dependencies, which makes sure that things you didn't specify in your `Brewfile` won't get picked up by commands like `bundle install`, `npm install`, etc. It will also add compiler flags which will help with finding keg-only dependencies like `openssl`, `icu4c`, etc. This sanitized build environment ignores unrequested dependencies, which makes sure that things you didn't specify in your `Brewfile` won't get picked up by commands like `bundle install`, `npm install`, etc. It will also add compiler flags which will help with finding keg-only dependencies like `openssl`, `icu4c`, etc.
`brew bundle sh` [--check]: `brew bundle sh` [`--check`]:
Run your shell in a `brew bundle exec` environment. Run your shell in a `brew bundle exec` environment.
`brew bundle env` [--check]: `brew bundle env` [`--check`]:
Print the environment variables that would be set in a `brew bundle exec` environment. Print the environment variables that would be set in a `brew bundle exec` environment.
EOS EOS
flag "--file=", flag "--file=",
@ -84,7 +84,7 @@ module Homebrew
description: "`install` runs `brew upgrade` on any of these comma-separated formulae, " \ description: "`install` runs `brew upgrade` on any of these comma-separated formulae, " \
"even if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set." "even if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set."
switch "--install", switch "--install",
description: "Run `install` before continuing to other operations e.g. `exec`." description: "Run `install` before continuing to other operations, e.g. `exec`."
switch "--services", switch "--services",
description: "Temporarily start services while running the `exec` or `sh` command.", description: "Temporarily start services while running the `exec` or `sh` command.",
env: :bundle_services env: :bundle_services

1
Library/Homebrew/cmd/help.rb
View File

@ -12,6 +12,7 @@ module Homebrew
Outputs the usage instructions for `brew` <command>. Outputs the usage instructions for `brew` <command>.
Equivalent to `brew --help` <command>. Equivalent to `brew --help` <command>.
EOS EOS
named_args [:command] named_args [:command]
end end

4
Library/Homebrew/cmd/install.rb
View File

@ -134,7 +134,9 @@ module Homebrew
end end
formula_options formula_options
[ [
[:switch, "--cask", "--casks", { description: "Treat all named arguments as casks." }], [:switch, "--cask", "--casks", {
description: "Treat all named arguments as casks.",
}],
[:switch, "--[no-]binaries", { [:switch, "--[no-]binaries", {
description: "Disable/enable linking of helper executables (default: enabled).", description: "Disable/enable linking of helper executables (default: enabled).",
env: :cask_opts_binaries, env: :cask_opts_binaries,

2
Library/Homebrew/cmd/list.rb
View File

@ -54,7 +54,7 @@ module Homebrew
description: "List formulae and/or casks in long format. " \ description: "List formulae and/or casks in long format. " \
"Has no effect when a formula or cask name is passed as an argument." "Has no effect when a formula or cask name is passed as an argument."
switch "-r", switch "-r",
description: "Reverse the order of the formulae and/or casks sort to list the oldest entries first. " \ description: "Reverse the order of formula and/or cask sorting to list the oldest entries first. " \
"Has no effect when a formula or cask name is passed as an argument." "Has no effect when a formula or cask name is passed as an argument."
switch "-t", switch "-t",
description: "Sort formulae and/or casks by time modified, listing most recently modified first. " \ description: "Sort formulae and/or casks by time modified, listing most recently modified first. " \

8
Library/Homebrew/cmd/reinstall.rb
View File

@ -44,7 +44,9 @@ module Homebrew
"Print download, install and net install sizes of bottles and dependencies.", "Print download, install and net install sizes of bottles and dependencies.",
env: :ask env: :ask
[ [
[:switch, "--formula", "--formulae", { description: "Treat all named arguments as formulae." }], [:switch, "--formula", "--formulae", {
description: "Treat all named arguments as formulae.",
}],
[:switch, "-s", "--build-from-source", { [:switch, "-s", "--build-from-source", {
description: "Compile <formula> from source even if a bottle is available.", description: "Compile <formula> from source even if a bottle is available.",
}], }],
@ -74,7 +76,9 @@ module Homebrew
end end
formula_options formula_options
[ [
[:switch, "--cask", "--casks", { description: "Treat all named arguments as casks." }], [:switch, "--cask", "--casks", {
description: "Treat all named arguments as casks.",
}],
[:switch, "--[no-]binaries", { [:switch, "--[no-]binaries", {
description: "Disable/enable linking of helper executables (default: enabled).", description: "Disable/enable linking of helper executables (default: enabled).",
env: :cask_opts_binaries, env: :cask_opts_binaries,

23
Library/Homebrew/cmd/services.rb
View File

@ -51,15 +51,24 @@ module Homebrew
[`sudo`] `brew services cleanup`: [`sudo`] `brew services cleanup`:
Remove all unused services. Remove all unused services.
EOS EOS
flag "--file=", description: "Use the service file from this location to `start` the service." flag "--file=",
flag "--sudo-service-user=", description: "When run as root on macOS, run the service(s) as this user." description: "Use the service file from this location to `start` the service."
flag "--max-wait=", description: "Wait at most this many seconds for `stop` to finish stopping a service. " \ flag "--sudo-service-user=",
description: "When run as root on macOS, run the service(s) as this user."
flag "--max-wait=",
description: "Wait at most this many seconds for `stop` to finish stopping a service. " \
"Defaults to 60. Set this to zero (0) seconds to wait indefinitely." "Defaults to 60. Set this to zero (0) seconds to wait indefinitely."
switch "--all", description: "Run <subcommand> on all services." switch "--all",
switch "--json", description: "Output as JSON." description: "Run <subcommand> on all services."
switch "--no-wait", description: "Don't wait for `stop` to finish stopping the service." switch "--json",
switch "--keep", description: "When stopped, don't unregister the service from launching at login (or boot)." description: "Output as JSON."
switch "--no-wait",
description: "Don't wait for `stop` to finish stopping the service."
switch "--keep",
description: "When stopped, don't unregister the service from launching at login (or boot)."
conflicts "--max-wait=", "--no-wait" conflicts "--max-wait=", "--no-wait"
named_args %w[list info run start stop kill restart cleanup] named_args %w[list info run start stop kill restart cleanup]
end end

1
Library/Homebrew/cmd/tab.rb
View File

@ -17,7 +17,6 @@ module Homebrew
To prevent removal, mark the formula as installed on request; To prevent removal, mark the formula as installed on request;
to allow removal, mark the formula as not installed on request. to allow removal, mark the formula as not installed on request.
EOS EOS
switch "--installed-on-request", switch "--installed-on-request",
description: "Mark <installed_formula> or <installed_cask> as installed on request." description: "Mark <installed_formula> or <installed_cask> as installed on request."
switch "--no-installed-on-request", switch "--no-installed-on-request",

1
Library/Homebrew/cmd/unalias.rb
View File

@ -11,6 +11,7 @@ module Homebrew
description <<~EOS description <<~EOS
Remove aliases. Remove aliases.
EOS EOS
named_args :alias, min: 1 named_args :alias, min: 1
end end

1
Library/Homebrew/dev-cmd/bump-formula-pr.rb
View File

@ -83,6 +83,7 @@ module Homebrew
description: "Exclude these Python packages when finding resources." description: "Exclude these Python packages when finding resources."
comma_array "--bump-synced=", comma_array "--bump-synced=",
hidden: true hidden: true
conflicts "--dry-run", "--write-only" conflicts "--dry-run", "--write-only"
conflicts "--no-audit", "--strict" conflicts "--no-audit", "--strict"
conflicts "--no-audit", "--online" conflicts "--no-audit", "--online"

1
Library/Homebrew/dev-cmd/cat.rb
View File

@ -13,7 +13,6 @@ module Homebrew
description <<~EOS description <<~EOS
Display the source of a <formula> or <cask>. Display the source of a <formula> or <cask>.
EOS EOS
switch "--formula", "--formulae", switch "--formula", "--formulae",
description: "Treat all named arguments as formulae." description: "Treat all named arguments as formulae."
switch "--cask", "--casks", switch "--cask", "--casks",

22
Library/Homebrew/dev-cmd/contributions.rb
View File

@ -15,28 +15,24 @@ module Homebrew
MAX_REPO_COMMITS = 1000 MAX_REPO_COMMITS = 1000
cmd_args do cmd_args do
usage_banner "`contributions` [--user=<email|username>] [<--repositories>`=`] [<--csv>]" usage_banner "`contributions` [`--user=`] [`--repositories=`] [`--from=`] [`--to=`] [`--csv`]"
description <<~EOS description <<~EOS
Summarise contributions to Homebrew repositories. Summarise contributions to Homebrew repositories.
EOS EOS
comma_array "--user=",
description: "Specify a comma-separated list of GitHub usernames or email addresses to find " \
"contributions from. Omitting this flag searches Homebrew maintainers."
comma_array "--repositories", comma_array "--repositories",
description: "Specify a comma-separated list of repositories to search. " \ description: "Specify a comma-separated list of repositories to search. " \
"Supported repositories: #{SUPPORTED_REPOS.map { |t| "`#{t}`" }.to_sentence}. " \ "Supported repositories: #{SUPPORTED_REPOS.map { |t| "`#{t}`" }.to_sentence}. " \
"Omitting this flag, or specifying `--repositories=primary`, searches only the " \ "Omitting this flag, or specifying `--repositories=primary`, searches only the " \
"main repositories: brew,core,cask. " \ "main repositories: `brew`, `core`, `cask`. " \
"Specifying `--repositories=all`, searches all repositories. " "Specifying `--repositories=all` searches all repositories. "
flag "--from=", flag "--from=",
description: "Date (ISO-8601 format) to start searching contributions. " \ description: "Date (ISO 8601 format) to start searching contributions. " \
"Omitting this flag searches the last year." "Omitting this flag searches the past year."
flag "--to=", flag "--to=",
description: "Date (ISO-8601 format) to stop searching contributions." description: "Date (ISO 8601 format) to stop searching contributions."
comma_array "--user=",
description: "Specify a comma-separated list of GitHub usernames or email addresses to find " \
"contributions from. Omitting this flag searches maintainers."
switch "--csv", switch "--csv",
description: "Print a CSV of contributions across repositories over the time period." description: "Print a CSV of contributions across repositories over the time period."
end end

1
Library/Homebrew/dev-cmd/dispatch-build-bottle.rb
View File

@ -35,6 +35,7 @@ module Homebrew
description: "Use Debian Wheezy container for building the bottle on Linux." description: "Use Debian Wheezy container for building the bottle on Linux."
conflicts "--linux", "--linux-self-hosted" conflicts "--linux", "--linux-self-hosted"
named_args :formula, min: 1 named_args :formula, min: 1
end end

16
Library/Homebrew/dev-cmd/formula-analytics.rb
View File

@ -17,19 +17,19 @@ module Homebrew
description: "Query from the specified days ago until the present. The default is 30 days." description: "Query from the specified days ago until the present. The default is 30 days."
switch "--install", switch "--install",
description: "Output the number of specifically requested installations or installation as " \ description: "Output the number of specifically requested installations or installation as " \
"dependencies of the formula. This is the default." "dependencies of formulae. This is the default."
switch "--install-on-request",
description: "Output the number of specifically requested installations of formulae."
switch "--cask-install", switch "--cask-install",
description: "Output the number of installations of casks." description: "Output the number of installations of casks."
switch "--install-on-request",
description: "Output the number of specifically requested installations of the formula."
switch "--build-error", switch "--build-error",
description: "Output the number of build errors for the formulae." description: "Output the number of build errors for formulae."
switch "--os-version", switch "--os-version",
description: "Output OS versions." description: "Output the number of events by OS name and version."
switch "--homebrew-devcmdrun-developer", switch "--homebrew-devcmdrun-developer",
description: "Output devcmdrun/HOMEBREW_DEVELOPER." description: "Output the number of devcmdrun/HOMEBREW_DEVELOPER events."
switch "--homebrew-os-arch-ci", switch "--homebrew-os-arch-ci",
description: "Output OS/Architecture/CI." description: "Output the number of OS/Architecture/CI events."
switch "--homebrew-prefixes", switch "--homebrew-prefixes",
description: "Output Homebrew prefixes." description: "Output Homebrew prefixes."
switch "--homebrew-versions", switch "--homebrew-versions",
@ -47,10 +47,12 @@ module Homebrew
"Homebrew/homebrew-core formulae." "Homebrew/homebrew-core formulae."
switch "--setup", switch "--setup",
description: "Install the necessary gems, require them and exit without running a query." description: "Install the necessary gems, require them and exit without running a query."
conflicts "--install", "--cask-install", "--install-on-request", "--build-error", "--os-version", conflicts "--install", "--cask-install", "--install-on-request", "--build-error", "--os-version",
"--homebrew-devcmdrun-developer", "--homebrew-os-arch-ci", "--homebrew-prefixes", "--homebrew-devcmdrun-developer", "--homebrew-os-arch-ci", "--homebrew-prefixes",
"--homebrew-versions", "--brew-command-run", "--brew-command-run-options", "--brew-test-bot-test" "--homebrew-versions", "--brew-command-run", "--brew-command-run-options", "--brew-test-bot-test"
conflicts "--json", "--all-core-formulae-json", "--setup" conflicts "--json", "--all-core-formulae-json", "--setup"
named_args :none named_args :none
end end

3
Library/Homebrew/dev-cmd/generate-analytics-api.rb
View File

@ -22,8 +22,7 @@ module Homebrew
cmd_args do cmd_args do
description <<~EOS description <<~EOS
Generates analytics API data files for formulae.brew.sh. Generates analytics API data files for <#{HOMEBREW_API_WWW}>.
The generated files are written to the current directory. The generated files are written to the current directory.
EOS EOS

4
Library/Homebrew/dev-cmd/generate-cask-api.rb
View File

@ -21,8 +21,8 @@ module Homebrew
Generate `homebrew/cask` API data files for <#{HOMEBREW_API_WWW}>. Generate `homebrew/cask` API data files for <#{HOMEBREW_API_WWW}>.
The generated files are written to the current directory. The generated files are written to the current directory.
EOS EOS
switch "-n", "--dry-run",
switch "-n", "--dry-run", description: "Generate API data without writing it to files." description: "Generate API data without writing it to files."
named_args :none named_args :none
end end

2
Library/Homebrew/dev-cmd/generate-cask-ci-matrix.rb
View File

@ -28,7 +28,6 @@ module Homebrew
Generate a GitHub Actions matrix for a given pull request URL or list of cask names. Generate a GitHub Actions matrix for a given pull request URL or list of cask names.
For internal use in Homebrew taps. For internal use in Homebrew taps.
EOS EOS
switch "--url", switch "--url",
description: "Treat named argument as a pull request URL." description: "Treat named argument as a pull request URL."
switch "--cask", "--casks", switch "--cask", "--casks",
@ -45,6 +44,7 @@ module Homebrew
conflicts "--syntax-only", "--new" conflicts "--syntax-only", "--new"
named_args [:cask, :url], min: 0 named_args [:cask, :url], min: 0
hide_from_man_page! hide_from_man_page!
end end

4
Library/Homebrew/dev-cmd/generate-formula-api.rb
View File

@ -20,8 +20,8 @@ module Homebrew
Generate `homebrew/core` API data files for <#{HOMEBREW_API_WWW}>. Generate `homebrew/core` API data files for <#{HOMEBREW_API_WWW}>.
The generated files are written to the current directory. The generated files are written to the current directory.
EOS EOS
switch "-n", "--dry-run",
switch "-n", "--dry-run", description: "Generate API data without writing it to files." description: "Generate API data without writing it to files."
named_args :none named_args :none
end end

1
Library/Homebrew/dev-cmd/generate-man-completions.rb
View File

@ -16,6 +16,7 @@ module Homebrew
description <<~EOS description <<~EOS
Generate Homebrew's manpages and shell completions. Generate Homebrew's manpages and shell completions.
EOS EOS
named_args :none named_args :none
end end

2
Library/Homebrew/dev-cmd/livecheck.rb
View File

@ -25,7 +25,7 @@ module Homebrew
switch "--installed", switch "--installed",
description: "Check formulae and casks that are currently installed." description: "Check formulae and casks that are currently installed."
switch "--newer-only", switch "--newer-only",
description: "Show the latest version only if it's newer than the formula/cask." description: "Show the latest version only if it's newer than the current formula or cask version."
switch "--json", switch "--json",
description: "Output information in JSON format." description: "Output information in JSON format."
switch "-r", "--resources", switch "-r", "--resources",

1
Library/Homebrew/dev-cmd/release.rb
View File

@ -21,6 +21,7 @@ module Homebrew
description: "Create a major release." description: "Create a major release."
switch "--minor", switch "--minor",
description: "Create a minor release." description: "Create a minor release."
conflicts "--major", "--minor" conflicts "--major", "--minor"
named_args :none named_args :none

1
Library/Homebrew/dev-cmd/tap-new.rb
View File

@ -17,7 +17,6 @@ module Homebrew
description <<~EOS description <<~EOS
Generate the template files for a new tap. Generate the template files for a new tap.
EOS EOS
switch "--no-git", switch "--no-git",
description: "Don't initialize a Git repository for the tap." description: "Don't initialize a Git repository for the tap."
flag "--pull-label=", flag "--pull-label=",

1
Library/Homebrew/dev-cmd/update-license-data.rb
View File

@ -14,6 +14,7 @@ module Homebrew
description <<~EOS description <<~EOS
Update SPDX license data in the Homebrew repository. Update SPDX license data in the Homebrew repository.
EOS EOS
named_args :none named_args :none
end end

1
Library/Homebrew/dev-cmd/vendor-gems.rb
View File

@ -12,7 +12,6 @@ module Homebrew
description <<~EOS description <<~EOS
Install and commit Homebrew's vendored gems. Install and commit Homebrew's vendored gems.
EOS EOS
comma_array "--update", comma_array "--update",
description: "Update the specified list of vendored gems to the latest version." description: "Update the specified list of vendored gems to the latest version."
switch "--no-commit", switch "--no-commit",

6
Library/Homebrew/dev-cmd/verify.rb
View File

@ -16,10 +16,10 @@ module Homebrew
Note that this command depends on the GitHub CLI. Run `brew install gh`. Note that this command depends on the GitHub CLI. Run `brew install gh`.
EOS EOS
flag "--os=", flag "--os=",
description: "Download for the given operating system." \ description: "Download for the given operating system. " \
"(Pass `all` to download for all operating systems.)" "(Pass `all` to download for all operating systems.)"
flag "--arch=", flag "--arch=",
description: "Download for the given CPU architecture." \ description: "Download for the given CPU architecture. " \
"(Pass `all` to download for all architectures.)" "(Pass `all` to download for all architectures.)"
flag "--bottle-tag=", flag "--bottle-tag=",
description: "Download a bottle for given tag." description: "Download a bottle for given tag."
@ -29,8 +29,10 @@ module Homebrew
description: "Remove a previously cached version and re-fetch." description: "Remove a previously cached version and re-fetch."
switch "-j", "--json", switch "-j", "--json",
description: "Return JSON for the attestation data for each bottle." description: "Return JSON for the attestation data for each bottle."
conflicts "--os", "--bottle-tag" conflicts "--os", "--bottle-tag"
conflicts "--arch", "--bottle-tag" conflicts "--arch", "--bottle-tag"
named_args [:formula], min: 1 named_args [:formula], min: 1
end end

14
Library/Homebrew/env_config.rb
View File

@ -49,13 +49,13 @@ module Homebrew
boolean: true, boolean: true,
}, },
HOMEBREW_ASK: { HOMEBREW_ASK: {
description: "If set, pass `--ask`to all formulae `brew install`, `brew upgrade` and `brew reinstall` " \ description: "If set, pass `--ask` to all formulae `brew install`, `brew upgrade` and `brew reinstall` " \
"commands.", "commands.",
boolean: true, boolean: true,
}, },
HOMEBREW_AUTO_UPDATE_SECS: { HOMEBREW_AUTO_UPDATE_SECS: {
description: "Run `brew update` once every `$HOMEBREW_AUTO_UPDATE_SECS` seconds before some commands, " \ description: "Run `brew update` once every `$HOMEBREW_AUTO_UPDATE_SECS` seconds before some commands, " \
"e.g. `brew install`, `brew upgrade` and `brew tap`. Alternatively, " \ "e.g. `brew install`, `brew upgrade` or `brew tap`. Alternatively, " \
"disable auto-update entirely with `$HOMEBREW_NO_AUTO_UPDATE`.", "disable auto-update entirely with `$HOMEBREW_NO_AUTO_UPDATE`.",
default_text: "`86400` (24 hours), `3600` (1 hour) if a developer command has been run " \ default_text: "`86400` (24 hours), `3600` (1 hour) if a developer command has been run " \
"or `300` (5 minutes) if `$HOMEBREW_NO_INSTALL_FROM_API` is set.", "or `300` (5 minutes) if `$HOMEBREW_NO_INSTALL_FROM_API` is set.",
@ -274,17 +274,17 @@ module Homebrew
HOMEBREW_FORMULA_BUILD_NETWORK: { HOMEBREW_FORMULA_BUILD_NETWORK: {
description: "If set, controls network access to the sandbox for formulae builds. Overrides any " \ description: "If set, controls network access to the sandbox for formulae builds. Overrides any " \
"controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \ "controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \
"set through this environment variable or DSL usage, the default behavior is `allow`.", "set through this environment variable or DSL usage, the default behaviour is `allow`.",
}, },
HOMEBREW_FORMULA_POSTINSTALL_NETWORK: { HOMEBREW_FORMULA_POSTINSTALL_NETWORK: {
description: "If set, controls network access to the sandbox for formulae postinstall. Overrides any " \ description: "If set, controls network access to the sandbox for formulae postinstall. Overrides any " \
"controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \ "controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \
"set through this environment variable or DSL usage, the default behavior is `allow`.", "set through this environment variable or DSL usage, the default behaviour is `allow`.",
}, },
HOMEBREW_FORMULA_TEST_NETWORK: { HOMEBREW_FORMULA_TEST_NETWORK: {
description: "If set, controls network access to the sandbox for formulae test. Overrides any " \ description: "If set, controls network access to the sandbox for formulae test. Overrides any " \
"controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \ "controls set through DSL usage inside formulae. Must be `allow` or `deny`. If no value is " \
"set through this environment variable or DSL usage, the default behavior is `allow`.", "set through this environment variable or DSL usage, the default behaviour is `allow`.",
}, },
HOMEBREW_GITHUB_API_TOKEN: { HOMEBREW_GITHUB_API_TOKEN: {
description: "Use this personal access token for the GitHub API, for features such as " \ description: "Use this personal access token for the GitHub API, for features such as " \
@ -366,7 +366,7 @@ module Homebrew
}, },
HOMEBREW_NO_AUTO_UPDATE: { HOMEBREW_NO_AUTO_UPDATE: {
description: "If set, do not automatically update before running some commands, e.g. " \ description: "If set, do not automatically update before running some commands, e.g. " \
"`brew install`, `brew upgrade` and `brew tap`. Preferably, " \ "`brew install`, `brew upgrade` or `brew tap`. Preferably, " \
"run this less often by setting `$HOMEBREW_AUTO_UPDATE_SECS` to a value higher than the " \ "run this less often by setting `$HOMEBREW_AUTO_UPDATE_SECS` to a value higher than the " \
"default. Note that setting this and e.g. tapping new taps may result in a broken " \ "default. Note that setting this and e.g. tapping new taps may result in a broken " \
"configuration. Please ensure you always run `brew update` before reporting any issues.", "configuration. Please ensure you always run `brew update` before reporting any issues.",
@ -405,7 +405,7 @@ module Homebrew
HOMEBREW_NO_INSECURE_REDIRECT: { HOMEBREW_NO_INSECURE_REDIRECT: {
description: "If set, forbid redirects from secure HTTPS to insecure HTTP." \ description: "If set, forbid redirects from secure HTTPS to insecure HTTP." \
"\n\n *Note:* while ensuring your downloads are fully secure, this is likely to cause " \ "\n\n *Note:* while ensuring your downloads are fully secure, this is likely to cause " \
"from-source SourceForge, some GNU & GNOME-hosted formulae to fail to download.", "sources for certain formulae hosted by SourceForge, GNU or GNOME to fail to download.",
boolean: true, boolean: true,
}, },
HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: { HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: {

6
Library/Homebrew/manpages/brew.1.md.erb
View File

@ -36,7 +36,7 @@ Linux distribution without requiring `sudo`.
**cask** **cask**
: Homebrew package definition that installs macOS native applications : Homebrew package definition that installs native applications directly from upstream
**prefix** **prefix**
@ -186,8 +186,8 @@ User-specific environment files take precedence over prefix-specific files and
prefix-specific files take precedence over system-wide files (unless prefix-specific files take precedence over system-wide files (unless
`$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY` is set, see below). `$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY` is set, see below).
Note that these files do not support shell variable expansion e.g. `$HOME` or Note that these files do not support shell variable expansion (e.g. `$HOME`) or
command execution e.g. `$(cat file)`. command execution (e.g. `$(cat file)`).
<%= environment_variables %> <%= environment_variables %>

36
completions/fish/brew.fish
View File

@ -515,7 +515,7 @@ __fish_brew_complete_arg 'bundle' -l force -d '`install` runs with `--force`/`--
__fish_brew_complete_arg 'bundle' -l formula -d '`list`, `dump` or `cleanup` Homebrew formula dependencies' __fish_brew_complete_arg 'bundle' -l formula -d '`list`, `dump` or `cleanup` Homebrew formula dependencies'
__fish_brew_complete_arg 'bundle' -l global -d 'Read from or write to the `Brewfile` from `$HOMEBREW_BUNDLE_FILE_GLOBAL` (if set), `${XDG_CONFIG_HOME}/homebrew/Brewfile` (if `$XDG_CONFIG_HOME` is set), `~/.homebrew/Brewfile` or `~/.Brewfile` otherwise' __fish_brew_complete_arg 'bundle' -l global -d 'Read from or write to the `Brewfile` from `$HOMEBREW_BUNDLE_FILE_GLOBAL` (if set), `${XDG_CONFIG_HOME}/homebrew/Brewfile` (if `$XDG_CONFIG_HOME` is set), `~/.homebrew/Brewfile` or `~/.Brewfile` otherwise'
__fish_brew_complete_arg 'bundle' -l help -d 'Show this message' __fish_brew_complete_arg 'bundle' -l help -d 'Show this message'
__fish_brew_complete_arg 'bundle' -l install -d 'Run `install` before continuing to other operations e.g. `exec`' __fish_brew_complete_arg 'bundle' -l install -d 'Run `install` before continuing to other operations, e.g. `exec`'
__fish_brew_complete_arg 'bundle' -l mas -d '`list` or `dump` Mac App Store dependencies' __fish_brew_complete_arg 'bundle' -l mas -d '`list` or `dump` Mac App Store dependencies'
__fish_brew_complete_arg 'bundle' -l no-restart -d '`dump` does not add `restart_service` to formula lines' __fish_brew_complete_arg 'bundle' -l no-restart -d '`dump` does not add `restart_service` to formula lines'
__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. Enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set' __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. Enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set'
@ -598,12 +598,12 @@ __fish_brew_complete_arg 'config' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_cmd 'contributions' 'Summarise contributions to Homebrew repositories' __fish_brew_complete_cmd 'contributions' 'Summarise contributions to Homebrew repositories'
__fish_brew_complete_arg 'contributions' -l csv -d 'Print a CSV of contributions across repositories over the time period' __fish_brew_complete_arg 'contributions' -l csv -d 'Print a CSV of contributions across repositories over the time period'
__fish_brew_complete_arg 'contributions' -l debug -d 'Display any debugging information' __fish_brew_complete_arg 'contributions' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'contributions' -l from -d 'Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year' __fish_brew_complete_arg 'contributions' -l from -d 'Date (ISO 8601 format) to start searching contributions. Omitting this flag searches the past year'
__fish_brew_complete_arg 'contributions' -l help -d 'Show this message' __fish_brew_complete_arg 'contributions' -l help -d 'Show this message'
__fish_brew_complete_arg 'contributions' -l quiet -d 'Make some output more quiet' __fish_brew_complete_arg 'contributions' -l quiet -d 'Make some output more quiet'
__fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. ' __fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all` searches all repositories. '
__fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO-8601 format) to stop searching contributions' __fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO 8601 format) to stop searching contributions'
__fish_brew_complete_arg 'contributions' -l user -d 'Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers' __fish_brew_complete_arg 'contributions' -l user -d 'Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches Homebrew maintainers'
__fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose' __fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose'
@ -826,19 +826,19 @@ __fish_brew_complete_arg 'formula-analytics' -l all-core-formulae-json -d 'Outpu
__fish_brew_complete_arg 'formula-analytics' -l brew-command-run -d 'Output `brew` commands run' __fish_brew_complete_arg 'formula-analytics' -l brew-command-run -d 'Output `brew` commands run'
__fish_brew_complete_arg 'formula-analytics' -l brew-command-run-options -d 'Output `brew` commands run with options' __fish_brew_complete_arg 'formula-analytics' -l brew-command-run-options -d 'Output `brew` commands run with options'
__fish_brew_complete_arg 'formula-analytics' -l brew-test-bot-test -d 'Output `brew test-bot` steps run' __fish_brew_complete_arg 'formula-analytics' -l brew-test-bot-test -d 'Output `brew test-bot` steps run'
__fish_brew_complete_arg 'formula-analytics' -l build-error -d 'Output the number of build errors for the formulae' __fish_brew_complete_arg 'formula-analytics' -l build-error -d 'Output the number of build errors for formulae'
__fish_brew_complete_arg 'formula-analytics' -l cask-install -d 'Output the number of installations of casks' __fish_brew_complete_arg 'formula-analytics' -l cask-install -d 'Output the number of installations of casks'
__fish_brew_complete_arg 'formula-analytics' -l days-ago -d 'Query from the specified days ago until the present. The default is 30 days' __fish_brew_complete_arg 'formula-analytics' -l days-ago -d 'Query from the specified days ago until the present. The default is 30 days'
__fish_brew_complete_arg 'formula-analytics' -l debug -d 'Display any debugging information' __fish_brew_complete_arg 'formula-analytics' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'formula-analytics' -l help -d 'Show this message' __fish_brew_complete_arg 'formula-analytics' -l help -d 'Show this message'
__fish_brew_complete_arg 'formula-analytics' -l homebrew-devcmdrun-developer -d 'Output devcmdrun/HOMEBREW_DEVELOPER' __fish_brew_complete_arg 'formula-analytics' -l homebrew-devcmdrun-developer -d 'Output the number of devcmdrun/HOMEBREW_DEVELOPER events'
__fish_brew_complete_arg 'formula-analytics' -l homebrew-os-arch-ci -d 'Output OS/Architecture/CI' __fish_brew_complete_arg 'formula-analytics' -l homebrew-os-arch-ci -d 'Output the number of OS/Architecture/CI events'
__fish_brew_complete_arg 'formula-analytics' -l homebrew-prefixes -d 'Output Homebrew prefixes' __fish_brew_complete_arg 'formula-analytics' -l homebrew-prefixes -d 'Output Homebrew prefixes'
__fish_brew_complete_arg 'formula-analytics' -l homebrew-versions -d 'Output Homebrew versions' __fish_brew_complete_arg 'formula-analytics' -l homebrew-versions -d 'Output Homebrew versions'
__fish_brew_complete_arg 'formula-analytics' -l install -d 'Output the number of specifically requested installations or installation as dependencies of the formula. This is the default' __fish_brew_complete_arg 'formula-analytics' -l install -d 'Output the number of specifically requested installations or installation as dependencies of formulae. This is the default'
__fish_brew_complete_arg 'formula-analytics' -l install-on-request -d 'Output the number of specifically requested installations of the formula' __fish_brew_complete_arg 'formula-analytics' -l install-on-request -d 'Output the number of specifically requested installations of formulae'
__fish_brew_complete_arg 'formula-analytics' -l json -d 'Output JSON. This is required: plain text support has been removed' __fish_brew_complete_arg 'formula-analytics' -l json -d 'Output JSON. This is required: plain text support has been removed'
__fish_brew_complete_arg 'formula-analytics' -l os-version -d 'Output OS versions' __fish_brew_complete_arg 'formula-analytics' -l os-version -d 'Output the number of events by OS name and version'
__fish_brew_complete_arg 'formula-analytics' -l quiet -d 'Make some output more quiet' __fish_brew_complete_arg 'formula-analytics' -l quiet -d 'Make some output more quiet'
__fish_brew_complete_arg 'formula-analytics' -l setup -d 'Install the necessary gems, require them and exit without running a query' __fish_brew_complete_arg 'formula-analytics' -l setup -d 'Install the necessary gems, require them and exit without running a query'
__fish_brew_complete_arg 'formula-analytics' -l verbose -d 'Make some output more verbose' __fish_brew_complete_arg 'formula-analytics' -l verbose -d 'Make some output more verbose'
@ -851,7 +851,7 @@ __fish_brew_complete_arg 'formulae' -l quiet -d 'Make some output more quiet'
__fish_brew_complete_arg 'formulae' -l verbose -d 'Make some output more verbose' __fish_brew_complete_arg 'formulae' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_cmd 'generate-analytics-api' 'Generates analytics API data files for formulae.brew.sh' __fish_brew_complete_cmd 'generate-analytics-api' 'Generates analytics API data files for https://formulae.brew.sh'
__fish_brew_complete_arg 'generate-analytics-api' -l debug -d 'Display any debugging information' __fish_brew_complete_arg 'generate-analytics-api' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'generate-analytics-api' -l help -d 'Show this message' __fish_brew_complete_arg 'generate-analytics-api' -l help -d 'Show this message'
__fish_brew_complete_arg 'generate-analytics-api' -l quiet -d 'Make some output more quiet' __fish_brew_complete_arg 'generate-analytics-api' -l quiet -d 'Make some output more quiet'
@ -1089,7 +1089,7 @@ __fish_brew_complete_arg 'lc' -l full-name -d 'Print formulae and casks with ful
__fish_brew_complete_arg 'lc' -l help -d 'Show this message' __fish_brew_complete_arg 'lc' -l help -d 'Show this message'
__fish_brew_complete_arg 'lc' -l installed -d 'Check formulae and casks that are currently installed' __fish_brew_complete_arg 'lc' -l installed -d 'Check formulae and casks that are currently installed'
__fish_brew_complete_arg 'lc' -l json -d 'Output information in JSON format' __fish_brew_complete_arg 'lc' -l json -d 'Output information in JSON format'
__fish_brew_complete_arg 'lc' -l newer-only -d 'Show the latest version only if it\'s newer than the formula/cask' __fish_brew_complete_arg 'lc' -l newer-only -d 'Show the latest version only if it\'s newer than the current formula or cask version'
__fish_brew_complete_arg 'lc' -l quiet -d 'Suppress warnings, don\'t print a progress bar for JSON output' __fish_brew_complete_arg 'lc' -l quiet -d 'Suppress warnings, don\'t print a progress bar for JSON output'
__fish_brew_complete_arg 'lc' -l resources -d 'Also check resources for formulae' __fish_brew_complete_arg 'lc' -l resources -d 'Also check resources for formulae'
__fish_brew_complete_arg 'lc' -l tap -d 'Check formulae and casks within the given tap, specified as user`/`repo' __fish_brew_complete_arg 'lc' -l tap -d 'Check formulae and casks within the given tap, specified as user`/`repo'
@ -1148,7 +1148,7 @@ __fish_brew_complete_arg 'list' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_arg 'list' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided' __fish_brew_complete_arg 'list' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided'
__fish_brew_complete_arg 'list' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal' __fish_brew_complete_arg 'list' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal'
__fish_brew_complete_arg 'list' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'list' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'list' -l r -d 'Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'list' -l r -d 'Reverse the order of formula and/or cask sorting to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'list' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'list' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'list; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_installed)' __fish_brew_complete_arg 'list; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_installed)'
__fish_brew_complete_arg 'list; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_installed)' __fish_brew_complete_arg 'list; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_installed)'
@ -1165,7 +1165,7 @@ __fish_brew_complete_arg 'livecheck' -l full-name -d 'Print formulae and casks w
__fish_brew_complete_arg 'livecheck' -l help -d 'Show this message' __fish_brew_complete_arg 'livecheck' -l help -d 'Show this message'
__fish_brew_complete_arg 'livecheck' -l installed -d 'Check formulae and casks that are currently installed' __fish_brew_complete_arg 'livecheck' -l installed -d 'Check formulae and casks that are currently installed'
__fish_brew_complete_arg 'livecheck' -l json -d 'Output information in JSON format' __fish_brew_complete_arg 'livecheck' -l json -d 'Output information in JSON format'
__fish_brew_complete_arg 'livecheck' -l newer-only -d 'Show the latest version only if it\'s newer than the formula/cask' __fish_brew_complete_arg 'livecheck' -l newer-only -d 'Show the latest version only if it\'s newer than the current formula or cask version'
__fish_brew_complete_arg 'livecheck' -l quiet -d 'Suppress warnings, don\'t print a progress bar for JSON output' __fish_brew_complete_arg 'livecheck' -l quiet -d 'Suppress warnings, don\'t print a progress bar for JSON output'
__fish_brew_complete_arg 'livecheck' -l resources -d 'Also check resources for formulae' __fish_brew_complete_arg 'livecheck' -l resources -d 'Also check resources for formulae'
__fish_brew_complete_arg 'livecheck' -l tap -d 'Check formulae and casks within the given tap, specified as user`/`repo' __fish_brew_complete_arg 'livecheck' -l tap -d 'Check formulae and casks within the given tap, specified as user`/`repo'
@ -1219,7 +1219,7 @@ __fish_brew_complete_arg 'ls' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_arg 'ls' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided' __fish_brew_complete_arg 'ls' -l versions -d 'Show the version number for installed formulae, or only the specified formulae if formula are provided'
__fish_brew_complete_arg 'ls' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal' __fish_brew_complete_arg 'ls' -l 1 -d 'Force output to be one entry per line. This is the default when output is not to a terminal'
__fish_brew_complete_arg 'ls' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'ls' -l l -d 'List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'ls' -l r -d 'Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'ls' -l r -d 'Reverse the order of formula and/or cask sorting to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'ls' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument' __fish_brew_complete_arg 'ls' -l t -d 'Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument'
__fish_brew_complete_arg 'ls; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_installed)' __fish_brew_complete_arg 'ls; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_installed)'
__fish_brew_complete_arg 'ls; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_installed)' __fish_brew_complete_arg 'ls; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_installed)'
@ -1987,14 +1987,14 @@ __fish_brew_complete_arg 'vendor-install' -l verbose -d 'Make some output more v
__fish_brew_complete_cmd 'verify' 'Verify the build provenance of bottles using GitHub\'s attestation tools' __fish_brew_complete_cmd 'verify' 'Verify the build provenance of bottles using GitHub\'s attestation tools'
__fish_brew_complete_arg 'verify' -l arch -d 'Download for the given CPU architecture.(Pass `all` to download for all architectures.)' __fish_brew_complete_arg 'verify' -l arch -d 'Download for the given CPU architecture. (Pass `all` to download for all architectures.)'
__fish_brew_complete_arg 'verify' -l bottle-tag -d 'Download a bottle for given tag' __fish_brew_complete_arg 'verify' -l bottle-tag -d 'Download a bottle for given tag'
__fish_brew_complete_arg 'verify' -l debug -d 'Display any debugging information' __fish_brew_complete_arg 'verify' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'verify' -l deps -d 'Also download dependencies for any listed formula' __fish_brew_complete_arg 'verify' -l deps -d 'Also download dependencies for any listed formula'
__fish_brew_complete_arg 'verify' -l force -d 'Remove a previously cached version and re-fetch' __fish_brew_complete_arg 'verify' -l force -d 'Remove a previously cached version and re-fetch'
__fish_brew_complete_arg 'verify' -l help -d 'Show this message' __fish_brew_complete_arg 'verify' -l help -d 'Show this message'
__fish_brew_complete_arg 'verify' -l json -d 'Return JSON for the attestation data for each bottle' __fish_brew_complete_arg 'verify' -l json -d 'Return JSON for the attestation data for each bottle'
__fish_brew_complete_arg 'verify' -l os -d 'Download for the given operating system.(Pass `all` to download for all operating systems.)' __fish_brew_complete_arg 'verify' -l os -d 'Download for the given operating system. (Pass `all` to download for all operating systems.)'
__fish_brew_complete_arg 'verify' -l quiet -d 'Make some output more quiet' __fish_brew_complete_arg 'verify' -l quiet -d 'Make some output more quiet'
__fish_brew_complete_arg 'verify' -l verbose -d 'Make some output more verbose' __fish_brew_complete_arg 'verify' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_arg 'verify' -a '(__fish_brew_suggest_formulae_all)' __fish_brew_complete_arg 'verify' -a '(__fish_brew_suggest_formulae_all)'

36
completions/zsh/_brew
View File

@ -173,7 +173,7 @@ __brew_internal_commands() {
'formula:Display the path where formula is located' 'formula:Display the path where formula is located'
'formula-analytics:Query Homebrew'\''s analytics' 'formula-analytics:Query Homebrew'\''s analytics'
'formulae:List all locally installable formulae including short names' 'formulae:List all locally installable formulae including short names'
'generate-analytics-api:Generates analytics API data files for formulae.brew.sh' 'generate-analytics-api:Generates analytics API data files for https://formulae.brew.sh'
'generate-cask-api:Generate `homebrew/cask` API data files for https://formulae.brew.sh' 'generate-cask-api:Generate `homebrew/cask` API data files for https://formulae.brew.sh'
'generate-cask-ci-matrix:Generate a GitHub Actions matrix for a given pull request URL or list of cask names' 'generate-cask-ci-matrix:Generate a GitHub Actions matrix for a given pull request URL or list of cask names'
'generate-formula-api:Generate `homebrew/core` API data files for https://formulae.brew.sh' 'generate-formula-api:Generate `homebrew/core` API data files for https://formulae.brew.sh'
@ -660,7 +660,7 @@ _brew_bundle() {
'--formula[`list`, `dump` or `cleanup` Homebrew formula dependencies]' \ '--formula[`list`, `dump` or `cleanup` Homebrew formula dependencies]' \
'(--file)--global[Read from or write to the `Brewfile` from `$HOMEBREW_BUNDLE_FILE_GLOBAL` (if set), `${XDG_CONFIG_HOME}/homebrew/Brewfile` (if `$XDG_CONFIG_HOME` is set), `~/.homebrew/Brewfile` or `~/.Brewfile` otherwise]' \ '(--file)--global[Read from or write to the `Brewfile` from `$HOMEBREW_BUNDLE_FILE_GLOBAL` (if set), `${XDG_CONFIG_HOME}/homebrew/Brewfile` (if `$XDG_CONFIG_HOME` is set), `~/.homebrew/Brewfile` or `~/.Brewfile` otherwise]' \
'--help[Show this message]' \ '--help[Show this message]' \
'(--upgrade)--install[Run `install` before continuing to other operations e.g. `exec`]' \ '(--upgrade)--install[Run `install` before continuing to other operations, e.g. `exec`]' \
'--mas[`list` or `dump` Mac App Store dependencies]' \ '--mas[`list` or `dump` Mac App Store dependencies]' \
'--no-restart[`dump` does not add `restart_service` to formula lines]' \ '--no-restart[`dump` does not add `restart_service` to formula lines]' \
'--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. Enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set]' \ '--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. Enabled by default if `$HOMEBREW_BUNDLE_NO_UPGRADE` is set]' \
@ -765,12 +765,12 @@ _brew_contributions() {
_arguments \ _arguments \
'--csv[Print a CSV of contributions across repositories over the time period]' \ '--csv[Print a CSV of contributions across repositories over the time period]' \
'--debug[Display any debugging information]' \ '--debug[Display any debugging information]' \
'--from[Date (ISO-8601 format) to start searching contributions. Omitting this flag searches the last year]' \ '--from[Date (ISO 8601 format) to start searching contributions. Omitting this flag searches the past year]' \
'--help[Show this message]' \ '--help[Show this message]' \
'--quiet[Make some output more quiet]' \ '--quiet[Make some output more quiet]' \
'--repositories[Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: brew,core,cask. Specifying `--repositories=all`, searches all repositories. ]' \ '--repositories[Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all` searches all repositories. ]' \
'--to[Date (ISO-8601 format) to stop searching contributions]' \ '--to[Date (ISO 8601 format) to stop searching contributions]' \
'--user[Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches maintainers]' \ '--user[Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches Homebrew maintainers]' \
'--verbose[Make some output more verbose]' '--verbose[Make some output more verbose]'
} }
@ -1041,19 +1041,19 @@ _brew_formula_analytics() {
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run-options --brew-test-bot-test)--brew-command-run[Output `brew` commands run]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run-options --brew-test-bot-test)--brew-command-run[Output `brew` commands run]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-test-bot-test)--brew-command-run-options[Output `brew` commands run with options]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-test-bot-test)--brew-command-run-options[Output `brew` commands run with options]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options)--brew-test-bot-test[Output `brew test-bot` steps run]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options)--brew-test-bot-test[Output `brew test-bot` steps run]' \
'(--install --cask-install --install-on-request --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--build-error[Output the number of build errors for the formulae]' \ '(--install --cask-install --install-on-request --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--build-error[Output the number of build errors for formulae]' \
'(--install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--cask-install[Output the number of installations of casks]' \ '(--install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--cask-install[Output the number of installations of casks]' \
'--days-ago[Query from the specified days ago until the present. The default is 30 days]' \ '--days-ago[Query from the specified days ago until the present. The default is 30 days]' \
'--debug[Display any debugging information]' \ '--debug[Display any debugging information]' \
'--help[Show this message]' \ '--help[Show this message]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-devcmdrun-developer[Output devcmdrun/HOMEBREW_DEVELOPER]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-devcmdrun-developer[Output the number of devcmdrun/HOMEBREW_DEVELOPER events]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-os-arch-ci[Output OS/Architecture/CI]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-os-arch-ci[Output the number of OS/Architecture/CI events]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-prefixes[Output Homebrew prefixes]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-prefixes[Output Homebrew prefixes]' \
'(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-versions[Output Homebrew versions]' \ '(--install --cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --brew-command-run --brew-command-run-options --brew-test-bot-test)--homebrew-versions[Output Homebrew versions]' \
'(--cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--install[Output the number of specifically requested installations or installation as dependencies of the formula. This is the default]' \ '(--cask-install --install-on-request --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--install[Output the number of specifically requested installations or installation as dependencies of formulae. This is the default]' \
'(--install --cask-install --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--install-on-request[Output the number of specifically requested installations of the formula]' \ '(--install --cask-install --build-error --os-version --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--install-on-request[Output the number of specifically requested installations of formulae]' \
'(--all-core-formulae-json --setup)--json[Output JSON. This is required: plain text support has been removed]' \ '(--all-core-formulae-json --setup)--json[Output JSON. This is required: plain text support has been removed]' \
'(--install --cask-install --install-on-request --build-error --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--os-version[Output OS versions]' \ '(--install --cask-install --install-on-request --build-error --homebrew-devcmdrun-developer --homebrew-os-arch-ci --homebrew-prefixes --homebrew-versions --brew-command-run --brew-command-run-options --brew-test-bot-test)--os-version[Output the number of events by OS name and version]' \
'--quiet[Make some output more quiet]' \ '--quiet[Make some output more quiet]' \
'(--json --all-core-formulae-json)--setup[Install the necessary gems, require them and exit without running a query]' \ '(--json --all-core-formulae-json)--setup[Install the necessary gems, require them and exit without running a query]' \
'--verbose[Make some output more verbose]' '--verbose[Make some output more verbose]'
@ -1345,7 +1345,7 @@ _brew_lc() {
'--help[Show this message]' \ '--help[Show this message]' \
'(--tap --eval-all)--installed[Check formulae and casks that are currently installed]' \ '(--tap --eval-all)--installed[Check formulae and casks that are currently installed]' \
'(--debug)--json[Output information in JSON format]' \ '(--debug)--json[Output information in JSON format]' \
'--newer-only[Show the latest version only if it'\''s newer than the formula/cask]' \ '--newer-only[Show the latest version only if it'\''s newer than the current formula or cask version]' \
'--quiet[Suppress warnings, don'\''t print a progress bar for JSON output]' \ '--quiet[Suppress warnings, don'\''t print a progress bar for JSON output]' \
'--resources[Also check resources for formulae]' \ '--resources[Also check resources for formulae]' \
'(--eval-all --installed)--tap[Check formulae and casks within the given tap, specified as user`/`repo]' \ '(--eval-all --installed)--tap[Check formulae and casks within the given tap, specified as user`/`repo]' \
@ -1416,7 +1416,7 @@ _brew_list() {
'(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source -1 -l -r -t --full-name)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \ '(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source -1 -l -r -t --full-name)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \
'(--versions --pinned)-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \ '(--versions --pinned)-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \
'(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source --versions --pinned --full-name)-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \ '(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source --versions --pinned --full-name)-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \
'(--versions --pinned --full-name)-r[Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \ '(--versions --pinned --full-name)-r[Reverse the order of formula and/or cask sorting to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \
'(--versions --pinned --full-name)-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \ '(--versions --pinned --full-name)-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \
- installed_formula \ - installed_formula \
'(--cask)--formula[List only formulae, or treat all named arguments as formulae]' \ '(--cask)--formula[List only formulae, or treat all named arguments as formulae]' \
@ -1437,7 +1437,7 @@ _brew_livecheck() {
'--help[Show this message]' \ '--help[Show this message]' \
'(--tap --eval-all)--installed[Check formulae and casks that are currently installed]' \ '(--tap --eval-all)--installed[Check formulae and casks that are currently installed]' \
'(--debug)--json[Output information in JSON format]' \ '(--debug)--json[Output information in JSON format]' \
'--newer-only[Show the latest version only if it'\''s newer than the formula/cask]' \ '--newer-only[Show the latest version only if it'\''s newer than the current formula or cask version]' \
'--quiet[Suppress warnings, don'\''t print a progress bar for JSON output]' \ '--quiet[Suppress warnings, don'\''t print a progress bar for JSON output]' \
'--resources[Also check resources for formulae]' \ '--resources[Also check resources for formulae]' \
'(--eval-all --installed)--tap[Check formulae and casks within the given tap, specified as user`/`repo]' \ '(--eval-all --installed)--tap[Check formulae and casks within the given tap, specified as user`/`repo]' \
@ -1502,7 +1502,7 @@ _brew_ls() {
'(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source -1 -l -r -t --full-name)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \ '(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source -1 -l -r -t --full-name)--versions[Show the version number for installed formulae, or only the specified formulae if formula are provided]' \
'(--versions --pinned)-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \ '(--versions --pinned)-1[Force output to be one entry per line. This is the default when output is not to a terminal]' \
'(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source --versions --pinned --full-name)-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \ '(--installed-on-request --installed-as-dependency --poured-from-bottle --built-from-source --versions --pinned --full-name)-l[List formulae and/or casks in long format. Has no effect when a formula or cask name is passed as an argument]' \
'(--versions --pinned --full-name)-r[Reverse the order of the formulae and/or casks sort to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \ '(--versions --pinned --full-name)-r[Reverse the order of formula and/or cask sorting to list the oldest entries first. Has no effect when a formula or cask name is passed as an argument]' \
'(--versions --pinned --full-name)-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \ '(--versions --pinned --full-name)-t[Sort formulae and/or casks by time modified, listing most recently modified first. Has no effect when a formula or cask name is passed as an argument]' \
- installed_formula \ - installed_formula \
'(--cask)--formula[List only formulae, or treat all named arguments as formulae]' \ '(--cask)--formula[List only formulae, or treat all named arguments as formulae]' \
@ -2443,14 +2443,14 @@ _brew_vendor_install() {
# brew verify # brew verify
_brew_verify() { _brew_verify() {
_arguments \ _arguments \
'(--bottle-tag)--arch[Download for the given CPU architecture.(Pass `all` to download for all architectures.)]' \ '(--bottle-tag)--arch[Download for the given CPU architecture. (Pass `all` to download for all architectures.)]' \
'(--os --arch)--bottle-tag[Download a bottle for given tag]' \ '(--os --arch)--bottle-tag[Download a bottle for given tag]' \
'--debug[Display any debugging information]' \ '--debug[Display any debugging information]' \
'--deps[Also download dependencies for any listed formula]' \ '--deps[Also download dependencies for any listed formula]' \
'--force[Remove a previously cached version and re-fetch]' \ '--force[Remove a previously cached version and re-fetch]' \
'--help[Show this message]' \ '--help[Show this message]' \
'--json[Return JSON for the attestation data for each bottle]' \ '--json[Return JSON for the attestation data for each bottle]' \
'(--bottle-tag)--os[Download for the given operating system.(Pass `all` to download for all operating systems.)]' \ '(--bottle-tag)--os[Download for the given operating system. (Pass `all` to download for all operating systems.)]' \
'--quiet[Make some output more quiet]' \ '--quiet[Make some output more quiet]' \
'--verbose[Make some output more verbose]' \ '--verbose[Make some output more verbose]' \
- formula \ - formula \

85
docs/Manpage.md
View File

@ -19,7 +19,8 @@ Linux distribution without requiring `sudo`.
**cask** **cask**
: Homebrew package definition that installs macOS native applications : Homebrew package definition that installs native applications directly from
upstream
**prefix** **prefix**
@ -199,7 +200,7 @@ By default, only Homebrew formula dependencies are listed.
of the corresponding type. Passing `--formula` also removes matches against of the corresponding type. Passing `--formula` also removes matches against
formula aliases and old formula names. formula aliases and old formula names.
`brew bundle exec` \[--check\] *`command`* `brew bundle exec` \[`--check`\] *`command`*
: Run an external command in an isolated build environment based on the : Run an external command in an isolated build environment based on the
`Brewfile` dependencies. `Brewfile` dependencies.
@ -210,11 +211,11 @@ commands like `bundle install`, `npm install`, etc. It will also add compiler
flags which will help with finding keg-only dependencies like `openssl`, flags which will help with finding keg-only dependencies like `openssl`,
`icu4c`, etc. `icu4c`, etc.
`brew bundle sh` \[--check\] `brew bundle sh` \[`--check`\]
: Run your shell in a `brew bundle exec` environment. : Run your shell in a `brew bundle exec` environment.
`brew bundle env` \[--check\] `brew bundle env` \[`--check`\]
: Print the environment variables that would be set in a `brew bundle exec` : Print the environment variables that would be set in a `brew bundle exec`
environment. environment.
@ -254,7 +255,7 @@ flags which will help with finding keg-only dependencies like `openssl`,
`--install` `--install`
: Run `install` before continuing to other operations e.g. `exec`. : Run `install` before continuing to other operations, e.g. `exec`.
`--services` `--services`
@ -1010,7 +1011,7 @@ paths within its current keg. If *`cask`* is provided, list its artifacts.
`-r` `-r`
: Reverse the order of the formulae and/or casks sort to list the oldest entries : Reverse the order of formula and/or cask sorting to list the oldest entries
first. Has no effect when a formula or cask name is passed as an argument. first. Has no effect when a formula or cask name is passed as an argument.
`-t` `-t`
@ -2394,31 +2395,31 @@ Display the source of a *`formula`* or *`cask`*.
: Treat all named arguments as casks. : Treat all named arguments as casks.
### `contributions` \[--user=*`email|username`*\] \[*`--repositories`*`=`\] \[*`--csv`*\] ### `contributions` \[`--user=`\] \[`--repositories=`\] \[`--from=`\] \[`--to=`\] \[`--csv`\]
Summarise contributions to Homebrew repositories. Summarise contributions to Homebrew repositories.
`--user`
: Specify a comma-separated list of GitHub usernames or email addresses to find
contributions from. Omitting this flag searches Homebrew maintainers.
`--repositories` `--repositories`
: Specify a comma-separated list of repositories to search. Supported : Specify a comma-separated list of repositories to search. Supported
repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`.
Omitting this flag, or specifying `--repositories=primary`, searches only the Omitting this flag, or specifying `--repositories=primary`, searches only the
main repositories: brew,core,cask. Specifying `--repositories=all`, searches main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all`
all repositories. searches all repositories.
`--from` `--from`
: Date (ISO-8601 format) to start searching contributions. Omitting this flag : Date (ISO 8601 format) to start searching contributions. Omitting this flag
searches the last year. searches the past year.
`--to` `--to`
: Date (ISO-8601 format) to stop searching contributions. : Date (ISO 8601 format) to stop searching contributions.
`--user`
: Specify a comma-separated list of GitHub usernames or email addresses to find
contributions from. Omitting this flag searches maintainers.
`--csv` `--csv`
@ -2626,31 +2627,31 @@ Query Homebrew's analytics.
`--install` `--install`
: Output the number of specifically requested installations or installation as : Output the number of specifically requested installations or installation as
dependencies of the formula. This is the default. dependencies of formulae. This is the default.
`--install-on-request`
: Output the number of specifically requested installations of formulae.
`--cask-install` `--cask-install`
: Output the number of installations of casks. : Output the number of installations of casks.
`--install-on-request`
: Output the number of specifically requested installations of the formula.
`--build-error` `--build-error`
: Output the number of build errors for the formulae. : Output the number of build errors for formulae.
`--os-version` `--os-version`
: Output OS versions. : Output the number of events by OS name and version.
`--homebrew-devcmdrun-developer` `--homebrew-devcmdrun-developer`
: Output devcmdrun/HOMEBREW\_DEVELOPER. : Output the number of devcmdrun/HOMEBREW\_DEVELOPER events.
`--homebrew-os-arch-ci` `--homebrew-os-arch-ci`
: Output OS/Architecture/CI. : Output the number of OS/Architecture/CI events.
`--homebrew-prefixes` `--homebrew-prefixes`
@ -2687,9 +2688,8 @@ Query Homebrew's analytics.
### `generate-analytics-api` ### `generate-analytics-api`
Generates analytics API data files for formulae.brew.sh. Generates analytics API data files for <https://formulae.brew.sh>. The generated
files are written to the current directory.
The generated files are written to the current directory.
### `generate-cask-api` \[`--dry-run`\] ### `generate-cask-api` \[`--dry-run`\]
@ -2790,7 +2790,8 @@ from `$HOMEBREW_LIVECHECK_WATCHLIST` or `~/.homebrew/livecheck_watchlist.txt`.
`--newer-only` `--newer-only`
: Show the latest version only if it's newer than the formula/cask. : Show the latest version only if it's newer than the current formula or cask
version.
`--json` `--json`
@ -3427,12 +3428,12 @@ Note that this command depends on the GitHub CLI. Run `brew install gh`.
`--os` `--os`
: Download for the given operating system.(Pass `all` to download for all : Download for the given operating system. (Pass `all` to download for all
operating systems.) operating systems.)
`--arch` `--arch`
: Download for the given CPU architecture.(Pass `all` to download for all : Download for the given CPU architecture. (Pass `all` to download for all
architectures.) architectures.)
`--bottle-tag` `--bottle-tag`
@ -3833,8 +3834,8 @@ User-specific environment files take precedence over prefix-specific files and
prefix-specific files take precedence over system-wide files (unless prefix-specific files take precedence over system-wide files (unless
`$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY` is set, see below). `$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY` is set, see below).
Note that these files do not support shell variable expansion e.g. `$HOME` or Note that these files do not support shell variable expansion (e.g. `$HOME`) or
command execution e.g. `$(cat file)`. command execution (e.g. `$(cat file)`).
`HOMEBREW_ALLOWED_TAPS` `HOMEBREW_ALLOWED_TAPS`
@ -3884,13 +3885,13 @@ command execution e.g. `$(cat file)`.
`HOMEBREW_ASK` `HOMEBREW_ASK`
: If set, pass `--ask`to all formulae `brew install`, `brew upgrade` and `brew : If set, pass `--ask` to all formulae `brew install`, `brew upgrade` and `brew
reinstall` commands. reinstall` commands.
`HOMEBREW_AUTO_UPDATE_SECS` `HOMEBREW_AUTO_UPDATE_SECS`
: Run `brew update` once every `$HOMEBREW_AUTO_UPDATE_SECS` seconds before some : Run `brew update` once every `$HOMEBREW_AUTO_UPDATE_SECS` seconds before some
commands, e.g. `brew install`, `brew upgrade` and `brew tap`. Alternatively, commands, e.g. `brew install`, `brew upgrade` or `brew tap`. Alternatively,
disable auto-update entirely with `$HOMEBREW_NO_AUTO_UPDATE`. disable auto-update entirely with `$HOMEBREW_NO_AUTO_UPDATE`.
*Default:* `86400` (24 hours), `3600` (1 hour) if a developer command has been *Default:* `86400` (24 hours), `3600` (1 hour) if a developer command has been
@ -4158,21 +4159,21 @@ command execution e.g. `$(cat file)`.
: If set, controls network access to the sandbox for formulae builds. Overrides : If set, controls network access to the sandbox for formulae builds. Overrides
any controls set through DSL usage inside formulae. Must be `allow` or `deny`. any controls set through DSL usage inside formulae. Must be `allow` or `deny`.
If no value is set through this environment variable or DSL usage, the default If no value is set through this environment variable or DSL usage, the default
behavior is `allow`. behaviour is `allow`.
`HOMEBREW_FORMULA_POSTINSTALL_NETWORK` `HOMEBREW_FORMULA_POSTINSTALL_NETWORK`
: If set, controls network access to the sandbox for formulae postinstall. : If set, controls network access to the sandbox for formulae postinstall.
Overrides any controls set through DSL usage inside formulae. Must be `allow` Overrides any controls set through DSL usage inside formulae. Must be `allow`
or `deny`. If no value is set through this environment variable or DSL usage, or `deny`. If no value is set through this environment variable or DSL usage,
the default behavior is `allow`. the default behaviour is `allow`.
`HOMEBREW_FORMULA_TEST_NETWORK` `HOMEBREW_FORMULA_TEST_NETWORK`
: If set, controls network access to the sandbox for formulae test. Overrides : If set, controls network access to the sandbox for formulae test. Overrides
any controls set through DSL usage inside formulae. Must be `allow` or `deny`. any controls set through DSL usage inside formulae. Must be `allow` or `deny`.
If no value is set through this environment variable or DSL usage, the default If no value is set through this environment variable or DSL usage, the default
behavior is `allow`. behaviour is `allow`.
`HOMEBREW_GITHUB_API_TOKEN` `HOMEBREW_GITHUB_API_TOKEN`
@ -4270,7 +4271,7 @@ command execution e.g. `$(cat file)`.
`HOMEBREW_NO_AUTO_UPDATE` `HOMEBREW_NO_AUTO_UPDATE`
: If set, do not automatically update before running some commands, e.g. `brew : If set, do not automatically update before running some commands, e.g. `brew
install`, `brew upgrade` and `brew tap`. Preferably, run this less often by install`, `brew upgrade` or `brew tap`. Preferably, run this less often by
setting `$HOMEBREW_AUTO_UPDATE_SECS` to a value higher than the default. Note setting `$HOMEBREW_AUTO_UPDATE_SECS` to a value higher than the default. Note
that setting this and e.g. tapping new taps may result in a broken that setting this and e.g. tapping new taps may result in a broken
configuration. Please ensure you always run `brew update` before reporting any configuration. Please ensure you always run `brew update` before reporting any
@ -4314,8 +4315,8 @@ command execution e.g. `$(cat file)`.
: If set, forbid redirects from secure HTTPS to insecure HTTP. : If set, forbid redirects from secure HTTPS to insecure HTTP.
*Note:* while ensuring your downloads are fully secure, this is likely to *Note:* while ensuring your downloads are fully secure, this is likely to
cause from-source SourceForge, some GNU & GNOME-hosted formulae to fail to cause sources for certain formulae hosted by SourceForge, GNU or GNOME to fail
download. to download.
`HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK` `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK`

70
manpages/brew.1
View File

@ -14,7 +14,7 @@ Homebrew is the easiest and most flexible way to install the UNIX tools Apple di
Homebrew package definition that builds from upstream sources Homebrew package definition that builds from upstream sources
.TP .TP
\fBcask\fP \fBcask\fP
Homebrew package definition that installs macOS native applications Homebrew package definition that installs native applications directly from upstream
.TP .TP
\fBprefix\fP \fBprefix\fP
path in which Homebrew is installed, e\.g\. \fB/opt/homebrew\fP or \fB/home/linuxbrew/\.linuxbrew\fP path in which Homebrew is installed, e\.g\. \fB/opt/homebrew\fP or \fB/home/linuxbrew/\.linuxbrew\fP
@ -124,15 +124,15 @@ Add entries to your \fBBrewfile\fP\&\. Adds formulae by default\. Use \fB\-\-cas
\fBbrew bundle remove\fP \fIname\fP [\.\.\.] \fBbrew bundle remove\fP \fIname\fP [\.\.\.]
Remove entries that match \fBname\fP from your \fBBrewfile\fP\&\. Use \fB\-\-formula\fP, \fB\-\-cask\fP, \fB\-\-tap\fP, \fB\-\-mas\fP, \fB\-\-whalebrew\fP or \fB\-\-vscode\fP to remove only entries of the corresponding type\. Passing \fB\-\-formula\fP also removes matches against formula aliases and old formula names\. Remove entries that match \fBname\fP from your \fBBrewfile\fP\&\. Use \fB\-\-formula\fP, \fB\-\-cask\fP, \fB\-\-tap\fP, \fB\-\-mas\fP, \fB\-\-whalebrew\fP or \fB\-\-vscode\fP to remove only entries of the corresponding type\. Passing \fB\-\-formula\fP also removes matches against formula aliases and old formula names\.
.TP .TP
\fBbrew bundle exec\fP [\-\-check] \fIcommand\fP \fBbrew bundle exec\fP [\fB\-\-check\fP] \fIcommand\fP
Run an external command in an isolated build environment based on the \fBBrewfile\fP dependencies\. Run an external command in an isolated build environment based on the \fBBrewfile\fP dependencies\.
.P .P
This sanitized build environment ignores unrequested dependencies, which makes sure that things you didn\[u2019]t specify in your \fBBrewfile\fP won\[u2019]t get picked up by commands like \fBbundle install\fP, \fBnpm install\fP, etc\. It will also add compiler flags which will help with finding keg\-only dependencies like \fBopenssl\fP, \fBicu4c\fP, etc\. This sanitized build environment ignores unrequested dependencies, which makes sure that things you didn\[u2019]t specify in your \fBBrewfile\fP won\[u2019]t get picked up by commands like \fBbundle install\fP, \fBnpm install\fP, etc\. It will also add compiler flags which will help with finding keg\-only dependencies like \fBopenssl\fP, \fBicu4c\fP, etc\.
.TP .TP
\fBbrew bundle sh\fP [\-\-check] \fBbrew bundle sh\fP [\fB\-\-check\fP]
Run your shell in a \fBbrew bundle exec\fP environment\. Run your shell in a \fBbrew bundle exec\fP environment\.
.TP .TP
\fBbrew bundle env\fP [\-\-check] \fBbrew bundle env\fP [\fB\-\-check\fP]
Print the environment variables that would be set in a \fBbrew bundle exec\fP environment\. Print the environment variables that would be set in a \fBbrew bundle exec\fP environment\.
.TP .TP
\fB\-\-file\fP \fB\-\-file\fP
@ -154,7 +154,7 @@ Read from or write to the \fBBrewfile\fP from \fB$HOMEBREW_BUNDLE_FILE_GLOBAL\fP
\fBinstall\fP runs \fBbrew upgrade\fP on any of these comma\-separated formulae, even if \fB$HOMEBREW_BUNDLE_NO_UPGRADE\fP is set\. \fBinstall\fP runs \fBbrew upgrade\fP on any of these comma\-separated formulae, even if \fB$HOMEBREW_BUNDLE_NO_UPGRADE\fP is set\.
.TP .TP
\fB\-\-install\fP \fB\-\-install\fP
Run \fBinstall\fP before continuing to other operations e\.g\. \fBexec\fP\&\. Run \fBinstall\fP before continuing to other operations, e\.g\. \fBexec\fP\&\.
.TP .TP
\fB\-\-services\fP \fB\-\-services\fP
Temporarily start services while running the \fBexec\fP or \fBsh\fP command\. Enabled by default if \fB$HOMEBREW_BUNDLE_SERVICES\fP is set\. Temporarily start services while running the \fBexec\fP or \fBsh\fP command\. Enabled by default if \fB$HOMEBREW_BUNDLE_SERVICES\fP is set\.
@ -629,7 +629,7 @@ Force output to be one entry per line\. This is the default when output is not t
List formulae and/or casks in long format\. Has no effect when a formula or cask name is passed as an argument\. List formulae and/or casks in long format\. Has no effect when a formula or cask name is passed as an argument\.
.TP .TP
\fB\-r\fP \fB\-r\fP
Reverse the order of the formulae and/or casks sort to list the oldest entries first\. Has no effect when a formula or cask name is passed as an argument\. Reverse the order of formula and/or cask sorting to list the oldest entries first\. Has no effect when a formula or cask name is passed as an argument\.
.TP .TP
\fB\-t\fP \fB\-t\fP
Sort formulae and/or casks by time modified, listing most recently modified first\. Has no effect when a formula or cask name is passed as an argument\. Sort formulae and/or casks by time modified, listing most recently modified first\. Has no effect when a formula or cask name is passed as an argument\.
@ -1502,20 +1502,20 @@ Treat all named arguments as formulae\.
.TP .TP
\fB\-\-cask\fP \fB\-\-cask\fP
Treat all named arguments as casks\. Treat all named arguments as casks\.
.SS "\fBcontributions\fP \fR[\-\-user=\fIemail|username\fP] \fR[\fI\-\-repositories\fP\fB=\fP] \fR[\fI\-\-csv\fP]" .SS "\fBcontributions\fP \fR[\fB\-\-user=\fP] \fR[\fB\-\-repositories=\fP] \fR[\fB\-\-from=\fP] \fR[\fB\-\-to=\fP] \fR[\fB\-\-csv\fP]"
Summarise contributions to Homebrew repositories\. Summarise contributions to Homebrew repositories\.
.TP .TP
\fB\-\-user\fP
Specify a comma\-separated list of GitHub usernames or email addresses to find contributions from\. Omitting this flag searches Homebrew maintainers\.
.TP
\fB\-\-repositories\fP \fB\-\-repositories\fP
Specify a comma\-separated list of repositories to search\. Supported repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP, \fBcommand\-not\-found\fP and \fBtest\-bot\fP\&\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: brew,core,cask\. Specifying \fB\-\-repositories=all\fP, searches all repositories\. Specify a comma\-separated list of repositories to search\. Supported repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP, \fBcommand\-not\-found\fP and \fBtest\-bot\fP\&\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP\&\. Specifying \fB\-\-repositories=all\fP searches all repositories\.
.TP .TP
\fB\-\-from\fP \fB\-\-from\fP
Date (ISO\-8601 format) to start searching contributions\. Omitting this flag searches the last year\. Date (ISO 8601 format) to start searching contributions\. Omitting this flag searches the past year\.
.TP .TP
\fB\-\-to\fP \fB\-\-to\fP
Date (ISO\-8601 format) to stop searching contributions\. Date (ISO 8601 format) to stop searching contributions\.
.TP
\fB\-\-user\fP
Specify a comma\-separated list of GitHub usernames or email addresses to find contributions from\. Omitting this flag searches maintainers\.
.TP .TP
\fB\-\-csv\fP \fB\-\-csv\fP
Print a CSV of contributions across repositories over the time period\. Print a CSV of contributions across repositories over the time period\.
@ -1653,25 +1653,25 @@ Query Homebrew\[u2019]s analytics\.
Query from the specified days ago until the present\. The default is 30 days\. Query from the specified days ago until the present\. The default is 30 days\.
.TP .TP
\fB\-\-install\fP \fB\-\-install\fP
Output the number of specifically requested installations or installation as dependencies of the formula\. This is the default\. Output the number of specifically requested installations or installation as dependencies of formulae\. This is the default\.
.TP
\fB\-\-install\-on\-request\fP
Output the number of specifically requested installations of formulae\.
.TP .TP
\fB\-\-cask\-install\fP \fB\-\-cask\-install\fP
Output the number of installations of casks\. Output the number of installations of casks\.
.TP .TP
\fB\-\-install\-on\-request\fP
Output the number of specifically requested installations of the formula\.
.TP
\fB\-\-build\-error\fP \fB\-\-build\-error\fP
Output the number of build errors for the formulae\. Output the number of build errors for formulae\.
.TP .TP
\fB\-\-os\-version\fP \fB\-\-os\-version\fP
Output OS versions\. Output the number of events by OS name and version\.
.TP .TP
\fB\-\-homebrew\-devcmdrun\-developer\fP \fB\-\-homebrew\-devcmdrun\-developer\fP
Output devcmdrun/HOMEBREW_DEVELOPER\. Output the number of devcmdrun/HOMEBREW_DEVELOPER events\.
.TP .TP
\fB\-\-homebrew\-os\-arch\-ci\fP \fB\-\-homebrew\-os\-arch\-ci\fP
Output OS/Architecture/CI\. Output the number of OS/Architecture/CI events\.
.TP .TP
\fB\-\-homebrew\-prefixes\fP \fB\-\-homebrew\-prefixes\fP
Output Homebrew prefixes\. Output Homebrew prefixes\.
@ -1697,9 +1697,9 @@ Output a different JSON format containing the JSON data for all Homebrew/homebre
\fB\-\-setup\fP \fB\-\-setup\fP
Install the necessary gems, require them and exit without running a query\. Install the necessary gems, require them and exit without running a query\.
.SS "\fBgenerate\-analytics\-api\fP" .SS "\fBgenerate\-analytics\-api\fP"
Generates analytics API data files for formulae\.brew\.sh\. Generates analytics API data files for
.P .UR https://formulae\.brew\.sh
The generated files are written to the current directory\. .UE \&\. The generated files are written to the current directory\.
.SS "\fBgenerate\-cask\-api\fP \fR[\fB\-\-dry\-run\fP]" .SS "\fBgenerate\-cask\-api\fP \fR[\fB\-\-dry\-run\fP]"
Generate \fBhomebrew/cask\fP API data files for Generate \fBhomebrew/cask\fP API data files for
.UR https://formulae\.brew\.sh .UR https://formulae\.brew\.sh
@ -1762,7 +1762,7 @@ Evaluate all available formulae and casks, whether installed or not, to check th
Check formulae and casks that are currently installed\. Check formulae and casks that are currently installed\.
.TP .TP
\fB\-\-newer\-only\fP \fB\-\-newer\-only\fP
Show the latest version only if it\[u2019]s newer than the formula/cask\. Show the latest version only if it\[u2019]s newer than the current formula or cask version\.
.TP .TP
\fB\-\-json\fP \fB\-\-json\fP
Output information in JSON format\. Output information in JSON format\.
@ -2181,10 +2181,10 @@ Verify the build provenance of bottles using GitHub\[u2019]s attestation tools\.
Note that this command depends on the GitHub CLI\. Run \fBbrew install gh\fP\&\. Note that this command depends on the GitHub CLI\. Run \fBbrew install gh\fP\&\.
.TP .TP
\fB\-\-os\fP \fB\-\-os\fP
Download for the given operating system\.(Pass \fBall\fP to download for all operating systems\.) Download for the given operating system\. (Pass \fBall\fP to download for all operating systems\.)
.TP .TP
\fB\-\-arch\fP \fB\-\-arch\fP
Download for the given CPU architecture\.(Pass \fBall\fP to download for all architectures\.) Download for the given CPU architecture\. (Pass \fBall\fP to download for all architectures\.)
.TP .TP
\fB\-\-bottle\-tag\fP \fB\-\-bottle\-tag\fP
Download a bottle for given tag\. Download a bottle for given tag\.
@ -2448,7 +2448,7 @@ Note that environment variables must have a value set to be detected\. For examp
.P .P
User\-specific environment files take precedence over prefix\-specific files and prefix\-specific files take precedence over system\-wide files (unless \fB$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY\fP is set, see below)\. User\-specific environment files take precedence over prefix\-specific files and prefix\-specific files take precedence over system\-wide files (unless \fB$HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY\fP is set, see below)\.
.P .P
Note that these files do not support shell variable expansion e\.g\. \fB$HOME\fP or command execution e\.g\. \fB$(cat file)\fP\&\. Note that these files do not support shell variable expansion (e\.g\. \fB$HOME\fP) or command execution (e\.g\. \fB$(cat file)\fP)\.
.TP .TP
\fBHOMEBREW_ALLOWED_TAPS\fP \fBHOMEBREW_ALLOWED_TAPS\fP
A space\-separated list of taps\. Homebrew will refuse to install a formula unless it and all of its dependencies are in an official tap or in a tap on this list\. A space\-separated list of taps\. Homebrew will refuse to install a formula unless it and all of its dependencies are in an official tap or in a tap on this list\.
@ -2481,10 +2481,10 @@ Prefix all download URLs, including those for bottles, with this value\. For exa
When \fB$HOMEBREW_ARTIFACT_DOMAIN\fP and \fB$HOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK\fP are both set, if the request to \fB$HOMEBREW_ARTIFACT_DOMAIN\fP fails then Homebrew will error rather than trying any other/default URLs\. When \fB$HOMEBREW_ARTIFACT_DOMAIN\fP and \fB$HOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK\fP are both set, if the request to \fB$HOMEBREW_ARTIFACT_DOMAIN\fP fails then Homebrew will error rather than trying any other/default URLs\.
.TP .TP
\fBHOMEBREW_ASK\fP \fBHOMEBREW_ASK\fP
If set, pass \fB\-\-ask\fPto all formulae \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew reinstall\fP commands\. If set, pass \fB\-\-ask\fP to all formulae \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew reinstall\fP commands\.
.TP .TP
\fBHOMEBREW_AUTO_UPDATE_SECS\fP \fBHOMEBREW_AUTO_UPDATE_SECS\fP
Run \fBbrew update\fP once every \fB$HOMEBREW_AUTO_UPDATE_SECS\fP seconds before some commands, e\.g\. \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew tap\fP\&\. Alternatively, disable auto\-update entirely with \fB$HOMEBREW_NO_AUTO_UPDATE\fP\&\. Run \fBbrew update\fP once every \fB$HOMEBREW_AUTO_UPDATE_SECS\fP seconds before some commands, e\.g\. \fBbrew install\fP, \fBbrew upgrade\fP or \fBbrew tap\fP\&\. Alternatively, disable auto\-update entirely with \fB$HOMEBREW_NO_AUTO_UPDATE\fP\&\.
.RS .RS
.P .P
\fIDefault:\fP \fB86400\fP (24 hours), \fB3600\fP (1 hour) if a developer command has been run or \fB300\fP (5 minutes) if \fB$HOMEBREW_NO_INSTALL_FROM_API\fP is set\. \fIDefault:\fP \fB86400\fP (24 hours), \fB3600\fP (1 hour) if a developer command has been run or \fB300\fP (5 minutes) if \fB$HOMEBREW_NO_INSTALL_FROM_API\fP is set\.
@ -2696,13 +2696,13 @@ If set, require \fB$HOMEBREW_BREW_WRAPPER\fP to be set to the same value as \fB$
If set, always use Homebrew\[u2019]s vendored, relocatable Ruby version even if the system version of Ruby is new enough\. If set, always use Homebrew\[u2019]s vendored, relocatable Ruby version even if the system version of Ruby is new enough\.
.TP .TP
\fBHOMEBREW_FORMULA_BUILD_NETWORK\fP \fBHOMEBREW_FORMULA_BUILD_NETWORK\fP
If set, controls network access to the sandbox for formulae builds\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behavior is \fBallow\fP\&\. If set, controls network access to the sandbox for formulae builds\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behaviour is \fBallow\fP\&\.
.TP .TP
\fBHOMEBREW_FORMULA_POSTINSTALL_NETWORK\fP \fBHOMEBREW_FORMULA_POSTINSTALL_NETWORK\fP
If set, controls network access to the sandbox for formulae postinstall\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behavior is \fBallow\fP\&\. If set, controls network access to the sandbox for formulae postinstall\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behaviour is \fBallow\fP\&\.
.TP .TP
\fBHOMEBREW_FORMULA_TEST_NETWORK\fP \fBHOMEBREW_FORMULA_TEST_NETWORK\fP
If set, controls network access to the sandbox for formulae test\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behavior is \fBallow\fP\&\. If set, controls network access to the sandbox for formulae test\. Overrides any controls set through DSL usage inside formulae\. Must be \fBallow\fP or \fBdeny\fP\&\. If no value is set through this environment variable or DSL usage, the default behaviour is \fBallow\fP\&\.
.TP .TP
\fBHOMEBREW_GITHUB_API_TOKEN\fP \fBHOMEBREW_GITHUB_API_TOKEN\fP
Use this personal access token for the GitHub API, for features such as \fBbrew search\fP\&\. You can create one at Use this personal access token for the GitHub API, for features such as \fBbrew search\fP\&\. You can create one at
@ -2783,7 +2783,7 @@ If set, do not send analytics\. Google Analytics were destroyed\. For more infor
If set, calls to \fBbrew cleanup\fP and \fBbrew uninstall\fP will not automatically remove unused formula dependents\. If set, calls to \fBbrew cleanup\fP and \fBbrew uninstall\fP will not automatically remove unused formula dependents\.
.TP .TP
\fBHOMEBREW_NO_AUTO_UPDATE\fP \fBHOMEBREW_NO_AUTO_UPDATE\fP
If set, do not automatically update before running some commands, e\.g\. \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew tap\fP\&\. Preferably, run this less often by setting \fB$HOMEBREW_AUTO_UPDATE_SECS\fP to a value higher than the default\. Note that setting this and e\.g\. tapping new taps may result in a broken configuration\. Please ensure you always run \fBbrew update\fP before reporting any issues\. If set, do not automatically update before running some commands, e\.g\. \fBbrew install\fP, \fBbrew upgrade\fP or \fBbrew tap\fP\&\. Preferably, run this less often by setting \fB$HOMEBREW_AUTO_UPDATE_SECS\fP to a value higher than the default\. Note that setting this and e\.g\. tapping new taps may result in a broken configuration\. Please ensure you always run \fBbrew update\fP before reporting any issues\.
.TP .TP
\fBHOMEBREW_NO_BOOTSNAP\fP \fBHOMEBREW_NO_BOOTSNAP\fP
If set, do not use Bootsnap to speed up repeated \fBbrew\fP calls\. If set, do not use Bootsnap to speed up repeated \fBbrew\fP calls\.
@ -2814,7 +2814,7 @@ If set, do not use the GitHub API, e\.g\. for searches or fetching relevant issu
If set, forbid redirects from secure HTTPS to insecure HTTP\. If set, forbid redirects from secure HTTPS to insecure HTTP\.
.RS .RS
.P .P
\fINote:\fP while ensuring your downloads are fully secure, this is likely to cause from\-source SourceForge, some GNU & GNOME\-hosted formulae to fail to download\. \fINote:\fP while ensuring your downloads are fully secure, this is likely to cause sources for certain formulae hosted by SourceForge, GNU or GNOME to fail to download\.
.RE .RE
.TP .TP
\fBHOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK\fP \fBHOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK\fP