diff --git a/Library/Homebrew/cmd/--cache.rb b/Library/Homebrew/cmd/--cache.rb
index 78e6df0fa554b6fac4929e677e2d98b4abf70972..d21f3bd8cd81c5d6761ec2876898219530e8bf26 100644
--- a/Library/Homebrew/cmd/--cache.rb
+++ b/Library/Homebrew/cmd/--cache.rb
@@ -16,7 +16,7 @@ module Homebrew
def __cache_args
Homebrew::CLI::Parser.new do
usage_banner <<~EOS
- `--cache` [<options>] [<formula|cask>]
+ `--cache` [<options>] [<formula>|<cask>]
Display Homebrew's download cache. See also `HOMEBREW_CACHE`.
diff --git a/Library/Homebrew/cmd/--version.rb b/Library/Homebrew/cmd/--version.rb
index 531b0b119c83db9e49742200715ad0ef861d1ab8..ff038f70960c0ece92fe64a5cb3d8adcee5602f8 100644
--- a/Library/Homebrew/cmd/--version.rb
+++ b/Library/Homebrew/cmd/--version.rb
@@ -17,6 +17,7 @@ module Homebrew
Print the version numbers of Homebrew, Homebrew/homebrew-core and Homebrew/homebrew-cask
(if tapped) to standard output.
EOS
+
max_named 0
end
end
diff --git a/Library/Homebrew/cmd/analytics.rb b/Library/Homebrew/cmd/analytics.rb
index 12e545f3525591cd5bf9f6d3a506ec41e80ccbcf..0efdf6afe1643b6df6504c17f0a99cc642648be2 100644
--- a/Library/Homebrew/cmd/analytics.rb
+++ b/Library/Homebrew/cmd/analytics.rb
@@ -20,12 +20,13 @@ module Homebrew
`brew analytics` [`state`]:
Display the current state of Homebrew's analytics.
- `brew analytics` [`on`|`off`]:
+ `brew analytics` (`on`|`off`):
Turn Homebrew's analytics on or off respectively.
`brew analytics regenerate-uuid`:
Regenerate the UUID used for Homebrew's analytics.
EOS
+
max_named 1
end
end
diff --git a/Library/Homebrew/cmd/autoremove.rb b/Library/Homebrew/cmd/autoremove.rb
index fd5c786f5b308add2002279fdb82cd06a660f4b8..21c211cfeab445f26b5acec21ad7ec5868a616d0 100644
--- a/Library/Homebrew/cmd/autoremove.rb
+++ b/Library/Homebrew/cmd/autoremove.rb
@@ -17,7 +17,8 @@ module Homebrew
EOS
switch "-n", "--dry-run",
description: "List what would be uninstalled, but do not actually uninstall anything."
- named 0
+
+ max_named 0
end
end
diff --git a/Library/Homebrew/cmd/install.rb b/Library/Homebrew/cmd/install.rb
index 436f607172e7347d5a44b2cba09b43c6ccdb7e7f..9728aba9b978485487a1df03b1ea1dadbcf41b8d 100644
--- a/Library/Homebrew/cmd/install.rb
+++ b/Library/Homebrew/cmd/install.rb
@@ -85,7 +85,6 @@ module Homebrew
}],
[:switch, "--keep-tmp", {
description: "Retain the temporary files created during installation.",
-
}],
[:switch, "--build-bottle", {
description: "Prepare the formula for eventual bottling during installation, skipping any " \
@@ -125,7 +124,6 @@ module Homebrew
conflicts "--ignore-dependencies", "--only-dependencies"
conflicts "--build-from-source", "--build-bottle", "--force-bottle"
-
min_named :formula_or_cask
end
end
diff --git a/Library/Homebrew/cmd/list.rb b/Library/Homebrew/cmd/list.rb
index 13dc067728d32ffc1e35863b555c1dd4002665cd..e7e5a97536e6b1dda50f7346f9d323bdc7c7c319 100644
--- a/Library/Homebrew/cmd/list.rb
+++ b/Library/Homebrew/cmd/list.rb
@@ -15,7 +15,7 @@ module Homebrew
def list_args
Homebrew::CLI::Parser.new do
usage_banner <<~EOS
- `list`, `ls` [<options>] [<formula|cask>]
+ `list`, `ls` [<options>] [<formula>|<cask>]
List all installed formulae and casks.
diff --git a/Library/Homebrew/cmd/log.rb b/Library/Homebrew/cmd/log.rb
index 5a24d9d1beec667635443f7bbd7d918d12ce3942..391d213f52038abfad209222c24823a37863a8ed 100644
--- a/Library/Homebrew/cmd/log.rb
+++ b/Library/Homebrew/cmd/log.rb
@@ -28,8 +28,9 @@ module Homebrew
description: "Print only one commit."
flag "-n", "--max-count=",
description: "Print only a specified number of commits."
- max_named 1
+
conflicts "-1", "--max-count"
+ max_named 1
end
end
diff --git a/Library/Homebrew/cmd/reinstall.rb b/Library/Homebrew/cmd/reinstall.rb
index 4bc7a230c27a3ba970a88345772beaf22fc81af2..ab69edd5d3206cebfcab4bb75218b23765ff70c3 100644
--- a/Library/Homebrew/cmd/reinstall.rb
+++ b/Library/Homebrew/cmd/reinstall.rb
@@ -45,8 +45,8 @@ module Homebrew
}],
[:switch, "-i", "--interactive", {
description: "Download and patch <formula>, then open a shell. This allows the user to " \
- "run `./configure --help` and otherwise determine how to turn the software " \
- "package into a Homebrew package.",
+ "run `./configure --help` and otherwise determine how to turn the software " \
+ "package into a Homebrew package.",
}],
[:switch, "--force-bottle", {
description: "Install from a bottle if it exists for the current or newest version of " \
@@ -75,7 +75,6 @@ module Homebrew
cask_options
conflicts "--build-from-source", "--force-bottle"
-
min_named :formula_or_cask
end
end
diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb
index ce8ec7bf8a7ef6c39142a6409266766471969e31..24aa0383c4eea547683b4423dee57c26c9f18e9a 100644
--- a/Library/Homebrew/cmd/upgrade.rb
+++ b/Library/Homebrew/cmd/upgrade.rb
@@ -47,8 +47,8 @@ module Homebrew
}],
[:switch, "-i", "--interactive", {
description: "Download and patch <formula>, then open a shell. This allows the user to "\
- "run `./configure --help` and otherwise determine how to turn the software "\
- "package into a Homebrew package.",
+ "run `./configure --help` and otherwise determine how to turn the software "\
+ "package into a Homebrew package.",
}],
[:switch, "--force-bottle", {
description: "Install from a bottle if it exists for the current or newest version of "\
@@ -58,7 +58,6 @@ module Homebrew
description: "Fetch the upstream repository to detect if the HEAD installation of the "\
"formula is outdated. Otherwise, the repository's HEAD will only be checked for "\
"updates when a new stable or development version has been released.",
-
}],
[:switch, "--ignore-pinned", {
description: "Set a successful exit status even if pinned formulae are not upgraded.",
diff --git a/Library/Homebrew/cmd/uses.rb b/Library/Homebrew/cmd/uses.rb
index ae0a28ed5794f67c71d79cf565a71c9c722da0b5..1b0ef16e8c374a81c494d44ec15ef785a769cf6f 100644
--- a/Library/Homebrew/cmd/uses.rb
+++ b/Library/Homebrew/cmd/uses.rb
@@ -40,6 +40,7 @@ module Homebrew
description: "Include all formulae that specify <formula> as `:optional` type dependency."
switch "--skip-recommended",
description: "Skip all formulae that specify <formula> as `:recommended` type dependency."
+
min_named :formula
end
end
diff --git a/Library/Homebrew/dev-cmd/bump-cask-pr.rb b/Library/Homebrew/dev-cmd/bump-cask-pr.rb
index 7d381eab642ed7582aec9a8a1d9a66ddac954421..032a8df0aaa5750eea06deeb980886d55331b8b9 100644
--- a/Library/Homebrew/dev-cmd/bump-cask-pr.rb
+++ b/Library/Homebrew/dev-cmd/bump-cask-pr.rb
@@ -14,7 +14,7 @@ module Homebrew
def bump_cask_pr_args
Homebrew::CLI::Parser.new do
usage_banner <<~EOS
- `bump-cask-pr` [<options>] [<cask>]
+ `bump-cask-pr` [<options>] <cask>
Create a pull request to update <cask> with a new version.
diff --git a/Library/Homebrew/dev-cmd/bump-formula-pr.rb b/Library/Homebrew/dev-cmd/bump-formula-pr.rb
index b3f6550f3b0f9664fe3c1436a6ad631b6663d242..4e648874f28ad50e278f91dacb2567d1527b2033 100644
--- a/Library/Homebrew/dev-cmd/bump-formula-pr.rb
+++ b/Library/Homebrew/dev-cmd/bump-formula-pr.rb
@@ -73,7 +73,7 @@ module Homebrew
depends_on: "--tag=",
description: "Specify the new git commit <revision> corresponding to the specified <tag>."
switch "-f", "--force",
- description: "Ignore duplicate open PRs. Remove all mirrors if --mirror= was not specified."
+ description: "Ignore duplicate open PRs. Remove all mirrors if `--mirror` was not specified."
conflicts "--dry-run", "--write"
conflicts "--no-audit", "--strict"
diff --git a/Library/Homebrew/dev-cmd/bump.rb b/Library/Homebrew/dev-cmd/bump.rb
index e5a9695b8f2ac761ac4beb8b60c0980b4f69fb69..00f51e8870744f22851f78f2f3e5ed4d785b1c84 100644
--- a/Library/Homebrew/dev-cmd/bump.rb
+++ b/Library/Homebrew/dev-cmd/bump.rb
@@ -17,8 +17,8 @@ module Homebrew
Display out-of-date brew formulae and the latest version available.
Also displays whether a pull request has been opened with the URL.
EOS
- flag "--limit=",
- description: "Limit number of package results returned."
+ flag "--limit=",
+ description: "Limit number of package results returned."
switch :verbose
switch :debug
end
diff --git a/Library/Homebrew/dev-cmd/cat.rb b/Library/Homebrew/dev-cmd/cat.rb
index a0410216fe6b72a8cf11b3889d6dd8e5d1490a47..625ee66779d668a3a8d42b887a4bc0a0ce29ffc6 100644
--- a/Library/Homebrew/dev-cmd/cat.rb
+++ b/Library/Homebrew/dev-cmd/cat.rb
@@ -16,6 +16,7 @@ module Homebrew
Display the source of <formula>.
EOS
+
named :formula
end
end
diff --git a/Library/Homebrew/dev-cmd/dispatch-build-bottle.rb b/Library/Homebrew/dev-cmd/dispatch-build-bottle.rb
index 4353beeb77b24ca95c4e2a1fa0399252e8607847..fbb867e8aef0d40f76a769fe398882f8cc1f9fcc 100644
--- a/Library/Homebrew/dev-cmd/dispatch-build-bottle.rb
+++ b/Library/Homebrew/dev-cmd/dispatch-build-bottle.rb
@@ -27,14 +27,14 @@ module Homebrew
description: "Dispatch specified workflow (default: `dispatch-build-bottle.yml`)."
switch "--upload",
description: "Upload built bottles to Bintray."
+
+ min_named :formula
end
end
def dispatch_build_bottle
args = dispatch_build_bottle_args.parse
- raise FormulaUnspecifiedError if args.named.empty?
-
odie "Must specify --macos option" unless args.macos
macos = begin
diff --git a/Library/Homebrew/dev-cmd/man.rb b/Library/Homebrew/dev-cmd/man.rb
index 24fe0e0ff7c5607f7cfde0a752bffad5b6ff5055..e32972af7946339bcea342d8c8981945934217fc 100644
--- a/Library/Homebrew/dev-cmd/man.rb
+++ b/Library/Homebrew/dev-cmd/man.rb
@@ -30,6 +30,7 @@ module Homebrew
"comparison without factoring in the date)."
switch "--link",
description: "This is now done automatically by `brew update`."
+
max_named 0
end
end
@@ -219,7 +220,7 @@ module Homebrew
def global_cask_options_manpage
lines = ["These options are applicable to subcommands accepting a `--cask` flag and all `cask` commands.\n"]
lines += Homebrew::CLI::Parser.global_cask_options.map do |_, long, description:, **|
- generate_option_doc(nil, long, description)
+ generate_option_doc(nil, long.chomp("="), description)
end
lines.join("\n")
end
diff --git a/Library/Homebrew/dev-cmd/mirror.rb b/Library/Homebrew/dev-cmd/mirror.rb
index 70400ee846efbb06ea3af93c1a224792b02d4e69..a6c2b45b1a6a091e0718c72cecdfaf44bc184c95 100644
--- a/Library/Homebrew/dev-cmd/mirror.rb
+++ b/Library/Homebrew/dev-cmd/mirror.rb
@@ -24,8 +24,8 @@ module Homebrew
switch "--no-publish",
description: "Upload to Bintray, but don't publish."
- hide_from_man_page!
min_named :formula
+ hide_from_man_page!
end
end
diff --git a/Library/Homebrew/dev-cmd/pr-automerge.rb b/Library/Homebrew/dev-cmd/pr-automerge.rb
index d23ad3e394605a4f80b3171d56c9efce10fabd1c..d4120ab4f47134ab466bd47f3121253de280be20 100644
--- a/Library/Homebrew/dev-cmd/pr-automerge.rb
+++ b/Library/Homebrew/dev-cmd/pr-automerge.rb
@@ -21,9 +21,9 @@ module Homebrew
description: "Target tap repository (default: `homebrew/core`)."
flag "--with-label=",
description: "Pull requests must have this label."
- comma_array "--without-labels=",
- description: "Pull requests must not have these labels "\
- "(default: `do not merge`, `new formula`, `automerge-skip`)."
+ comma_array "--without-labels",
+ description: "Pull requests must not have these labels (default: "\
+ "`do not merge`, `new formula`, `automerge-skip`, `linux-only`)."
switch "--without-approval",
description: "Pull requests do not require approval to be merged."
switch "--publish",
diff --git a/Library/Homebrew/dev-cmd/pr-pull.rb b/Library/Homebrew/dev-cmd/pr-pull.rb
index 82a6a7f4aed511ea067159f4c5a7dc0d560acd31..5f7e65629e2fc4a927b3a5bafaf9580ad37aa751 100644
--- a/Library/Homebrew/dev-cmd/pr-pull.rb
+++ b/Library/Homebrew/dev-cmd/pr-pull.rb
@@ -62,8 +62,9 @@ module Homebrew
flag "--bintray-mirror=",
description: "Use the specified Bintray repository to automatically mirror stable URLs "\
"defined in the formulae (default: `mirror`)."
- min_named 1
+
conflicts "--clean", "--autosquash"
+ min_named 1
end
end
diff --git a/Library/Homebrew/dev-cmd/pull.rb b/Library/Homebrew/dev-cmd/pull.rb
index 8c1b8b2b5c7ec24c89c7ddcb30af6985bad5bd56..ce6f69c358ed2365933ab850c44d3768e9230bd1 100644
--- a/Library/Homebrew/dev-cmd/pull.rb
+++ b/Library/Homebrew/dev-cmd/pull.rb
@@ -19,7 +19,6 @@ module Homebrew
sig { returns(CLI::Parser) }
def pull_args
Homebrew::CLI::Parser.new do
- hide_from_man_page!
usage_banner <<~EOS
`pull` [<options>] <patch>
@@ -43,6 +42,7 @@ module Homebrew
description: "Do not copy anything to the system clipboard."
min_named 1
+ hide_from_man_page!
end
end
diff --git a/Library/Homebrew/dev-cmd/release-notes.rb b/Library/Homebrew/dev-cmd/release-notes.rb
index bde64f84dea844f380b349ad2fd833e75ef35e96..3e7286cdc46dc9839b2f5e572b281e9bb0b7780d 100644
--- a/Library/Homebrew/dev-cmd/release-notes.rb
+++ b/Library/Homebrew/dev-cmd/release-notes.rb
@@ -20,6 +20,7 @@ module Homebrew
EOS
switch "--markdown",
description: "Print as a Markdown list."
+
max_named 2
end
end
diff --git a/Library/Homebrew/dev-cmd/sh.rb b/Library/Homebrew/dev-cmd/sh.rb
index eb0af7cd84297ff34c1023e6a15b7c699d5b9746..3c56c13dd0d39c8788f1ebfa01fd8719274398a4 100644
--- a/Library/Homebrew/dev-cmd/sh.rb
+++ b/Library/Homebrew/dev-cmd/sh.rb
@@ -26,6 +26,7 @@ module Homebrew
description: "Use the standard `PATH` instead of superenv's when `std` is passed."
flag "-c=", "--cmd=",
description: "Execute commands in a non-interactive shell."
+
max_named 1
end
end
diff --git a/Library/Homebrew/dev-cmd/typecheck.rb b/Library/Homebrew/dev-cmd/typecheck.rb
index 2914b518c6ea3e2e44b1746ef886eaadaf438849..454715b098477a94b425303c577c80166b1c2ac3 100644
--- a/Library/Homebrew/dev-cmd/typecheck.rb
+++ b/Library/Homebrew/dev-cmd/typecheck.rb
@@ -32,6 +32,7 @@ module Homebrew
flag "--ignore=",
description: "Ignores input files that contain the given string " \
"in their paths (relative to the input path passed to Sorbet)."
+
conflicts "--dir", "--file"
max_named 0
end
diff --git a/Library/Homebrew/dev-cmd/update-license-data.rb b/Library/Homebrew/dev-cmd/update-license-data.rb
index bb3220074bba13becf478cf72cbd0e437763614f..c41c6ace7fa1bcf0571ea238105030a48b69bb91 100644
--- a/Library/Homebrew/dev-cmd/update-license-data.rb
+++ b/Library/Homebrew/dev-cmd/update-license-data.rb
@@ -20,6 +20,7 @@ module Homebrew
switch "--fail-if-not-changed",
description: "Return a failing status code if current license data's version is the same as " \
"the upstream. This can be used to notify CI when the SPDX license data is out of date."
+
max_named 0
end
end
diff --git a/Library/Homebrew/dev-cmd/update-python-resources.rb b/Library/Homebrew/dev-cmd/update-python-resources.rb
index e8017c3766fac9d86a9781564491308ec4efb5db..ee3cd4be19ec4db8d7da2d789954e285ff4f5aab 100644
--- a/Library/Homebrew/dev-cmd/update-python-resources.rb
+++ b/Library/Homebrew/dev-cmd/update-python-resources.rb
@@ -23,9 +23,10 @@ module Homebrew
description: "Suppress any output."
switch "--ignore-non-pypi-packages",
description: "Don't fail if <formula> is not a PyPI package."
- flag "--version=",
- description: "Use the specified <version> when finding resources for <formula>. "\
- "If no version is specified, the current version for <formula> will be used."
+ flag "--version=",
+ description: "Use the specified <version> when finding resources for <formula>. "\
+ "If no version is specified, the current version for <formula> will be used."
+
min_named :formula
end
end
diff --git a/Library/Homebrew/env_config.rb b/Library/Homebrew/env_config.rb
index f135217c91972ad530cc14babb206f1f01baffdc..713c460222c0c892218591f8e31ab2ea5084d046 100644
--- a/Library/Homebrew/env_config.rb
+++ b/Library/Homebrew/env_config.rb
@@ -40,10 +40,11 @@ module Homebrew
description: "Use this username when accessing the Bintray API (where bottles are stored).",
},
HOMEBREW_BOTTLE_DOMAIN: {
- description: "Use the specified URL as the download mirror for bottles. " \
- "For example, `HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080` will cause all bottles to " \
- "download from the prefix `http://localhost:8080/`.",
- default_text: "macOS: `https://homebrew.bintray.com/`, Linux: `https://linuxbrew.bintray.com/`.",
+ description: "Use this URL as the download mirror for bottles. " \
+ "For example, `HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080` will cause all bottles to " \
+ "download from the prefix `http://localhost:8080/`.",
+ default_text: "macOS: `https://homebrew.bintray.com/`, " \
+ "Linux: `https://linuxbrew.bintray.com/`.",
default: HOMEBREW_BOTTLE_DEFAULT_DOMAIN,
},
HOMEBREW_BREW_GIT_REMOTE: {
@@ -62,11 +63,10 @@ module Homebrew
},
HOMEBREW_CASK_OPTS: {
description: "Append these options to all `cask` commands. All `--*dir` options, " \
- "`--language`, `--require-sha`, `--no-quarantine` and `--no-binaries` are supported." \
- "\n" \
+ "`--language`, `--require-sha`, `--no-quarantine` and `--no-binaries` are supported. " \
"For example, you might add something like the following to your " \
- "~/.profile, ~/.bash_profile, or ~/.zshenv:\n\n" \
- "`export HOMEBREW_CASK_OPTS='--appdir=~/Applications --fontdir=/Library/Fonts'`",
+ "`~/.profile`, `~/.bash_profile`, or `~/.zshenv`:\n\n" \
+ ' `export HOMEBREW_CASK_OPTS="--appdir=~/Applications --fontdir=/Library/Fonts"`',
},
HOMEBREW_CLEANUP_MAX_AGE_DAYS: {
description: "Cleanup all cached files older than this many days.",
@@ -107,7 +107,7 @@ module Homebrew
},
HOMEBREW_DISPLAY: {
description: "Use this X11 display when opening a page in a browser, for example with " \
- "`brew home`. Primarily useful on Linux.",
+ "`brew home`. Primarily useful on Linux.",
default_text: "`$DISPLAY`.",
},
HOMEBREW_DISPLAY_INSTALL_TIMES: {
@@ -116,9 +116,10 @@ module Homebrew
},
HOMEBREW_EDITOR: {
description: "Use this editor when editing a single formula, or several formulae in the " \
- "same directory.\n\n *Note:* `brew edit` will open all of Homebrew as discontinuous files " \
- "and directories. Visual Studio Code can handle this correctly in project mode, but many " \
- "editors will do strange things in this case.",
+ "same directory." \
+ "\n\n *Note:* `brew edit` will open all of Homebrew as discontinuous files " \
+ "and directories. Visual Studio Code can handle this correctly in project mode, but many " \
+ "editors will do strange things in this case.",
default_text: "`$EDITOR` or `$VISUAL`.",
},
HOMEBREW_FAIL_LOG_LINES: {
@@ -157,9 +158,9 @@ module Homebrew
description: "Use this personal access token for the GitHub API, for features such as " \
"`brew search`. You can create one at <https://github.com/settings/tokens>. If set, " \
"GitHub will allow you a greater number of API requests. For more information, see: " \
- "<https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting>.\n\n" \
- " *Note:* Homebrew doesn't require permissions for any of the scopes, but some developer " \
- "commands may require additional permissions.",
+ "<https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting>" \
+ "\n\n *Note:* Homebrew doesn't require permissions for any of the scopes, but some " \
+ "developer commands may require additional permissions.",
},
HOMEBREW_GITHUB_API_USERNAME: {
description: "Use this username for authentication with the GitHub API, for features " \
diff --git a/Library/Homebrew/manpages/brew.1.md.erb b/Library/Homebrew/manpages/brew.1.md.erb
index 98333ba688b678acdf4db691099e6528d96ac189..ba4d02d0f7c3debb07064d15af241765b76a2d73 100644
--- a/Library/Homebrew/manpages/brew.1.md.erb
+++ b/Library/Homebrew/manpages/brew.1.md.erb
@@ -34,7 +34,7 @@ For the full command list, see the [COMMANDS](#commands) section.
With `--verbose` or `--debug`, many commands print extra debugging information.
Note that these options should only appear after a command.
-### `install` <formula>:
+### `install` <formula>
Install <formula>.
@@ -42,15 +42,15 @@ Install <formula>.
syntaxes which are listed in the [SPECIFYING FORMULAE](#specifying-formulae)
section.
-### `uninstall` <formula>:
+### `uninstall` <formula>
Uninstall <formula>.
-### `list`:
+### `list`
List all installed formulae.
-### `search` (<text>|`/`<text>`/`):
+### `search` [<text>|`/`<text>`/`]
Perform a substring search of cask tokens and formula names for <text>. If
<text> is flanked by slashes, it is interpreted as a regular expression.
@@ -161,10 +161,10 @@ Homebrew API: <https://rubydoc.brew.sh>
See our issues on GitHub:
* **Homebrew/brew**:
- <https://github.com/Homebrew/brew/issues>
+ <br><https://github.com/Homebrew/brew/issues>
* **Homebrew/homebrew-core**:
- <https://github.com/Homebrew/homebrew-core/issues>
+ <br><https://github.com/Homebrew/homebrew-core/issues>
* **Homebrew/homebrew-cask**:
- <https://github.com/Homebrew/homebrew-cask/issues>
+ <br><https://github.com/Homebrew/homebrew-cask/issues>
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 5574ec9d87170636a56a55b0f6c77c634bdfdd89..881fe0eac973dfbc729714cdbc723a66664e3983 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -1,5 +1,5 @@
-brew(1) -- The Missing Package Manager for macOS
-================================================
+brew(1) -- The Missing Package Manager for macOS (or Linux)
+===========================================================
## SYNOPSIS
@@ -9,34 +9,36 @@ brew(1) -- The Missing Package Manager for macOS
## DESCRIPTION
Homebrew is the easiest and most flexible way to install the UNIX tools Apple
-didn't include with macOS.
+didn't include with macOS. It can also install software not packaged for your
+Linux distribution to your home directory without requiring `sudo`.
## ESSENTIAL COMMANDS
For the full command list, see the [COMMANDS](#commands) section.
-With `--verbose` or `--debug`, many commands print extra debugging information. Note that
-these options should only appear after a command.
+With `--verbose` or `--debug`, many commands print extra debugging information.
+Note that these options should only appear after a command.
-### `install` *`formula`*:
+### `install` *`formula`*
Install *`formula`*.
-*`formula`* is usually the name of the formula to install, but it has other syntaxes which
-are listed in the [SPECIFYING FORMULAE](#specifying-formulae) section.
+*`formula`* is usually the name of the formula to install, but it has other
+syntaxes which are listed in the [SPECIFYING FORMULAE](#specifying-formulae)
+section.
-### `uninstall` *`formula`*:
+### `uninstall` *`formula`*
Uninstall *`formula`*.
-### `list`:
+### `list`
List all installed formulae.
-### `search` (*`text`*|`/`*`text`*`/`):
+### `search` [*`text`*|`/`*`text`*`/`]
-Perform a substring search of cask tokens and formula names for *`text`*. If *`text`*
-is flanked by slashes, it is interpreted as a regular expression.
+Perform a substring search of cask tokens and formula names for *`text`*. If
+*`text`* is flanked by slashes, it is interpreted as a regular expression.
The search for *`text`* is extended online to `homebrew/core` and `homebrew/cask`.
If no search term is provided, all locally available formulae are listed.
@@ -47,14 +49,14 @@ If no search term is provided, all locally available formulae are listed.
Control Homebrew's anonymous aggregate user behaviour analytics.
Read more at <https://docs.brew.sh/Analytics>.
-`brew analytics` [`state`]:
-Display the current state of Homebrew's analytics.
+`brew analytics` [`state`]
+<br>Display the current state of Homebrew's analytics.
-`brew analytics` [`on`|`off`]:
-Turn Homebrew's analytics on or off respectively.
+`brew analytics` (`on`|`off`)
+<br>Turn Homebrew's analytics on or off respectively.
-`brew analytics regenerate-uuid`:
-Regenerate the UUID used for Homebrew's analytics.
+`brew analytics regenerate-uuid`
+<br>Regenerate the UUID used for Homebrew's analytics.
### `autoremove` [*`options`*]
@@ -69,59 +71,59 @@ Homebrew Cask provides a friendly CLI workflow for the administration of macOS a
Commands:
-- `--cache`
- Display the file used to cache a *`cask`*.
+- `--cache`
+ <br>Display the file used to cache a *`cask`*.
-- `audit`
- Check *`cask`* for Homebrew coding style violations.
+- `audit`
+ <br>Check *`cask`* for Homebrew coding style violations.
-- `cat`
- Dump raw source of a *`cask`* to the standard output.
+- `cat`
+ <br>Dump raw source of a *`cask`* to the standard output.
-- `create`
- Creates the given *`cask`* and opens it in an editor.
+- `create`
+ <br>Creates the given *`cask`* and opens it in an editor.
-- `doctor`
- Checks for configuration issues.
+- `doctor`
+ <br>Checks for configuration issues.
-- `edit`
- Open the given *`cask`* for editing.
+- `edit`
+ <br>Open the given *`cask`* for editing.
-- `fetch`
- Downloads remote application files to local cache.
+- `fetch`
+ <br>Downloads remote application files to local cache.
-- `help`
- Print help for `cask` commands.
+- `help`
+ <br>Print help for `cask` commands.
-- `home`
- Opens the homepage of the given *`cask`*.
+- `home`
+ <br>Opens the homepage of the given *`cask`*.
-- `info`
- Displays information about the given *`cask`*.
+- `info`
+ <br>Displays information about the given *`cask`*.
-- `install`
- Installs the given *`cask`*.
+- `install`
+ <br>Installs the given *`cask`*.
-- `list`
- Lists installed casks or the casks provided in the arguments.
+- `list`
+ <br>Lists installed casks or the casks provided in the arguments.
-- `outdated`
- List the outdated installed casks.
+- `outdated`
+ <br>List the outdated installed casks.
-- `reinstall`
- Reinstalls the given *`cask`*.
+- `reinstall`
+ <br>Reinstalls the given *`cask`*.
-- `style`
- Checks style of the given *`cask`* using RuboCop.
+- `style`
+ <br>Checks style of the given *`cask`* using RuboCop.
-- `uninstall`
- Uninstalls the given *`cask`*.
+- `uninstall`
+ <br>Uninstalls the given *`cask`*.
-- `upgrade`
- Upgrades all outdated casks or the specified casks.
+- `upgrade`
+ <br>Upgrades all outdated casks or the specified casks.
-- `zap`
- Zaps all files associated with the given *`cask`*.
+- `zap`
+ <br>Zaps all files associated with the given *`cask`*.
See also: `man brew`
@@ -329,11 +331,11 @@ the installed formulae or, every 30 days, for all formulae.
* `--cask`:
Treat all named arguments as casks.
* `--[no-]binaries`:
- Disable/enable linking of helper executables. Default: enabled
+ Disable/enable linking of helper executables (default: enabled).
* `--require-sha`:
Require all casks to have a checksum.
* `--[no-]quarantine`:
- Disable/enable quarantining of downloads. Default: enabled
+ Disable/enable quarantining of downloads (default: enabled).
* `--skip-cask-deps`:
Skip installing cask dependencies.
@@ -354,14 +356,14 @@ installations.
* `-f`, `--force`:
Allow keg-only formulae to be linked.
-### `list`, `ls` [*`options`*] [*`formula|cask`*]
+### `list`, `ls` [*`options`*] [*`formula`*|*`cask`*]
-List all installed formulae or casks
+List all installed formulae and casks.
If *`formula`* is provided, summarise the paths within its current keg.
* `--formula`:
- List only formulae. `This is the default action on non TTY.`
+ List only formulae. This is the default when output is not to a terminal.
* `--cask`:
List only casks, or *`cask`* if provided.
* `--unbrewed`:
@@ -439,9 +441,9 @@ information is displayed in interactive shells, and suppressed otherwise.
* `-v`, `--verbose`:
Include detailed version information.
* `--formula`:
- Only output outdated formulae.
+ List only outdated formulae.
* `--cask`:
- Only output outdated casks.
+ List only outdated casks.
* `--json`:
Print output in JSON format. There are two versions: v1 and v2. v1 is deprecated and is currently the default if no version is specified. v2 prints outdated formulae and casks.
* `--fetch-HEAD`:
@@ -499,11 +501,11 @@ reinstalled formulae or, every 30 days, for all formulae.
* `--cask`:
Treat all named arguments as casks.
* `--[no-]binaries`:
- Disable/enable linking of helper executables. Default: enabled
+ Disable/enable linking of helper executables (default: enabled).
* `--require-sha`:
Require all casks to have a checksum.
* `--[no-]quarantine`:
- Disable/enable quarantining of downloads. Default: enabled
+ Disable/enable quarantining of downloads (default: enabled).
* `--skip-cask-deps`:
Skip installing cask dependencies.
@@ -523,7 +525,7 @@ No online search is performed.
* `--desc`:
Search for formulae with a description matching *`text`* and casks with a name matching *`text`*.
* `--pull-request`:
- Search for GitHub pull requests for *`text`*.
+ Search for GitHub pull requests containing *`text`*.
* `--macports`:
Search for *`text`* in the given package manager's list.
* `--fink`:
@@ -662,11 +664,11 @@ upgraded formulae or, every 30 days, for all formulae.
* `--cask`:
Treat all named arguments as casks. If no named arguments are specified, upgrade only outdated casks.
* `--[no-]binaries`:
- Disable/enable linking of helper executables. Default: enabled
+ Disable/enable linking of helper executables (default: enabled).
* `--require-sha`:
Require all casks to have a checksum.
* `--[no-]quarantine`:
- Disable/enable quarantining of downloads. Default: enabled
+ Disable/enable quarantining of downloads (default: enabled).
* `--skip-cask-deps`:
Skip installing cask dependencies.
* `--greedy`:
@@ -692,7 +694,7 @@ specify *`formula`* as a required or recommended dependency for their stable bui
* `--skip-recommended`:
Skip all formulae that specify *`formula`* as `:recommended` type dependency.
-### `--cache` [*`options`*] [*`formula|cask`*]
+### `--cache` [*`options`*] [*`formula`*|*`cask`*]
Display Homebrew's download cache. See also `HOMEBREW_CACHE`.
@@ -779,7 +781,7 @@ errors are found.
* `--display-filename`:
Prefix every line of output with the file or formula name being audited, to make output easy to grep.
* `--skip-style`:
- Skip running non-RuboCop style checks. Useful if you plan on running `brew style` separately. Default unless a formula is specified by name
+ Skip running non-RuboCop style checks. Useful if you plan on running `brew style` separately. Enabled by default unless a formula is specified by name.
* `-D`, `--audit-debug`:
Enable debugging and profiling of audit methods.
* `--only`:
@@ -826,7 +828,7 @@ Also displays whether a pull request has been opened with the URL.
* `--limit`:
Limit number of package results returned.
-### `bump-cask-pr` [*`options`*] [*`cask`*]
+### `bump-cask-pr` [*`options`*] *`cask`*
Create a pull request to update *`cask`* with a new version.
@@ -910,7 +912,7 @@ nor vice versa. It must use whichever style specification the formula already us
* `--revision`:
Specify the new git commit *`revision`* corresponding to the specified *`tag`*.
* `-f`, `--force`:
- Ignore duplicate open PRs. Remove all mirrors if --mirror= was not specified.
+ Ignore duplicate open PRs. Remove all mirrors if `--mirror` was not specified.
### `bump-revision` [*`options`*] *`formula`* [*`formula`* ...]
@@ -971,7 +973,7 @@ a simple example. For the complete API, see:
* `--tap`:
Generate the new formula within the given tap, specified as *`user`*`/`*`repo`*.
* `-f`, `--force`:
- Ignore errors for disallowed formula names and named that shadow aliases.
+ Ignore errors for disallowed formula names and names that shadow aliases.
### `dispatch-build-bottle` [*`options`*] *`formula`* [*`formula`* ...]
@@ -1086,7 +1088,7 @@ Find pull requests that can be automatically merged using `brew pr-publish`.
* `--with-label`:
Pull requests must have this label.
* `--without-labels`:
- Pull requests must not have these labels (default: `do not merge`, `new formula`, `automerge-skip`).
+ Pull requests must not have these labels (default: `do not merge`, `new formula`, `automerge-skip`, `linux-only`).
* `--without-approval`:
Pull requests do not require approval to be merged.
* `--publish`:
@@ -1233,11 +1235,11 @@ including core code and all formulae.
Generate the template files for a new tap.
* `--no-git`:
- Don't initialize a git repository for the tap.
+ Don't initialize a Git repository for the tap.
* `--pull-label`:
- Label name for pull requests ready to be pulled (default `pr-pull`).
+ Label name for pull requests ready to be pulled (default: `pr-pull`).
* `--branch`:
- Initialize git repository with the specified branch name (default `main`).
+ Initialize Git repository with the specified branch name (default: `main`).
### `test` [*`options`*] *`formula`*
@@ -1350,50 +1352,50 @@ Install and commit Homebrew's vendored gems.
These options are applicable to subcommands accepting a `--cask` flag and all `cask` commands.
-* `--appdir=`:
- Target location for Applications. Default: `/Applications`
+* `--appdir`:
+ Target location for Applications (default: `/Applications`).
-* `--colorpickerdir=`:
- Target location for Color Pickers. Default: `~/Library/ColorPickers`
+* `--colorpickerdir`:
+ Target location for Color Pickers (default: `~/Library/ColorPickers`).
-* `--prefpanedir=`:
- Target location for Preference Panes. Default: `~/Library/PreferencePanes`
+* `--prefpanedir`:
+ Target location for Preference Panes (default: `~/Library/PreferencePanes`).
-* `--qlplugindir=`:
- Target location for QuickLook Plugins. Default: `~/Library/QuickLook`
+* `--qlplugindir`:
+ Target location for QuickLook Plugins (default: `~/Library/QuickLook`).
-* `--mdimporterdir=`:
- Target location for Spotlight Plugins. Default: `~/Library/Spotlight`
+* `--mdimporterdir`:
+ Target location for Spotlight Plugins (default: `~/Library/Spotlight`).
-* `--dictionarydir=`:
- Target location for Dictionaries. Default: `~/Library/Dictionaries`
+* `--dictionarydir`:
+ Target location for Dictionaries (default: `~/Library/Dictionaries`).
-* `--fontdir=`:
- Target location for Fonts. Default: `~/Library/Fonts`
+* `--fontdir`:
+ Target location for Fonts (default: `~/Library/Fonts`).
-* `--servicedir=`:
- Target location for Services. Default: `~/Library/Services`
+* `--servicedir`:
+ Target location for Services (default: `~/Library/Services`).
-* `--input_methoddir=`:
- Target location for Input Methods. Default: `~/Library/Input Methods`
+* `--input_methoddir`:
+ Target location for Input Methods (default: `~/Library/Input Methods`).
-* `--internet_plugindir=`:
- Target location for Internet Plugins. Default: `~/Library/Internet Plug-Ins`
+* `--internet_plugindir`:
+ Target location for Internet Plugins (default: `~/Library/Internet Plug-Ins`).
-* `--audio_unit_plugindir=`:
- Target location for Audio Unit Plugins. Default: `~/Library/Audio/Plug-Ins/Components`
+* `--audio_unit_plugindir`:
+ Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`).
-* `--vst_plugindir=`:
- Target location for VST Plugins. Default: `~/Library/Audio/Plug-Ins/VST`
+* `--vst_plugindir`:
+ Target location for VST Plugins (default: `~/Library/Audio/Plug-Ins/VST`).
-* `--vst3_plugindir=`:
- Target location for VST3 Plugins. Default: `~/Library/Audio/Plug-Ins/VST3`
+* `--vst3_plugindir`:
+ Target location for VST3 Plugins (default: `~/Library/Audio/Plug-Ins/VST3`).
-* `--screen_saverdir=`:
- Target location for Screen Savers. Default: `~/Library/Screen Savers`
+* `--screen_saverdir`:
+ Target location for Screen Savers (default: `~/Library/Screen Savers`).
* `--language`:
- Set language of the Cask to install. The first matching language is used, otherwise the default language on the Cask. The default value is the `language of your system`
+ Comma-separated list of language codes to prefer for cask installation. The first matching language is used, otherwise it reverts to the cask's default language. The default value is the language of your system.
## GLOBAL OPTIONS
@@ -1417,33 +1419,35 @@ These options are applicable across multiple subcommands.
Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store and Whalebrew.
-`brew bundle` [`install`]:
-Install and upgrade (by default) all dependencies from the `Brewfile`.
+`brew bundle` [`install`]
+<br>Install and upgrade (by default) all dependencies from the `Brewfile`.
+
+You can specify the `Brewfile` location using `--file` or by setting the `HOMEBREW_BUNDLE_FILE` environment variable.
-You can skip the installation of dependencies by adding space-separated values to one or more of the following environment variables: `HOMEBREW_BUNDLE_BREW_SKIP`, `HOMEBREW_BUNDLE_CASK_SKIP`, `HOMEBREW_BUNDLE_MAS_SKIP`, `HOMEBREW_BUNDLE_WHALEBREW_SKIP`, `HOMEBREW_BUNDLE_TAP_SKIP`
+You can skip the installation of dependencies by adding space-separated values to one or more of the following environment variables: `HOMEBREW_BUNDLE_BREW_SKIP`, `HOMEBREW_BUNDLE_CASK_SKIP`, `HOMEBREW_BUNDLE_MAS_SKIP`, `HOMEBREW_BUNDLE_WHALEBREW_SKIP`, `HOMEBREW_BUNDLE_TAP_SKIP`.
`brew bundle` will output a `Brewfile.lock.json` in the same directory as the `Brewfile` if all dependencies are installed successfully. This contains dependency and system status information which can be useful in debugging `brew bundle` failures and replicating a "last known good build" state. You can opt-out of this behaviour by setting the `HOMEBREW_BUNDLE_NO_LOCK` environment variable or passing the `--no-lock` option. You may wish to check this file into the same version control system as your `Brewfile` (or ensure your version control system ignores it if you'd prefer to rely on debugging information from a local machine).
-`brew bundle dump`:
-Write all installed casks/formulae/images/taps into a `Brewfile`.
+`brew bundle dump`
+<br>Write all installed casks/formulae/images/taps into a `Brewfile` in the current directory.
-`brew bundle cleanup`:
-Uninstall all dependencies not listed from the `Brewfile`.
+`brew bundle cleanup`
+<br>Uninstall all dependencies not listed from the `Brewfile`.
This workflow is useful for maintainers or testers who regularly install lots of formulae.
-`brew bundle check`:
-Check if all dependencies are installed from the `Brewfile` .
+`brew bundle check`
+<br>Check if all dependencies are installed from the `Brewfile`.
This provides a successful exit code if everything is up-to-date, making it useful for scripting.
-`brew bundle list`:
-List all dependencies present in a `Brewfile`.
+`brew bundle list`
+<br>List all dependencies present in the `Brewfile`.
By default, only Homebrew dependencies are listed.
-`brew bundle exec` *`command`*:
-Run an external command in an isolated build environment based on the `Brewfile` dependencies.
+`brew bundle exec` *`command`*
+<br>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 find keg-only dependencies like `openssl`, `icu4c`, etc.
@@ -1487,67 +1491,67 @@ Manage background services with macOS' `launchctl`(1) daemon manager.
If `sudo` is passed, operate on `/Library/LaunchDaemons` (started at boot).
Otherwise, operate on `~/Library/LaunchAgents` (started at login).
-[`sudo`] `brew services` [`list`]:
-List all managed services for the current user (or root).
+[`sudo`] `brew services` [`list`]
+<br>List all managed services for the current user (or root).
-[`sudo`] `brew services run` (*`formula`*|`--all`):
-Run the service *`formula`* without registering to launch at login (or boot).
+[`sudo`] `brew services run` (*`formula`*|`--all`)
+<br>Run the service *`formula`* without registering to launch at login (or boot).
-[`sudo`] `brew services start` (*`formula`*|`--all`):
-Start the service *`formula`* immediately and register it to launch at login (or boot).
+[`sudo`] `brew services start` (*`formula`*|`--all`)
+<br>Start the service *`formula`* immediately and register it to launch at login (or boot).
-[`sudo`] `brew services stop` (*`formula`*|`--all`):
-Stop the service *`formula`* immediately and unregister it from launching at login (or boot).
+[`sudo`] `brew services stop` (*`formula`*|`--all`)
+<br>Stop the service *`formula`* immediately and unregister it from launching at login (or boot).
-[`sudo`] `brew services restart` (*`formula`*|`--all`):
-Stop (if necessary) and start the service *`formula`* immediately and register it to launch at login (or boot).
+[`sudo`] `brew services restart` (*`formula`*|`--all`)
+<br>Stop (if necessary) and start the service *`formula`* immediately and register it to launch at login (or boot).
-[`sudo`] `brew services cleanup`:
-Remove all unused services.
+[`sudo`] `brew services cleanup`
+<br>Remove all unused services.
* `--all`:
Run *`subcommand`* on all services.
-### `test-bot` [*`options`*] [*`formula`*]:
+### `test-bot` [*`options`*] [*`formula`*]
-Tests the full lifecycle of a Homebrew change to a tap (Git repository). For example, for a GitHub Actions pull request that changes a formula `brew test-bot` will ensure the system is cleaned and setup to test the formula, install the formula, run various tests and checks on it, bottle (package) the binaries and test formulae that depend on it to ensure they aren't broken by these changes.
+Tests the full lifecycle of a Homebrew change to a tap (Git repository). For example, for a GitHub Actions pull request that changes a formula `brew test-bot` will ensure the system is cleaned and set up to test the formula, install the formula, run various tests and checks on it, bottle (package) the binaries and test formulae that depend on it to ensure they aren't broken by these changes.
Only supports GitHub Actions as a CI provider. This is because Homebrew uses GitHub Actions and it's freely available for public and private use with macOS and Linux workers.
* `--dry-run`:
- print what would be done rather than doing it.
+ Print what would be done rather than doing it.
* `--cleanup`:
- clean all state from the Homebrew directory. Use with care!
+ Clean all state from the Homebrew directory. Use with care!
* `--skip-setup`:
- don't check if the local system is set up correctly.
+ Don't check if the local system is set up correctly.
* `--keep-old`:
- run `brew bottle --keep-old` to build new bottles for a single platform.
+ Run `brew bottle --keep-old` to build new bottles for a single platform.
* `--skip-relocation`:
- run `brew bottle --skip-relocation` to build new bottles that don't require relocation.
+ Run `brew bottle --skip-relocation` to build new bottles that don't require relocation.
* `--local`:
- ask Homebrew to write verbose logs under `./logs/` and set `$HOME` to `./home/`
+ Ask Homebrew to write verbose logs under `./logs/` and set `$HOME` to `./home/`
* `--tap`:
- use the `git` repository of the given tap. Defaults to the core tap for syntax checking.
+ Use the Git repository of the given tap. Defaults to the core tap for syntax checking.
* `--fail-fast`:
- immediately exit on a failing step.
+ Immediately exit on a failing step.
* `-v`, `--verbose`:
- print test step output in real time. Has the side effect of passing output as raw bytes instead of re-encoding in UTF-8.
+ Print test step output in real time. Has the side effect of passing output as raw bytes instead of re-encoding in UTF-8.
* `--test-default-formula`:
- use a default testing formula when not building a tap and no other formulae are specified.
+ Use a default testing formula when not building a tap and no other formulae are specified.
* `--bintray-org`:
- upload to the given Bintray organisation.
+ Upload bottles to the given Bintray organisation.
* `--root-url`:
- use the specified *`URL`* as the root of the bottle's URL instead of Homebrew's default.
+ Use the specified *`URL`* as the root of the bottle's URL instead of Homebrew's default.
* `--git-name`:
- set the Git author/committer names to the given name.
+ Set the Git author/committer names to the given name.
* `--git-email`:
- set the Git author/committer email to the given email.
+ Set the Git author/committer email to the given email.
* `--ci-upload`:
- use the Homebrew CI bottle upload options.
+ Use the Homebrew CI bottle upload options.
* `--publish`:
- publish the uploaded bottles.
+ Publish the uploaded bottles.
* `--skip-recursive-dependents`:
- only test the direct dependents.
+ Only test the direct dependents.
* `--only-cleanup-before`:
Only run the pre-cleanup step. Needs `--cleanup`.
* `--only-setup`:
@@ -1563,8 +1567,8 @@ Only supports GitHub Actions as a CI provider. This is because Homebrew uses Git
Homebrew, like `git`(1), supports external commands. These are executable
scripts that reside somewhere in the `PATH`, named `brew-`*`cmdname`* or
-`brew-`*`cmdname`*`.rb`, which can be invoked like `brew` *`cmdname`*. This allows you
-to create your own commands without modifying Homebrew's internals.
+`brew-`*`cmdname`*`.rb`, which can be invoked like `brew` *`cmdname`*. This allows
+you to create your own commands without modifying Homebrew's internals.
Instructions for creating your own commands can be found in the docs:
<https://docs.brew.sh/External-Commands>
@@ -1595,252 +1599,251 @@ specified the same way as the *`formula`* arguments described in
## ENVIRONMENT
-Note that environment variables must have a value set to be detected. For example, run
-`export HOMEBREW_NO_INSECURE_REDIRECT=1` rather than just
+Note that environment variables must have a value set to be detected. For
+example, run `export HOMEBREW_NO_INSECURE_REDIRECT=1` rather than just
`export HOMEBREW_NO_INSECURE_REDIRECT`.
- * `HOMEBREW_ARCH`:
- Linux only: Pass the set value to a type name representing the compiler's `-march` option.
+- `HOMEBREW_ARCH`
+ <br>Linux only: Pass this value to a type name representing the compiler's `-march` option.
- *Default:* `native`.
+ *Default:* `native`.
- * `HOMEBREW_ARTIFACT_DOMAIN`:
- Prefix all download URLs, including those for bottles, with this variable. For example, `HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080` will cause a formula with the URL `https://example.com/foo.tar.gz` to instead download from `http://localhost:8080/example.com/foo.tar.gz`.
+- `HOMEBREW_ARTIFACT_DOMAIN`
+ <br>Prefix all download URLs, including those for bottles, with this variable. For example, `HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080` will cause a formula with the URL `https://example.com/foo.tar.gz` to instead download from `http://localhost:8080/example.com/foo.tar.gz`.
- * `HOMEBREW_AUTO_UPDATE_SECS`:
- Automatically check for updates once per this seconds interval.
+- `HOMEBREW_AUTO_UPDATE_SECS`
+ <br>Automatically check for updates once per this seconds interval.
- *Default:* `300`.
+ *Default:* `300`.
- * `HOMEBREW_BAT`:
- If set, use `bat` for the `brew cat` command.
+- `HOMEBREW_BAT`
+ <br>If set, use `bat` for the `brew cat` command.
- * `HOMEBREW_BAT_CONFIG_PATH`:
- Use the `bat` configuration file. For example, `HOMEBREW_BAT=$HOME/.bat/config`.
+- `HOMEBREW_BAT_CONFIG_PATH`
+ <br>Use this as the `bat` configuration file.
- *Default:* $HOME/.bat/config
+ *Default:* `$HOME/.bat/config`.
- * `HOMEBREW_BINTRAY_KEY`:
- Use this API key when accessing the Bintray API (where bottles are stored).
+- `HOMEBREW_BINTRAY_KEY`
+ <br>Use this API key when accessing the Bintray API (where bottles are stored).
- * `HOMEBREW_BINTRAY_USER`:
- Use this username when accessing the Bintray API (where bottles are stored).
+- `HOMEBREW_BINTRAY_USER`
+ <br>Use this username when accessing the Bintray API (where bottles are stored).
- * `HOMEBREW_BOTTLE_DOMAIN`:
- Use the specified URL as the download mirror for bottles. For example, `HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080` will cause all bottles to download from the prefix `http://localhost:8080/`.
+- `HOMEBREW_BOTTLE_DOMAIN`
+ <br>Use this URL as the download mirror for bottles. For example, `HOMEBREW_BOTTLE_DOMAIN=http://localhost:8080` will cause all bottles to download from the prefix `http://localhost:8080/`.
- *Default:* macOS: `https://homebrew.bintray.com/`, Linux: `https://linuxbrew.bintray.com/`.
+ *Default:* macOS: `https://homebrew.bintray.com/`, Linux: `https://linuxbrew.bintray.com/`.
- * `HOMEBREW_BREW_GIT_REMOTE`:
- Use the specified URL as the Homebrew/brew `git`(1) remote.
+- `HOMEBREW_BREW_GIT_REMOTE`
+ <br>Use this URL as the Homebrew/brew `git`(1) remote.
- *Default:* `https://github.com/Homebrew/brew`.
+ *Default:* `https://github.com/Homebrew/brew`.
- * `HOMEBREW_BROWSER`:
- Use this as the browser when opening project homepages.
+- `HOMEBREW_BROWSER`
+ <br>Use this as the browser when opening project homepages.
- *Default:* `$BROWSER` or the OS's default browser.
+ *Default:* `$BROWSER` or the OS's default browser.
- * `HOMEBREW_CACHE`:
- Use the specified directory as the download cache.
+- `HOMEBREW_CACHE`
+ <br>Use this directory as the download cache.
- *Default:* macOS: `$HOME/Library/Caches/Homebrew`, Linux: `$XDG_CACHE_HOME/Homebrew` or `$HOME/.cache/Homebrew`.
+ *Default:* macOS: `$HOME/Library/Caches/Homebrew`, Linux: `$XDG_CACHE_HOME/Homebrew` or `$HOME/.cache/Homebrew`.
- * `HOMEBREW_CASK_OPTS`:
- Options which should be used for all `cask` commands. All `--*dir` options, `--language`, `--require-sha`, `--no-quarantine` and `--no-binaries` are supported.
-For example, you might add something like the following to your ~/.profile, ~/.bash_profile, or ~/.zshenv:
+- `HOMEBREW_CASK_OPTS`
+ <br>Append these options to all `cask` commands. All `--*dir` options, `--language`, `--require-sha`, `--no-quarantine` and `--no-binaries` are supported. For example, you might add something like the following to your `~/.profile`, `~/.bash_profile`, or `~/.zshenv`:
-`export HOMEBREW_CASK_OPTS='--appdir=~/Applications --fontdir=/Library/Fonts'`
+ `export HOMEBREW_CASK_OPTS="--appdir=~/Applications --fontdir=/Library/Fonts"`
- * `HOMEBREW_CLEANUP_MAX_AGE_DAYS`:
- Cleanup all cached files older than this many days.
+- `HOMEBREW_CLEANUP_MAX_AGE_DAYS`
+ <br>Cleanup all cached files older than this many days.
- *Default:* `120`.
+ *Default:* `120`.
- * `HOMEBREW_COLOR`:
- If set, force colour output on non-TTY outputs.
+- `HOMEBREW_COLOR`
+ <br>If set, force colour output on non-TTY outputs.
- * `HOMEBREW_CORE_GIT_REMOTE`:
- Use the specified URL as the Homebrew/homebrew-core `git`(1) remote.
+- `HOMEBREW_CORE_GIT_REMOTE`
+ <br>Use this URL as the Homebrew/homebrew-core `git`(1) remote.
- *Default:* macOS: `https://github.com/Homebrew/homebrew-core`, Linux: `https://github.com/Homebrew/linuxbrew-core`.
+ *Default:* macOS: `https://github.com/Homebrew/homebrew-core`, Linux: `https://github.com/Homebrew/linuxbrew-core`.
- * `HOMEBREW_CURLRC`:
- If set, do not pass `--disable` when invoking `curl`(1), which disables the use of `curlrc`.
+- `HOMEBREW_CURLRC`
+ <br>If set, do not pass `--disable` when invoking `curl`(1), which disables the use of `curlrc`.
- * `HOMEBREW_CURL_RETRIES`:
- Pass the given retry count to `--retry` when invoking `curl`(1).
+- `HOMEBREW_CURL_RETRIES`
+ <br>Pass the given retry count to `--retry` when invoking `curl`(1).
- *Default:* `3`.
+ *Default:* `3`.
- * `HOMEBREW_CURL_VERBOSE`:
- If set, pass `--verbose` when invoking `curl`(1).
+- `HOMEBREW_CURL_VERBOSE`
+ <br>If set, pass `--verbose` when invoking `curl`(1).
- * `HOMEBREW_DEVELOPER`:
- If set, tweak behaviour to be more relevant for Homebrew developers (active or budding) by e.g. turning warnings into errors.
+- `HOMEBREW_DEVELOPER`
+ <br>If set, tweak behaviour to be more relevant for Homebrew developers (active or budding) by e.g. turning warnings into errors.
- * `HOMEBREW_DISABLE_LOAD_FORMULA`:
- If set, refuse to load formulae. This is useful when formulae are not trusted (such as in pull requests).
+- `HOMEBREW_DISABLE_LOAD_FORMULA`
+ <br>If set, refuse to load formulae. This is useful when formulae are not trusted (such as in pull requests).
- * `HOMEBREW_DISPLAY`:
- Use this X11 display when opening a page in a browser, for example with `brew home`. Primarily useful on Linux.
+- `HOMEBREW_DISPLAY`
+ <br>Use this X11 display when opening a page in a browser, for example with `brew home`. Primarily useful on Linux.
- *Default:* `$DISPLAY`.
+ *Default:* `$DISPLAY`.
- * `HOMEBREW_DISPLAY_INSTALL_TIMES`:
- If set, print install times for each formula at the end of the run.
+- `HOMEBREW_DISPLAY_INSTALL_TIMES`
+ <br>If set, print install times for each formula at the end of the run.
- * `HOMEBREW_EDITOR`:
- Use this editor when editing a single formula, or several formulae in the same directory.
+- `HOMEBREW_EDITOR`
+ <br>Use this editor when editing a single formula, or several formulae in the same directory.
*Note:* `brew edit` will open all of Homebrew as discontinuous files and directories. Visual Studio Code can handle this correctly in project mode, but many editors will do strange things in this case.
- *Default:* `$EDITOR` or `$VISUAL`.
+ *Default:* `$EDITOR` or `$VISUAL`.
- * `HOMEBREW_FAIL_LOG_LINES`:
- Output this many lines of output on formula `system` failures.
+- `HOMEBREW_FAIL_LOG_LINES`
+ <br>Output this many lines of output on formula `system` failures.
- *Default:* `15`.
+ *Default:* `15`.
- * `HOMEBREW_FORBIDDEN_LICENSES`:
- A space-separated list of licenses. Homebrew will refuse to install a formula if that formula or any of its dependencies has a license on this list.
+- `HOMEBREW_FORBIDDEN_LICENSES`
+ <br>A space-separated list of licenses. Homebrew will refuse to install a formula if it or any of its dependencies has a license on this list.
- * `HOMEBREW_FORCE_BREWED_CURL`:
- If set, always use a Homebrew-installed `curl`(1) rather than the system version. Automatically set if the system version of `curl` is too old.
+- `HOMEBREW_FORCE_BREWED_CURL`
+ <br>If set, always use a Homebrew-installed `curl`(1) rather than the system version. Automatically set if the system version of `curl` is too old.
- * `HOMEBREW_FORCE_BREWED_GIT`:
- If set, always use a Homebrew-installed `git`(1) rather than the system version. Automatically set if the system version of `git` is too old.
+- `HOMEBREW_FORCE_BREWED_GIT`
+ <br>If set, always use a Homebrew-installed `git`(1) rather than the system version. Automatically set if the system version of `git` is too old.
- * `HOMEBREW_FORCE_HOMEBREW_ON_LINUX`:
- If set, running Homebrew on Linux will use URLs for macOS. This is useful when merging pull requests for macOS while on Linux.
+- `HOMEBREW_FORCE_HOMEBREW_ON_LINUX`
+ <br>If set, running Homebrew on Linux will use URLs for macOS. This is useful when merging pull requests for macOS while on Linux.
- * `HOMEBREW_FORCE_VENDOR_RUBY`:
- If set, always use Homebrew's vendored, relocatable Ruby version even if the system version of Ruby is new enough.
+- `HOMEBREW_FORCE_VENDOR_RUBY`
+ <br>If set, always use Homebrew's vendored, relocatable Ruby version even if the system version of Ruby is new enough.
- * `HOMEBREW_GITHUB_API_PASSWORD`:
- Use this password for authentication with the GitHub API, for features such as `brew search`. This is deprecated in favour of using `HOMEBREW_GITHUB_API_TOKEN`.
+- `HOMEBREW_GITHUB_API_PASSWORD`
+ <br>Use this password for authentication with the GitHub API, for features such as `brew search`. This is deprecated in favour of using `HOMEBREW_GITHUB_API_TOKEN`.
- * `HOMEBREW_GITHUB_API_TOKEN`:
- Use this personal access token for the GitHub API, for features such as `brew search`. You can create one at <https://github.com/settings/tokens>. If set, GitHub will allow you a greater number of API requests. For more information, see: <https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting>.
+- `HOMEBREW_GITHUB_API_TOKEN`
+ <br>Use this personal access token for the GitHub API, for features such as `brew search`. You can create one at <https://github.com/settings/tokens>. If set, GitHub will allow you a greater number of API requests. For more information, see: <https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting>
*Note:* Homebrew doesn't require permissions for any of the scopes, but some developer commands may require additional permissions.
- * `HOMEBREW_GITHUB_API_USERNAME`:
- Use this username for authentication with the GitHub API, for features such as `brew search`. This is deprecated in favour of using `HOMEBREW_GITHUB_API_TOKEN`.
+- `HOMEBREW_GITHUB_API_USERNAME`
+ <br>Use this username for authentication with the GitHub API, for features such as `brew search`. This is deprecated in favour of using `HOMEBREW_GITHUB_API_TOKEN`.
- * `HOMEBREW_GIT_EMAIL`:
- Set the Git author and committer name to this value.
+- `HOMEBREW_GIT_EMAIL`
+ <br>Set the Git author and committer email to this value.
- * `HOMEBREW_GIT_NAME`:
- Set the Git author and committer email to this value.
+- `HOMEBREW_GIT_NAME`
+ <br>Set the Git author and committer name to this value.
- * `HOMEBREW_INSTALL_BADGE`:
- Print this text before the installation summary of each successful build.
+- `HOMEBREW_INSTALL_BADGE`
+ <br>Print this text before the installation summary of each successful build.
- *Default:* The "Beer Mug" emoji.
+ *Default:* The "Beer Mug" emoji.
- * `HOMEBREW_LIVECHECK_WATCHLIST`:
- Use this file to get the list of default Formulae to check when no Formula argument is passed to `brew livecheck`
+- `HOMEBREW_LIVECHECK_WATCHLIST`
+ <br>Consult this file for the list of formulae to check by default when no formula argument is passed to `brew livecheck`.
- *Default:* `$HOME/.brew_livecheck_watchlist`.
+ *Default:* `$HOME/.brew_livecheck_watchlist`.
- * `HOMEBREW_LOGS`:
- Use the specified directory to store log files.
+- `HOMEBREW_LOGS`
+ <br>Use this directory to store log files.
- *Default:* macOS: `$HOME/Library/Logs/Homebrew`, Linux: `$XDG_CACHE_HOME/Homebrew/Logs` or `$HOME/.cache/Homebrew/Logs`.
+ *Default:* macOS: `$HOME/Library/Logs/Homebrew`, Linux: `$XDG_CACHE_HOME/Homebrew/Logs` or `$HOME/.cache/Homebrew/Logs`.
- * `HOMEBREW_MAKE_JOBS`:
- Use this value as the number of parallel jobs to run when building with `make`(1).
+- `HOMEBREW_MAKE_JOBS`
+ <br>Use this value as the number of parallel jobs to run when building with `make`(1).
- *Default:* The number of available CPU cores.
+ *Default:* The number of available CPU cores.
- * `HOMEBREW_NO_ANALYTICS`:
- If set, do not send analytics. See: <https://docs.brew.sh/Analytics>.
+- `HOMEBREW_NO_ANALYTICS`
+ <br>If set, do not send analytics. For more information, see: <https://docs.brew.sh/Analytics>
- * `HOMEBREW_NO_AUTO_UPDATE`:
- If set, do not automatically update before running `brew install`, `brew upgrade` or `brew tap`.
+- `HOMEBREW_NO_AUTO_UPDATE`
+ <br>If set, do not automatically update before running `brew install`, `brew upgrade` or `brew tap`.
- * `HOMEBREW_NO_BOTTLE_SOURCE_FALLBACK`:
- If set, fail on the failure of installation from a bottle rather than falling back to building from source.
+- `HOMEBREW_NO_BOTTLE_SOURCE_FALLBACK`
+ <br>If set, fail on the failure of installation from a bottle rather than falling back to building from source.
- * `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK`:
- If set, do not check for broken dependents after installing, upgrading or reinstalling formulae.
+- `HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK`
+ <br>If set, do not check for broken dependents after installing, upgrading or reinstalling formulae.
- * `HOMEBREW_NO_COLOR`:
- If set, do not print text with colour added.
+- `HOMEBREW_NO_COLOR`
+ <br>If set, do not print text with colour added.
- *Default:* `$NO_COLOR`.
+ *Default:* `$NO_COLOR`.
- * `HOMEBREW_NO_COMPAT`:
- If set, disable all use of legacy compatibility code.
+- `HOMEBREW_NO_COMPAT`
+ <br>If set, disable all use of legacy compatibility code.
- * `HOMEBREW_NO_EMOJI`:
- If set, do not print `HOMEBREW_INSTALL_BADGE` on a successful build.
+- `HOMEBREW_NO_EMOJI`
+ <br>If set, do not print `HOMEBREW_INSTALL_BADGE` on a successful build.
- *Note:* Only tries to print emoji on OS X Lion or newer.
+ *Note:* Will only try to print emoji on OS X Lion or newer.
- * `HOMEBREW_NO_GITHUB_API`:
- If set, do not use the GitHub API, e.g. for searches or fetching relevant issues on a failed install.
+- `HOMEBREW_NO_GITHUB_API`
+ <br>If set, do not use the GitHub API, e.g. for searches or fetching relevant issues after a failed install.
- * `HOMEBREW_NO_INSECURE_REDIRECT`:
- If set, forbid redirects from secure HTTPS to insecure HTTP.
+- `HOMEBREW_NO_INSECURE_REDIRECT`
+ <br>If set, forbid redirects from secure HTTPS to insecure HTTP.
- *Note:* While ensuring your downloads are fully secure, this is likely to cause from-source SourceForge, some GNU & GNOME based formulae to fail to download.
+ *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.
- * `HOMEBREW_NO_INSTALL_CLEANUP`:
- If set, `brew install`, `brew upgrade` and `brew reinstall` will never automatically cleanup installed/upgraded/reinstalled formulae or all formulae every 30 days.
+- `HOMEBREW_NO_INSTALL_CLEANUP`
+ <br>If set, `brew install`, `brew upgrade` and `brew reinstall` will never automatically cleanup installed/upgraded/reinstalled formulae or all formulae every 30 days.
- * `HOMEBREW_PRY`:
- If set, use Pry for the `brew irb` command.
+- `HOMEBREW_PRY`
+ <br>If set, use Pry for the `brew irb` command.
- * `HOMEBREW_SKIP_OR_LATER_BOTTLES`:
- If set with `HOMEBREW_DEVELOPER`, do not use bottles from older versions of macOS. This is useful in development on new macOS versions.
+- `HOMEBREW_SKIP_OR_LATER_BOTTLES`
+ <br>If set along with `HOMEBREW_DEVELOPER`, do not use bottles from older versions of macOS. This is useful in development on new macOS versions.
- * `HOMEBREW_SORBET_RUNTIME`:
- Enable runtime typechecking using Sorbet.
+- `HOMEBREW_SORBET_RUNTIME`
+ <br>If set, enable runtime typechecking using Sorbet.
- * `HOMEBREW_SVN`:
- Use this as the `svn`(1) binary.
+- `HOMEBREW_SVN`
+ <br>Use this as the `svn`(1) binary.
- *Default:* A Homebrew-built Subversion (if installed), or the system-provided binary.
+ *Default:* A Homebrew-built Subversion (if installed), or the system-provided binary.
- * `HOMEBREW_TEMP`:
- Use this path as the temporary directory for building packages. Changing this may be needed if your system temporary directory and Homebrew prefix are on different volumes, as macOS has trouble moving symlinks across volumes when the target does not yet exist. This issue typically occurs when using FileVault or custom SSD configurations.
+- `HOMEBREW_TEMP`
+ <br>Use this path as the temporary directory for building packages. Changing this may be needed if your system temporary directory and Homebrew prefix are on different volumes, as macOS has trouble moving symlinks across volumes when the target does not yet exist. This issue typically occurs when using FileVault or custom SSD configurations.
- *Default:* macOS: `/private/tmp`, Linux: `/tmp`.
+ *Default:* macOS: `/private/tmp`, Linux: `/tmp`.
- * `HOMEBREW_UPDATE_REPORT_ONLY_INSTALLED`:
- If set, `brew update` only outputs updates to installed software.
+- `HOMEBREW_UPDATE_REPORT_ONLY_INSTALLED`
+ <br>If set, `brew update` only lists updates to installed software.
- * `HOMEBREW_UPDATE_TO_TAG`:
- If set, always use the latest stable tag (even if developer commands have been run).
+- `HOMEBREW_UPDATE_TO_TAG`
+ <br>If set, always use the latest stable tag (even if developer commands have been run).
- * `HOMEBREW_VERBOSE`:
- If set, always assume `--verbose` when running commands.
+- `HOMEBREW_VERBOSE`
+ <br>If set, always assume `--verbose` when running commands.
- * `HOMEBREW_DEBUG`:
- If set, always assume `--debug` when running commands.
+- `HOMEBREW_DEBUG`
+ <br>If set, always assume `--debug` when running commands.
- * `HOMEBREW_VERBOSE_USING_DOTS`:
- If set, verbose output will print a `.` no more than once a minute. This can be useful to avoid long-running Homebrew commands being killed due to no output.
+- `HOMEBREW_VERBOSE_USING_DOTS`
+ <br>If set, verbose output will print a `.` no more than once a minute. This can be useful to avoid long-running Homebrew commands being killed due to no output.
- * `all_proxy`:
- Use this SOCKS5 proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
+- `all_proxy`
+ <br>Use this SOCKS5 proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
- * `ftp_proxy`:
- Use this FTP proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
+- `ftp_proxy`
+ <br>Use this FTP proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
- * `http_proxy`:
- Use this HTTP proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
+- `http_proxy`
+ <br>Use this HTTP proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
- * `https_proxy`:
- Use this HTTPS proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
+- `https_proxy`
+ <br>Use this HTTPS proxy for `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
- * `no_proxy`:
- A comma-separated list of hostnames and domain names excluded from proxying by `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
+- `no_proxy`
+ <br>A comma-separated list of hostnames and domain names excluded from proxying by `curl`(1), `git`(1) and `svn`(1) when downloading through Homebrew.
- * `SUDO_ASKPASS`:
- When this variable is set, the `-A` option is passed when calling `sudo`(8)
+- `SUDO_ASKPASS`
+ <br>If set, pass the `-A` option when calling `sudo`(8).
## USING HOMEBREW BEHIND A PROXY
@@ -1884,13 +1887,13 @@ Former maintainers with significant contributions include Jan Viljanen, JCount,
See our issues on GitHub:
* **Homebrew/brew**:
- <https://github.com/Homebrew/brew/issues>
+ <br><https://github.com/Homebrew/brew/issues>
* **Homebrew/homebrew-core**:
- <https://github.com/Homebrew/homebrew-core/issues>
+ <br><https://github.com/Homebrew/homebrew-core/issues>
* **Homebrew/homebrew-cask**:
- <https://github.com/Homebrew/homebrew-cask/issues>
+ <br><https://github.com/Homebrew/homebrew-cask/issues>
[SYNOPSIS]: #SYNOPSIS "SYNOPSIS"
[DESCRIPTION]: #DESCRIPTION "DESCRIPTION"
diff --git a/manpages/brew.1 b/manpages/brew.1
index 30dbbc65e4d3f58457b95b082e99a1210878036e..cab09a8e776f60c223c10391ed4d7af5f7bfd9be 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -4,7 +4,7 @@
.TH "BREW" "1" "November 2020" "Homebrew" "brew"
.
.SH "NAME"
-\fBbrew\fR \- The Missing Package Manager for macOS
+\fBbrew\fR \- The Missing Package Manager for macOS (or Linux)
.
.SH "SYNOPSIS"
\fBbrew\fR \fB\-\-version\fR
@@ -13,7 +13,7 @@
\fBbrew\fR \fIcommand\fR [\fB\-\-verbose\fR|\fB\-v\fR] [\fIoptions\fR] [\fIformula\fR] \.\.\.
.
.SH "DESCRIPTION"
-Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn\'t include with macOS\.
+Homebrew is the easiest and most flexible way to install the UNIX tools Apple didn\'t include with macOS\. It can also install software not packaged for your Linux distribution to your home directory without requiring \fBsudo\fR\.
.
.SH "ESSENTIAL COMMANDS"
For the full command list, see the \fICOMMANDS\fR section\.
@@ -21,19 +21,19 @@ For the full command list, see the \fICOMMANDS\fR section\.
.P
With \fB\-\-verbose\fR or \fB\-\-debug\fR, many commands print extra debugging information\. Note that these options should only appear after a command\.
.
-.SS "\fBinstall\fR \fIformula\fR:"
+.SS "\fBinstall\fR \fIformula\fR"
Install \fIformula\fR\.
.
.P
\fIformula\fR is usually the name of the formula to install, but it has other syntaxes which are listed in the \fISPECIFYING FORMULAE\fR section\.
.
-.SS "\fBuninstall\fR \fIformula\fR:"
+.SS "\fBuninstall\fR \fIformula\fR"
Uninstall \fIformula\fR\.
.
-.SS "\fBlist\fR:"
+.SS "\fBlist\fR"
List all installed formulae\.
.
-.SS "\fBsearch\fR (\fItext\fR|\fB/\fR\fItext\fR\fB/\fR):"
+.SS "\fBsearch\fR [\fItext\fR|\fB/\fR\fItext\fR\fB/\fR]"
Perform a substring search of cask tokens and formula names for \fItext\fR\. If \fItext\fR is flanked by slashes, it is interpreted as a regular expression\. The search for \fItext\fR is extended online to \fBhomebrew/core\fR and \fBhomebrew/cask\fR\. If no search term is provided, all locally available formulae are listed\.
.
.SH "COMMANDS"
@@ -46,7 +46,7 @@ Control Homebrew\'s anonymous aggregate user behaviour analytics\. Read more at
Display the current state of Homebrew\'s analytics\.
.
.P
-\fBbrew analytics\fR [\fBon\fR|\fBoff\fR]
+\fBbrew analytics\fR (\fBon\fR|\fBoff\fR)
Turn Homebrew\'s analytics on or off respectively\.
.
.P
@@ -66,116 +66,114 @@ Homebrew Cask provides a friendly CLI workflow for the administration of macOS a
.P
Commands:
.
-.IP "\(bu" 4
+.TP
\fB\-\-cache\fR
.
.br
Display the file used to cache a \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBaudit\fR
.
.br
Check \fIcask\fR for Homebrew coding style violations\.
.
-.IP "\(bu" 4
+.TP
\fBcat\fR
.
.br
Dump raw source of a \fIcask\fR to the standard output\.
.
-.IP "\(bu" 4
+.TP
\fBcreate\fR
.
.br
Creates the given \fIcask\fR and opens it in an editor\.
.
-.IP "\(bu" 4
+.TP
\fBdoctor\fR
.
.br
Checks for configuration issues\.
.
-.IP "\(bu" 4
+.TP
\fBedit\fR
.
.br
Open the given \fIcask\fR for editing\.
.
-.IP "\(bu" 4
+.TP
\fBfetch\fR
.
.br
Downloads remote application files to local cache\.
.
-.IP "\(bu" 4
+.TP
\fBhelp\fR
.
.br
Print help for \fBcask\fR commands\.
.
-.IP "\(bu" 4
+.TP
\fBhome\fR
.
.br
Opens the homepage of the given \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBinfo\fR
.
.br
Displays information about the given \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBinstall\fR
.
.br
Installs the given \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBlist\fR
.
.br
Lists installed casks or the casks provided in the arguments\.
.
-.IP "\(bu" 4
+.TP
\fBoutdated\fR
.
.br
List the outdated installed casks\.
.
-.IP "\(bu" 4
+.TP
\fBreinstall\fR
.
.br
Reinstalls the given \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBstyle\fR
.
.br
Checks style of the given \fIcask\fR using RuboCop\.
.
-.IP "\(bu" 4
+.TP
\fBuninstall\fR
.
.br
Uninstalls the given \fIcask\fR\.
.
-.IP "\(bu" 4
+.TP
\fBupgrade\fR
.
.br
Upgrades all outdated casks or the specified casks\.
.
-.IP "\(bu" 4
+.TP
\fBzap\fR
.
.br
Zaps all files associated with the given \fIcask\fR\.
.
-.IP "" 0
-.
.P
See also: \fBman brew\fR
.
@@ -480,7 +478,7 @@ Treat all named arguments as casks\.
.
.TP
\fB\-\-[no\-]binaries\fR
-Disable/enable linking of helper executables\. Default: enabled
+Disable/enable linking of helper executables (default: enabled)\.
.
.TP
\fB\-\-require\-sha\fR
@@ -488,7 +486,7 @@ Require all casks to have a checksum\.
.
.TP
\fB\-\-[no\-]quarantine\fR
-Disable/enable quarantining of downloads\. Default: enabled
+Disable/enable quarantining of downloads (default: enabled)\.
.
.TP
\fB\-\-skip\-cask\-deps\fR
@@ -512,15 +510,15 @@ List files which would be linked or deleted by \fBbrew link \-\-overwrite\fR wit
\fB\-f\fR, \fB\-\-force\fR
Allow keg\-only formulae to be linked\.
.
-.SS "\fBlist\fR, \fBls\fR [\fIoptions\fR] [\fIformula|cask\fR]"
-List all installed formulae or casks
+.SS "\fBlist\fR, \fBls\fR [\fIoptions\fR] [\fIformula\fR|\fIcask\fR]"
+List all installed formulae and casks\.
.
.P
If \fIformula\fR is provided, summarise the paths within its current keg\.
.
.TP
\fB\-\-formula\fR
-List only formulae\. \fBThis is the default action on non TTY\.\fR
+List only formulae\. This is the default when output is not to a terminal\.
.
.TP
\fB\-\-cask\fR
@@ -631,11 +629,11 @@ Include detailed version information\.
.
.TP
\fB\-\-formula\fR
-Only output outdated formulae\.
+List only outdated formulae\.
.
.TP
\fB\-\-cask\fR
-Only output outdated casks\.
+List only outdated casks\.
.
.TP
\fB\-\-json\fR
@@ -714,7 +712,7 @@ Treat all named arguments as casks\.
.
.TP
\fB\-\-[no\-]binaries\fR
-Disable/enable linking of helper executables\. Default: enabled
+Disable/enable linking of helper executables (default: enabled)\.
.
.TP
\fB\-\-require\-sha\fR
@@ -722,7 +720,7 @@ Require all casks to have a checksum\.
.
.TP
\fB\-\-[no\-]quarantine\fR
-Disable/enable quarantining of downloads\. Default: enabled
+Disable/enable quarantining of downloads (default: enabled)\.
.
.TP
\fB\-\-skip\-cask\-deps\fR
@@ -748,7 +746,7 @@ Search for formulae with a description matching \fItext\fR and casks with a name
.
.TP
\fB\-\-pull\-request\fR
-Search for GitHub pull requests for \fItext\fR\.
+Search for GitHub pull requests containing \fItext\fR\.
.
.TP
\fB\-\-macports\fR
@@ -931,7 +929,7 @@ Treat all named arguments as casks\. If no named arguments are specified, upgrad
.
.TP
\fB\-\-[no\-]binaries\fR
-Disable/enable linking of helper executables\. Default: enabled
+Disable/enable linking of helper executables (default: enabled)\.
.
.TP
\fB\-\-require\-sha\fR
@@ -939,7 +937,7 @@ Require all casks to have a checksum\.
.
.TP
\fB\-\-[no\-]quarantine\fR
-Disable/enable quarantining of downloads\. Default: enabled
+Disable/enable quarantining of downloads (default: enabled)\.
.
.TP
\fB\-\-skip\-cask\-deps\fR
@@ -976,7 +974,7 @@ Include all formulae that specify \fIformula\fR as \fB:optional\fR type dependen
\fB\-\-skip\-recommended\fR
Skip all formulae that specify \fIformula\fR as \fB:recommended\fR type dependency\.
.
-.SS "\fB\-\-cache\fR [\fIoptions\fR] [\fIformula|cask\fR]"
+.SS "\fB\-\-cache\fR [\fIoptions\fR] [\fIformula\fR|\fIcask\fR]"
Display Homebrew\'s download cache\. See also \fBHOMEBREW_CACHE\fR\.
.
.P
@@ -1078,7 +1076,7 @@ Prefix every line of output with the file or formula name being audited, to make
.
.TP
\fB\-\-skip\-style\fR
-Skip running non\-RuboCop style checks\. Useful if you plan on running \fBbrew style\fR separately\. Default unless a formula is specified by name
+Skip running non\-RuboCop style checks\. Useful if you plan on running \fBbrew style\fR separately\. Enabled by default unless a formula is specified by name\.
.
.TP
\fB\-D\fR, \fB\-\-audit\-debug\fR
@@ -1146,7 +1144,7 @@ Display out\-of\-date brew formulae and the latest version available\. Also disp
\fB\-\-limit\fR
Limit number of package results returned\.
.
-.SS "\fBbump\-cask\-pr\fR [\fIoptions\fR] [\fIcask\fR]"
+.SS "\fBbump\-cask\-pr\fR [\fIoptions\fR] \fIcask\fR"
Create a pull request to update \fIcask\fR with a new version\.
.
.P
@@ -1281,7 +1279,7 @@ Specify the new git commit \fIrevision\fR corresponding to the specified \fItag\
.
.TP
\fB\-f\fR, \fB\-\-force\fR
-Ignore duplicate open PRs\. Remove all mirrors if \-\-mirror= was not specified\.
+Ignore duplicate open PRs\. Remove all mirrors if \fB\-\-mirror\fR was not specified\.
.
.SS "\fBbump\-revision\fR [\fIoptions\fR] \fIformula\fR [\fIformula\fR \.\.\.]"
Create a commit to increment the revision of \fIformula\fR\. If no revision is present, "revision 1" will be added\.
@@ -1369,7 +1367,7 @@ Generate the new formula within the given tap, specified as \fIuser\fR\fB/\fR\fI
.
.TP
\fB\-f\fR, \fB\-\-force\fR
-Ignore errors for disallowed formula names and named that shadow aliases\.
+Ignore errors for disallowed formula names and names that shadow aliases\.
.
.SS "\fBdispatch\-build\-bottle\fR [\fIoptions\fR] \fIformula\fR [\fIformula\fR \.\.\.]"
Build bottles for these formulae with GitHub Actions\.
@@ -1509,7 +1507,7 @@ Pull requests must have this label\.
.
.TP
\fB\-\-without\-labels\fR
-Pull requests must not have these labels (default: \fBdo not merge\fR, \fBnew formula\fR, \fBautomerge\-skip\fR)\.
+Pull requests must not have these labels (default: \fBdo not merge\fR, \fBnew formula\fR, \fBautomerge\-skip\fR, \fBlinux\-only\fR)\.
.
.TP
\fB\-\-without\-approval\fR
@@ -1710,15 +1708,15 @@ Generate the template files for a new tap\.
.
.TP
\fB\-\-no\-git\fR
-Don\'t initialize a git repository for the tap\.
+Don\'t initialize a Git repository for the tap\.
.
.TP
\fB\-\-pull\-label\fR
-Label name for pull requests ready to be pulled (default \fBpr\-pull\fR)\.
+Label name for pull requests ready to be pulled (default: \fBpr\-pull\fR)\.
.
.TP
\fB\-\-branch\fR
-Initialize git repository with the specified branch name (default \fBmain\fR)\.
+Initialize Git repository with the specified branch name (default: \fBmain\fR)\.
.
.SS "\fBtest\fR [\fIoptions\fR] \fIformula\fR"
Run the test method provided by an installed formula\. There is no standard output or return code, but generally it should notify the user if something is wrong with the installed formula\.
@@ -1875,64 +1873,64 @@ Install and commit Homebrew\'s vendored gems\.
These options are applicable to subcommands accepting a \fB\-\-cask\fR flag and all \fBcask\fR commands\.
.
.TP
-\fB\-\-appdir=\fR
-Target location for Applications\. Default: \fB/Applications\fR
+\fB\-\-appdir\fR
+Target location for Applications (default: \fB/Applications\fR)\.
.
.TP
-\fB\-\-colorpickerdir=\fR
-Target location for Color Pickers\. Default: \fB~/Library/ColorPickers\fR
+\fB\-\-colorpickerdir\fR
+Target location for Color Pickers (default: \fB~/Library/ColorPickers\fR)\.
.
.TP
-\fB\-\-prefpanedir=\fR
-Target location for Preference Panes\. Default: \fB~/Library/PreferencePanes\fR
+\fB\-\-prefpanedir\fR
+Target location for Preference Panes (default: \fB~/Library/PreferencePanes\fR)\.
.
.TP
-\fB\-\-qlplugindir=\fR
-Target location for QuickLook Plugins\. Default: \fB~/Library/QuickLook\fR
+\fB\-\-qlplugindir\fR
+Target location for QuickLook Plugins (default: \fB~/Library/QuickLook\fR)\.
.
.TP
-\fB\-\-mdimporterdir=\fR
-Target location for Spotlight Plugins\. Default: \fB~/Library/Spotlight\fR
+\fB\-\-mdimporterdir\fR
+Target location for Spotlight Plugins (default: \fB~/Library/Spotlight\fR)\.
.
.TP
-\fB\-\-dictionarydir=\fR
-Target location for Dictionaries\. Default: \fB~/Library/Dictionaries\fR
+\fB\-\-dictionarydir\fR
+Target location for Dictionaries (default: \fB~/Library/Dictionaries\fR)\.
.
.TP
-\fB\-\-fontdir=\fR
-Target location for Fonts\. Default: \fB~/Library/Fonts\fR
+\fB\-\-fontdir\fR
+Target location for Fonts (default: \fB~/Library/Fonts\fR)\.
.
.TP
-\fB\-\-servicedir=\fR
-Target location for Services\. Default: \fB~/Library/Services\fR
+\fB\-\-servicedir\fR
+Target location for Services (default: \fB~/Library/Services\fR)\.
.
.TP
-\fB\-\-input_methoddir=\fR
-Target location for Input Methods\. Default: \fB~/Library/Input Methods\fR
+\fB\-\-input_methoddir\fR
+Target location for Input Methods (default: \fB~/Library/Input Methods\fR)\.
.
.TP
-\fB\-\-internet_plugindir=\fR
-Target location for Internet Plugins\. Default: \fB~/Library/Internet Plug\-Ins\fR
+\fB\-\-internet_plugindir\fR
+Target location for Internet Plugins (default: \fB~/Library/Internet Plug\-Ins\fR)\.
.
.TP
-\fB\-\-audio_unit_plugindir=\fR
-Target location for Audio Unit Plugins\. Default: \fB~/Library/Audio/Plug\-Ins/Components\fR
+\fB\-\-audio_unit_plugindir\fR
+Target location for Audio Unit Plugins (default: \fB~/Library/Audio/Plug\-Ins/Components\fR)\.
.
.TP
-\fB\-\-vst_plugindir=\fR
-Target location for VST Plugins\. Default: \fB~/Library/Audio/Plug\-Ins/VST\fR
+\fB\-\-vst_plugindir\fR
+Target location for VST Plugins (default: \fB~/Library/Audio/Plug\-Ins/VST\fR)\.
.
.TP
-\fB\-\-vst3_plugindir=\fR
-Target location for VST3 Plugins\. Default: \fB~/Library/Audio/Plug\-Ins/VST3\fR
+\fB\-\-vst3_plugindir\fR
+Target location for VST3 Plugins (default: \fB~/Library/Audio/Plug\-Ins/VST3\fR)\.
.
.TP
-\fB\-\-screen_saverdir=\fR
-Target location for Screen Savers\. Default: \fB~/Library/Screen Savers\fR
+\fB\-\-screen_saverdir\fR
+Target location for Screen Savers (default: \fB~/Library/Screen Savers\fR)\.
.
.TP
\fB\-\-language\fR
-Set language of the Cask to install\. The first matching language is used, otherwise the default language on the Cask\. The default value is the \fBlanguage of your system\fR
+Comma\-separated list of language codes to prefer for cask installation\. The first matching language is used, otherwise it reverts to the cask\'s default language\. The default value is the language of your system\.
.
.SH "GLOBAL OPTIONS"
These options are applicable across multiple subcommands\.
@@ -1963,14 +1961,17 @@ Bundler for non\-Ruby dependencies from Homebrew, Homebrew Cask, Mac App Store a
Install and upgrade (by default) all dependencies from the \fBBrewfile\fR\.
.
.P
-You can skip the installation of dependencies by adding space\-separated values to one or more of the following environment variables: \fBHOMEBREW_BUNDLE_BREW_SKIP\fR, \fBHOMEBREW_BUNDLE_CASK_SKIP\fR, \fBHOMEBREW_BUNDLE_MAS_SKIP\fR, \fBHOMEBREW_BUNDLE_WHALEBREW_SKIP\fR, \fBHOMEBREW_BUNDLE_TAP_SKIP\fR
+You can specify the \fBBrewfile\fR location using \fB\-\-file\fR or by setting the \fBHOMEBREW_BUNDLE_FILE\fR environment variable\.
+.
+.P
+You can skip the installation of dependencies by adding space\-separated values to one or more of the following environment variables: \fBHOMEBREW_BUNDLE_BREW_SKIP\fR, \fBHOMEBREW_BUNDLE_CASK_SKIP\fR, \fBHOMEBREW_BUNDLE_MAS_SKIP\fR, \fBHOMEBREW_BUNDLE_WHALEBREW_SKIP\fR, \fBHOMEBREW_BUNDLE_TAP_SKIP\fR\.
.
.P
\fBbrew bundle\fR will output a \fBBrewfile\.lock\.json\fR in the same directory as the \fBBrewfile\fR if all dependencies are installed successfully\. This contains dependency and system status information which can be useful in debugging \fBbrew bundle\fR failures and replicating a "last known good build" state\. You can opt\-out of this behaviour by setting the \fBHOMEBREW_BUNDLE_NO_LOCK\fR environment variable or passing the \fB\-\-no\-lock\fR option\. You may wish to check this file into the same version control system as your \fBBrewfile\fR (or ensure your version control system ignores it if you\'d prefer to rely on debugging information from a local machine)\.
.
.P
\fBbrew bundle dump\fR
- Write all installed casks/formulae/images/taps into a \fBBrewfile\fR\.
+ Write all installed casks/formulae/images/taps into a \fBBrewfile\fR in the current directory\.
.
.P
\fBbrew bundle cleanup\fR
@@ -1981,14 +1982,14 @@ This workflow is useful for maintainers or testers who regularly install lots of
.
.P
\fBbrew bundle check\fR
- Check if all dependencies are installed from the \fBBrewfile\fR \.
+ Check if all dependencies are installed from the \fBBrewfile\fR\.
.
.P
This provides a successful exit code if everything is up\-to\-date, making it useful for scripting\.
.
.P
\fBbrew bundle list\fR
- List all dependencies present in a \fBBrewfile\fR\.
+ List all dependencies present in the \fBBrewfile\fR\.
.
.P
By default, only Homebrew dependencies are listed\.
@@ -2098,79 +2099,79 @@ If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boo
\fB\-\-all\fR
Run \fIsubcommand\fR on all services\.
.
-.SS "\fBtest\-bot\fR [\fIoptions\fR] [\fIformula\fR]:"
-Tests the full lifecycle of a Homebrew change to a tap (Git repository)\. For example, for a GitHub Actions pull request that changes a formula \fBbrew test\-bot\fR will ensure the system is cleaned and setup to test the formula, install the formula, run various tests and checks on it, bottle (package) the binaries and test formulae that depend on it to ensure they aren\'t broken by these changes\.
+.SS "\fBtest\-bot\fR [\fIoptions\fR] [\fIformula\fR]"
+Tests the full lifecycle of a Homebrew change to a tap (Git repository)\. For example, for a GitHub Actions pull request that changes a formula \fBbrew test\-bot\fR will ensure the system is cleaned and set up to test the formula, install the formula, run various tests and checks on it, bottle (package) the binaries and test formulae that depend on it to ensure they aren\'t broken by these changes\.
.
.P
Only supports GitHub Actions as a CI provider\. This is because Homebrew uses GitHub Actions and it\'s freely available for public and private use with macOS and Linux workers\.
.
.TP
\fB\-\-dry\-run\fR
-print what would be done rather than doing it\.
+Print what would be done rather than doing it\.
.
.TP
\fB\-\-cleanup\fR
-clean all state from the Homebrew directory\. Use with care!
+Clean all state from the Homebrew directory\. Use with care!
.
.TP
\fB\-\-skip\-setup\fR
-don\'t check if the local system is set up correctly\.
+Don\'t check if the local system is set up correctly\.
.
.TP
\fB\-\-keep\-old\fR
-run \fBbrew bottle \-\-keep\-old\fR to build new bottles for a single platform\.
+Run \fBbrew bottle \-\-keep\-old\fR to build new bottles for a single platform\.
.
.TP
\fB\-\-skip\-relocation\fR
-run \fBbrew bottle \-\-skip\-relocation\fR to build new bottles that don\'t require relocation\.
+Run \fBbrew bottle \-\-skip\-relocation\fR to build new bottles that don\'t require relocation\.
.
.TP
\fB\-\-local\fR
-ask Homebrew to write verbose logs under \fB\./logs/\fR and set \fB$HOME\fR to \fB\./home/\fR
+Ask Homebrew to write verbose logs under \fB\./logs/\fR and set \fB$HOME\fR to \fB\./home/\fR
.
.TP
\fB\-\-tap\fR
-use the \fBgit\fR repository of the given tap\. Defaults to the core tap for syntax checking\.
+Use the Git repository of the given tap\. Defaults to the core tap for syntax checking\.
.
.TP
\fB\-\-fail\-fast\fR
-immediately exit on a failing step\.
+Immediately exit on a failing step\.
.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
-print test step output in real time\. Has the side effect of passing output as raw bytes instead of re\-encoding in UTF\-8\.
+Print test step output in real time\. Has the side effect of passing output as raw bytes instead of re\-encoding in UTF\-8\.
.
.TP
\fB\-\-test\-default\-formula\fR
-use a default testing formula when not building a tap and no other formulae are specified\.
+Use a default testing formula when not building a tap and no other formulae are specified\.
.
.TP
\fB\-\-bintray\-org\fR
-upload to the given Bintray organisation\.
+Upload bottles to the given Bintray organisation\.
.
.TP
\fB\-\-root\-url\fR
-use the specified \fIURL\fR as the root of the bottle\'s URL instead of Homebrew\'s default\.
+Use the specified \fIURL\fR as the root of the bottle\'s URL instead of Homebrew\'s default\.
.
.TP
\fB\-\-git\-name\fR
-set the Git author/committer names to the given name\.
+Set the Git author/committer names to the given name\.
.
.TP
\fB\-\-git\-email\fR
-set the Git author/committer email to the given email\.
+Set the Git author/committer email to the given email\.
.
.TP
\fB\-\-ci\-upload\fR
-use the Homebrew CI bottle upload options\.
+Use the Homebrew CI bottle upload options\.
.
.TP
\fB\-\-publish\fR
-publish the uploaded bottles\.
+Publish the uploaded bottles\.
.
.TP
\fB\-\-skip\-recursive\-dependents\fR
-only test the direct dependents\.
+Only test the direct dependents\.
.
.TP
\fB\-\-only\-cleanup\-before\fR
@@ -2221,17 +2222,23 @@ Note that environment variables must have a value set to be detected\. For examp
.
.TP
\fBHOMEBREW_ARCH\fR
-Linux only: Pass the set value to a type name representing the compiler\'s \fB\-march\fR option\.
+.
+.br
+Linux only: Pass this value to a type name representing the compiler\'s \fB\-march\fR option\.
.
.IP
\fIDefault:\fR \fBnative\fR\.
.
.TP
\fBHOMEBREW_ARTIFACT_DOMAIN\fR
+.
+.br
Prefix all download URLs, including those for bottles, with this variable\. For example, \fBHOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080\fR will cause a formula with the URL \fBhttps://example\.com/foo\.tar\.gz\fR to instead download from \fBhttp://localhost:8080/example\.com/foo\.tar\.gz\fR\.
.
.TP
\fBHOMEBREW_AUTO_UPDATE_SECS\fR
+.
+.br
Automatically check for updates once per this seconds interval\.
.
.IP
@@ -2239,39 +2246,53 @@ Automatically check for updates once per this seconds interval\.
.
.TP
\fBHOMEBREW_BAT\fR
+.
+.br
If set, use \fBbat\fR for the \fBbrew cat\fR command\.
.
.TP
\fBHOMEBREW_BAT_CONFIG_PATH\fR
-Use the \fBbat\fR configuration file\. For example, \fBHOMEBREW_BAT=$HOME/\.bat/config\fR\.
+.
+.br
+Use this as the \fBbat\fR configuration file\.
.
.IP
-\fIDefault:\fR $HOME/\.bat/config
+\fIDefault:\fR \fB$HOME/\.bat/config\fR\.
.
.TP
\fBHOMEBREW_BINTRAY_KEY\fR
+.
+.br
Use this API key when accessing the Bintray API (where bottles are stored)\.
.
.TP
\fBHOMEBREW_BINTRAY_USER\fR
+.
+.br
Use this username when accessing the Bintray API (where bottles are stored)\.
.
.TP
\fBHOMEBREW_BOTTLE_DOMAIN\fR
-Use the specified URL as the download mirror for bottles\. For example, \fBHOMEBREW_BOTTLE_DOMAIN=http://localhost:8080\fR will cause all bottles to download from the prefix \fBhttp://localhost:8080/\fR\.
+.
+.br
+Use this URL as the download mirror for bottles\. For example, \fBHOMEBREW_BOTTLE_DOMAIN=http://localhost:8080\fR will cause all bottles to download from the prefix \fBhttp://localhost:8080/\fR\.
.
.IP
\fIDefault:\fR macOS: \fBhttps://homebrew\.bintray\.com/\fR, Linux: \fBhttps://linuxbrew\.bintray\.com/\fR\.
.
.TP
\fBHOMEBREW_BREW_GIT_REMOTE\fR
-Use the specified URL as the Homebrew/brew \fBgit\fR(1) remote\.
+.
+.br
+Use this URL as the Homebrew/brew \fBgit\fR(1) remote\.
.
.IP
\fIDefault:\fR \fBhttps://github\.com/Homebrew/brew\fR\.
.
.TP
\fBHOMEBREW_BROWSER\fR
+.
+.br
Use this as the browser when opening project homepages\.
.
.IP
@@ -2279,20 +2300,26 @@ Use this as the browser when opening project homepages\.
.
.TP
\fBHOMEBREW_CACHE\fR
-Use the specified directory as the download cache\.
+.
+.br
+Use this directory as the download cache\.
.
.IP
\fIDefault:\fR macOS: \fB$HOME/Library/Caches/Homebrew\fR, Linux: \fB$XDG_CACHE_HOME/Homebrew\fR or \fB$HOME/\.cache/Homebrew\fR\.
.
.TP
\fBHOMEBREW_CASK_OPTS\fR
-Options which should be used for all \fBcask\fR commands\. All \fB\-\-*dir\fR options, \fB\-\-language\fR, \fB\-\-require\-sha\fR, \fB\-\-no\-quarantine\fR and \fB\-\-no\-binaries\fR are supported\. For example, you might add something like the following to your ~/\.profile, ~/\.bash_profile, or ~/\.zshenv:
.
-.P
-\fBexport HOMEBREW_CASK_OPTS=\'\-\-appdir=~/Applications \-\-fontdir=/Library/Fonts\'\fR
+.br
+Append these options to all \fBcask\fR commands\. All \fB\-\-*dir\fR options, \fB\-\-language\fR, \fB\-\-require\-sha\fR, \fB\-\-no\-quarantine\fR and \fB\-\-no\-binaries\fR are supported\. For example, you might add something like the following to your \fB~/\.profile\fR, \fB~/\.bash_profile\fR, or \fB~/\.zshenv\fR:
+.
+.IP
+\fBexport HOMEBREW_CASK_OPTS="\-\-appdir=~/Applications \-\-fontdir=/Library/Fonts"\fR
.
.TP
\fBHOMEBREW_CLEANUP_MAX_AGE_DAYS\fR
+.
+.br
Cleanup all cached files older than this many days\.
.
.IP
@@ -2300,21 +2327,29 @@ Cleanup all cached files older than this many days\.
.
.TP
\fBHOMEBREW_COLOR\fR
+.
+.br
If set, force colour output on non\-TTY outputs\.
.
.TP
\fBHOMEBREW_CORE_GIT_REMOTE\fR
-Use the specified URL as the Homebrew/homebrew\-core \fBgit\fR(1) remote\.
+.
+.br
+Use this URL as the Homebrew/homebrew\-core \fBgit\fR(1) remote\.
.
.IP
\fIDefault:\fR macOS: \fBhttps://github\.com/Homebrew/homebrew\-core\fR, Linux: \fBhttps://github\.com/Homebrew/linuxbrew\-core\fR\.
.
.TP
\fBHOMEBREW_CURLRC\fR
+.
+.br
If set, do not pass \fB\-\-disable\fR when invoking \fBcurl\fR(1), which disables the use of \fBcurlrc\fR\.
.
.TP
\fBHOMEBREW_CURL_RETRIES\fR
+.
+.br
Pass the given retry count to \fB\-\-retry\fR when invoking \fBcurl\fR(1)\.
.
.IP
@@ -2322,18 +2357,26 @@ Pass the given retry count to \fB\-\-retry\fR when invoking \fBcurl\fR(1)\.
.
.TP
\fBHOMEBREW_CURL_VERBOSE\fR
+.
+.br
If set, pass \fB\-\-verbose\fR when invoking \fBcurl\fR(1)\.
.
.TP
\fBHOMEBREW_DEVELOPER\fR
+.
+.br
If set, tweak behaviour to be more relevant for Homebrew developers (active or budding) by e\.g\. turning warnings into errors\.
.
.TP
\fBHOMEBREW_DISABLE_LOAD_FORMULA\fR
+.
+.br
If set, refuse to load formulae\. This is useful when formulae are not trusted (such as in pull requests)\.
.
.TP
\fBHOMEBREW_DISPLAY\fR
+.
+.br
Use this X11 display when opening a page in a browser, for example with \fBbrew home\fR\. Primarily useful on Linux\.
.
.IP
@@ -2341,10 +2384,14 @@ Use this X11 display when opening a page in a browser, for example with \fBbrew
.
.TP
\fBHOMEBREW_DISPLAY_INSTALL_TIMES\fR
+.
+.br
If set, print install times for each formula at the end of the run\.
.
.TP
\fBHOMEBREW_EDITOR\fR
+.
+.br
Use this editor when editing a single formula, or several formulae in the same directory\.
.
.IP
@@ -2355,6 +2402,8 @@ Use this editor when editing a single formula, or several formulae in the same d
.
.TP
\fBHOMEBREW_FAIL_LOG_LINES\fR
+.
+.br
Output this many lines of output on formula \fBsystem\fR failures\.
.
.IP
@@ -2362,49 +2411,71 @@ Output this many lines of output on formula \fBsystem\fR failures\.
.
.TP
\fBHOMEBREW_FORBIDDEN_LICENSES\fR
-A space\-separated list of licenses\. Homebrew will refuse to install a formula if that formula or any of its dependencies has a license on this list\.
+.
+.br
+A space\-separated list of licenses\. Homebrew will refuse to install a formula if it or any of its dependencies has a license on this list\.
.
.TP
\fBHOMEBREW_FORCE_BREWED_CURL\fR
+.
+.br
If set, always use a Homebrew\-installed \fBcurl\fR(1) rather than the system version\. Automatically set if the system version of \fBcurl\fR is too old\.
.
.TP
\fBHOMEBREW_FORCE_BREWED_GIT\fR
+.
+.br
If set, always use a Homebrew\-installed \fBgit\fR(1) rather than the system version\. Automatically set if the system version of \fBgit\fR is too old\.
.
.TP
\fBHOMEBREW_FORCE_HOMEBREW_ON_LINUX\fR
+.
+.br
If set, running Homebrew on Linux will use URLs for macOS\. This is useful when merging pull requests for macOS while on Linux\.
.
.TP
\fBHOMEBREW_FORCE_VENDOR_RUBY\fR
+.
+.br
If set, always use Homebrew\'s vendored, relocatable Ruby version even if the system version of Ruby is new enough\.
.
.TP
\fBHOMEBREW_GITHUB_API_PASSWORD\fR
+.
+.br
Use this password for authentication with the GitHub API, for features such as \fBbrew search\fR\. This is deprecated in favour of using \fBHOMEBREW_GITHUB_API_TOKEN\fR\.
.
.TP
\fBHOMEBREW_GITHUB_API_TOKEN\fR
-Use this personal access token for the GitHub API, for features such as \fBbrew search\fR\. You can create one at \fIhttps://github\.com/settings/tokens\fR\. If set, GitHub will allow you a greater number of API requests\. For more information, see: \fIhttps://docs\.github\.com/en/rest/overview/resources\-in\-the\-rest\-api#rate\-limiting\fR\.
+.
+.br
+Use this personal access token for the GitHub API, for features such as \fBbrew search\fR\. You can create one at \fIhttps://github\.com/settings/tokens\fR\. If set, GitHub will allow you a greater number of API requests\. For more information, see: \fIhttps://docs\.github\.com/en/rest/overview/resources\-in\-the\-rest\-api#rate\-limiting\fR
.
.IP
\fINote:\fR Homebrew doesn\'t require permissions for any of the scopes, but some developer commands may require additional permissions\.
.
.TP
\fBHOMEBREW_GITHUB_API_USERNAME\fR
+.
+.br
Use this username for authentication with the GitHub API, for features such as \fBbrew search\fR\. This is deprecated in favour of using \fBHOMEBREW_GITHUB_API_TOKEN\fR\.
.
.TP
\fBHOMEBREW_GIT_EMAIL\fR
-Set the Git author and committer name to this value\.
+.
+.br
+Set the Git author and committer email to this value\.
.
.TP
\fBHOMEBREW_GIT_NAME\fR
-Set the Git author and committer email to this value\.
+.
+.br
+Set the Git author and committer name to this value\.
.
.TP
\fBHOMEBREW_INSTALL_BADGE\fR
+.
+.br
Print this text before the installation summary of each successful build\.
.
.IP
@@ -2412,20 +2483,26 @@ Print this text before the installation summary of each successful build\.
.
.TP
\fBHOMEBREW_LIVECHECK_WATCHLIST\fR
-Use this file to get the list of default Formulae to check when no Formula argument is passed to \fBbrew livecheck\fR
+.
+.br
+Consult this file for the list of formulae to check by default when no formula argument is passed to \fBbrew livecheck\fR\.
.
.IP
\fIDefault:\fR \fB$HOME/\.brew_livecheck_watchlist\fR\.
.
.TP
\fBHOMEBREW_LOGS\fR
-Use the specified directory to store log files\.
+.
+.br
+Use this directory to store log files\.
.
.IP
\fIDefault:\fR macOS: \fB$HOME/Library/Logs/Homebrew\fR, Linux: \fB$XDG_CACHE_HOME/Homebrew/Logs\fR or \fB$HOME/\.cache/Homebrew/Logs\fR\.
.
.TP
\fBHOMEBREW_MAKE_JOBS\fR
+.
+.br
Use this value as the number of parallel jobs to run when building with \fBmake\fR(1)\.
.
.IP
@@ -2433,22 +2510,32 @@ Use this value as the number of parallel jobs to run when building with \fBmake\
.
.TP
\fBHOMEBREW_NO_ANALYTICS\fR
-If set, do not send analytics\. See: \fIhttps://docs\.brew\.sh/Analytics\fR\.
+.
+.br
+If set, do not send analytics\. For more information, see: \fIhttps://docs\.brew\.sh/Analytics\fR
.
.TP
\fBHOMEBREW_NO_AUTO_UPDATE\fR
+.
+.br
If set, do not automatically update before running \fBbrew install\fR, \fBbrew upgrade\fR or \fBbrew tap\fR\.
.
.TP
\fBHOMEBREW_NO_BOTTLE_SOURCE_FALLBACK\fR
+.
+.br
If set, fail on the failure of installation from a bottle rather than falling back to building from source\.
.
.TP
\fBHOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK\fR
+.
+.br
If set, do not check for broken dependents after installing, upgrading or reinstalling formulae\.
.
.TP
\fBHOMEBREW_NO_COLOR\fR
+.
+.br
If set, do not print text with colour added\.
.
.IP
@@ -2456,44 +2543,62 @@ If set, do not print text with colour added\.
.
.TP
\fBHOMEBREW_NO_COMPAT\fR
+.
+.br
If set, disable all use of legacy compatibility code\.
.
.TP
\fBHOMEBREW_NO_EMOJI\fR
+.
+.br
If set, do not print \fBHOMEBREW_INSTALL_BADGE\fR on a successful build\.
.
.IP
-\fINote:\fR Only tries to print emoji on OS X Lion or newer\.
+\fINote:\fR Will only try to print emoji on OS X Lion or newer\.
.
.TP
\fBHOMEBREW_NO_GITHUB_API\fR
-If set, do not use the GitHub API, e\.g\. for searches or fetching relevant issues on a failed install\.
+.
+.br
+If set, do not use the GitHub API, e\.g\. for searches or fetching relevant issues after a failed install\.
.
.TP
\fBHOMEBREW_NO_INSECURE_REDIRECT\fR
+.
+.br
If set, forbid redirects from secure HTTPS to insecure HTTP\.
.
.IP
-\fINote:\fR While ensuring your downloads are fully secure, this is likely to cause from\-source SourceForge, some GNU & GNOME based formulae to fail to download\.
+\fINote:\fR While ensuring your downloads are fully secure, this is likely to cause from\-source SourceForge, some GNU & GNOME\-hosted formulae to fail to download\.
.
.TP
\fBHOMEBREW_NO_INSTALL_CLEANUP\fR
+.
+.br
If set, \fBbrew install\fR, \fBbrew upgrade\fR and \fBbrew reinstall\fR will never automatically cleanup installed/upgraded/reinstalled formulae or all formulae every 30 days\.
.
.TP
\fBHOMEBREW_PRY\fR
+.
+.br
If set, use Pry for the \fBbrew irb\fR command\.
.
.TP
\fBHOMEBREW_SKIP_OR_LATER_BOTTLES\fR
-If set with \fBHOMEBREW_DEVELOPER\fR, do not use bottles from older versions of macOS\. This is useful in development on new macOS versions\.
+.
+.br
+If set along with \fBHOMEBREW_DEVELOPER\fR, do not use bottles from older versions of macOS\. This is useful in development on new macOS versions\.
.
.TP
\fBHOMEBREW_SORBET_RUNTIME\fR
-Enable runtime typechecking using Sorbet\.
+.
+.br
+If set, enable runtime typechecking using Sorbet\.
.
.TP
\fBHOMEBREW_SVN\fR
+.
+.br
Use this as the \fBsvn\fR(1) binary\.
.
.IP
@@ -2501,6 +2606,8 @@ Use this as the \fBsvn\fR(1) binary\.
.
.TP
\fBHOMEBREW_TEMP\fR
+.
+.br
Use this path as the temporary directory for building packages\. Changing this may be needed if your system temporary directory and Homebrew prefix are on different volumes, as macOS has trouble moving symlinks across volumes when the target does not yet exist\. This issue typically occurs when using FileVault or custom SSD configurations\.
.
.IP
@@ -2508,47 +2615,69 @@ Use this path as the temporary directory for building packages\. Changing this m
.
.TP
\fBHOMEBREW_UPDATE_REPORT_ONLY_INSTALLED\fR
-If set, \fBbrew update\fR only outputs updates to installed software\.
+.
+.br
+If set, \fBbrew update\fR only lists updates to installed software\.
.
.TP
\fBHOMEBREW_UPDATE_TO_TAG\fR
+.
+.br
If set, always use the latest stable tag (even if developer commands have been run)\.
.
.TP
\fBHOMEBREW_VERBOSE\fR
+.
+.br
If set, always assume \fB\-\-verbose\fR when running commands\.
.
.TP
\fBHOMEBREW_DEBUG\fR
+.
+.br
If set, always assume \fB\-\-debug\fR when running commands\.
.
.TP
\fBHOMEBREW_VERBOSE_USING_DOTS\fR
+.
+.br
If set, verbose output will print a \fB\.\fR no more than once a minute\. This can be useful to avoid long\-running Homebrew commands being killed due to no output\.
.
.TP
\fBall_proxy\fR
+.
+.br
Use this SOCKS5 proxy for \fBcurl\fR(1), \fBgit\fR(1) and \fBsvn\fR(1) when downloading through Homebrew\.
.
.TP
\fBftp_proxy\fR
+.
+.br
Use this FTP proxy for \fBcurl\fR(1), \fBgit\fR(1) and \fBsvn\fR(1) when downloading through Homebrew\.
.
.TP
\fBhttp_proxy\fR
+.
+.br
Use this HTTP proxy for \fBcurl\fR(1), \fBgit\fR(1) and \fBsvn\fR(1) when downloading through Homebrew\.
.
.TP
\fBhttps_proxy\fR
+.
+.br
Use this HTTPS proxy for \fBcurl\fR(1), \fBgit\fR(1) and \fBsvn\fR(1) when downloading through Homebrew\.
.
.TP
\fBno_proxy\fR
+.
+.br
A comma\-separated list of hostnames and domain names excluded from proxying by \fBcurl\fR(1), \fBgit\fR(1) and \fBsvn\fR(1) when downloading through Homebrew\.
.
.TP
\fBSUDO_ASKPASS\fR
-When this variable is set, the \fB\-A\fR option is passed when calling \fBsudo\fR(8)
+.
+.br
+If set, pass the \fB\-A\fR option when calling \fBsudo\fR(8)\.
.
.SH "USING HOMEBREW BEHIND A PROXY"
Set the \fBhttp_proxy\fR, \fBhttps_proxy\fR, \fBall_proxy\fR, \fBftp_proxy\fR and/or \fBno_proxy\fR environment variables documented above\.
@@ -2613,13 +2742,19 @@ See our issues on GitHub:
.
.TP
\fBHomebrew/brew\fR
+.
+.br
\fIhttps://github\.com/Homebrew/brew/issues\fR
.
.TP
\fBHomebrew/homebrew\-core\fR
+.
+.br
\fIhttps://github\.com/Homebrew/homebrew\-core/issues\fR
.
.TP
\fBHomebrew/homebrew\-cask\fR
+.
+.br
\fIhttps://github\.com/Homebrew/homebrew\-cask/issues\fR