mirror of
https://github.com/Homebrew/brew.git
synced 2025-07-14 16:09:03 +08:00
docs: distinguish <code> and <var> in HTML output
Replace <var> tags with markup for italicized monospaced text in Markdown. This requires the source to not combine bracketed and backticked text.
This commit is contained in:
EricFromCanada
parent
dbea3cbe90
commit
b2b8f632bb
@ -1,4 +1,4 @@
|
||||
#: * `cleanup` [`--prune=`<days>] [`--dry-run`] [`-s`] [<formula/cask> ...]:
|
||||
#: * `cleanup` [`--prune=`<days>] [`--dry-run`] [`-s`] [<formulae>|<casks>]:
|
||||
#: Remove stale lock files and outdated downloads for formulae and casks,
|
||||
#: and remove old versions of installed formulae. If arguments are specified,
|
||||
#: only do this for the specified formulae and casks.
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
#: * `info`:
|
||||
#: Display brief statistics for your Homebrew installation.
|
||||
#:
|
||||
#: * `info` <formula> (`--verbose`):
|
||||
#: * `info` <formula> [`--verbose`]:
|
||||
#: Display information about <formula> and analytics data (provided neither
|
||||
#: `HOMEBREW_NO_ANALYTICS` or `HOMEBREW_NO_GITHUB_API` are set)
|
||||
#:
|
||||
@ -10,7 +10,7 @@
|
||||
#: * `info` `--github` <formula>:
|
||||
#: Open a browser to the GitHub History page for <formula>.
|
||||
#:
|
||||
#: To view formula history locally: `brew log -p <formula>`
|
||||
#: To view formula history locally: `brew log -p` <formula>
|
||||
#:
|
||||
#: * `info` `--json=`<version> (`--all`|`--installed`|<formulae>):
|
||||
#: Print a JSON representation of <formulae>. Currently the only accepted value
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
#: * `pin` <formulae>:
|
||||
#: Pin the specified <formulae>, preventing them from being upgraded when
|
||||
#: issuing the `brew upgrade <formulae>` command. See also `unpin`.
|
||||
#: issuing the `brew upgrade` <formulae> command. See also `unpin`.
|
||||
|
||||
require "formula"
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
#:
|
||||
#: With <URL> unspecified, taps a formula repository from GitHub using HTTPS.
|
||||
#: Since so many taps are hosted on GitHub, this command is a shortcut for
|
||||
#: `tap <user>/<repo> https://github.com/<user>/homebrew-<repo>`.
|
||||
#: `brew tap` <user>`/`<repo> `https://github.com/`<user>`/homebrew-`<repo>.
|
||||
#:
|
||||
#: With <URL> specified, taps a formula repository from anywhere, using
|
||||
#: any transport protocol that `git` handles. The one-argument form of `tap`
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
#: * `unlink` [`--dry-run`] <formula>:
|
||||
#: Remove symlinks for <formula> from the Homebrew prefix. This can be useful
|
||||
#: for temporarily disabling a formula:
|
||||
#: `brew unlink <formula> && <commands> && brew link <formula>`
|
||||
#: `brew unlink` <formula> `&&` <commands> `&& brew link` <formula>
|
||||
#:
|
||||
#: If `--dry-run` or `-n` is passed, Homebrew will list all files which would
|
||||
#: be unlinked, but will not actually unlink or delete any files.
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
#: * `unpin` <formulae>:
|
||||
#: Unpin <formulae>, allowing them to be upgraded by `brew upgrade <formulae>`.
|
||||
#: Unpin <formulae>, allowing them to be upgraded by `brew upgrade` <formulae>.
|
||||
#: See also `pin`.
|
||||
|
||||
require "formula"
|
||||
|
||||
@ -79,17 +79,17 @@ module Homebrew
|
||||
switch "-D", "--audit-debug",
|
||||
description: "Activates debugging and profiling"
|
||||
comma_array "--only",
|
||||
description: "Passing `--only`=<method> will run only the methods named audit_<method>, `method` "\
|
||||
"should be a comma-separated list."
|
||||
description: "Passing `--only=`<method> will run only the methods named audit_<method>. "\
|
||||
"<method> should be a comma-separated list."
|
||||
comma_array "--except",
|
||||
description: "Passing `--except`=<method> will run only the methods named audit_<method>, "\
|
||||
"`method` should be a comma-separated list."
|
||||
description: "Passing `--except=`<method> will run only the methods named audit_<method>, "\
|
||||
"<method> should be a comma-separated list."
|
||||
comma_array "--only-cops",
|
||||
description: "Passing `--only-cops`=<cops> will check for violations of only the listed "\
|
||||
"RuboCop cops. `cops` should be a comma-separated list of cop names."
|
||||
description: "Passing `--only-cops=`<cops> will check for violations of only the listed "\
|
||||
"RuboCop cops. <cops> should be a comma-separated list of cop names."
|
||||
comma_array "--except-cops",
|
||||
description: "Passing `--except-cops`=<cops> will skip checking the listed RuboCop cops "\
|
||||
"violations. `cops` should be a comma-separated list of cop names."
|
||||
description: "Passing `--except-cops=`<cops> will skip checking the listed RuboCop cops "\
|
||||
"violations. <cops> should be a comma-separated list of cop names."
|
||||
switch :verbose
|
||||
switch :debug
|
||||
end
|
||||
|
||||
@ -158,8 +158,7 @@ module Homebrew
|
||||
ronn_output = ronn.read
|
||||
odie "Got no output from ronn!" unless ronn_output
|
||||
if format_flag == "--markdown"
|
||||
ronn_output = ronn_output.gsub(%r{</var>`(?=[.!?,;:]?\s)}, "")
|
||||
.gsub(%r{</?var>}, "`")
|
||||
ronn_output = ronn_output.gsub(%r{<var>(.*?)</var>}, "*`\\1`*")
|
||||
elsif format_flag == "--roff"
|
||||
ronn_output = ronn_output.gsub(%r{<code>(.*?)</code>}, "\\fB\\1\\fR")
|
||||
.gsub(%r{<var>(.*?)</var>}, "\\fI\\1\\fR")
|
||||
@ -233,6 +232,6 @@ module Homebrew
|
||||
end
|
||||
|
||||
def format_usage_banner(usage_banner)
|
||||
usage_banner.sub(/^/, "###")
|
||||
usage_banner.sub(/^/, "### ")
|
||||
end
|
||||
end
|
||||
|
||||
@ -294,15 +294,15 @@ Note that environment variables must have a value set to be detected. For exampl
|
||||
## USING HOMEBREW BEHIND A PROXY
|
||||
Use the `http_proxy`, `https_proxy`, `all_proxy`, `no_proxy` and/or `ftp_proxy` documented above.
|
||||
|
||||
For example for an unauthenticated HTTP or SOCKS5 proxy:
|
||||
For example, for an unauthenticated HTTP or SOCKS5 proxy:
|
||||
|
||||
export http_proxy=http://<host>:<port>
|
||||
export http_proxy=http://$HOST:$PORT
|
||||
|
||||
export all_proxy=socks5://<host>:<port>
|
||||
export all_proxy=socks5://$HOST:$PORT
|
||||
|
||||
And for an authenticated HTTP proxy:
|
||||
|
||||
export http_proxy=http://<user>:<password>@<host>:<port>
|
||||
export http_proxy=http://$USER:$PASSWORD@$HOST:$PORT
|
||||
|
||||
## SEE ALSO
|
||||
|
||||
|
||||
578
docs/Manpage.md
578
docs/Manpage.md
File diff suppressed because it is too large
Load Diff
210
manpages/brew.1
210
manpages/brew.1
@ -44,52 +44,6 @@ Perform a substring search of formula names for \fItext\fR\. If \fItext\fR is su
|
||||
.SH "COMMANDS"
|
||||
.
|
||||
.TP
|
||||
\fB\-\-cache\fR
|
||||
Display Homebrew\'s download cache\. See also \fBHOMEBREW_CACHE\fR\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-cache\fR [\fB\-\-build\-from\-source\fR|\fB\-s\fR] [\fB\-\-force\-bottle\fR] \fIformula\fR
|
||||
Display the file or directory used to cache \fIformula\fR\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-cellar\fR
|
||||
Display Homebrew\'s Cellar path\. \fIDefault:\fR \fB$(brew \-\-prefix)/Cellar\fR, or if that directory doesn\'t exist, \fB$(brew \-\-repository)/Cellar\fR\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-cellar\fR \fIformula\fR
|
||||
Display the location in the cellar where \fIformula\fR would be installed, without any sort of versioned directory as the last path\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-env\fR [\fB\-\-shell=\fR(\fIshell\fR|\fBauto\fR)|\fB\-\-plain\fR]
|
||||
Show a summary of the Homebrew build environment as a plain list\.
|
||||
.
|
||||
.IP
|
||||
Pass \fB\-\-shell=\fR\fIshell\fR to generate a list of environment variables for the specified shell, or \fB\-\-shell=auto\fR to detect the current shell\.
|
||||
.
|
||||
.IP
|
||||
If the command\'s output is sent through a pipe and no shell is specified, the list is formatted for export to \fBbash\fR(1) unless \fB\-\-plain\fR is passed\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-prefix\fR
|
||||
Display Homebrew\'s install path\. \fIDefault:\fR \fB/usr/local\fR on macOS and \fB/home/linuxbrew/\.linuxbrew\fR on Linux
|
||||
.
|
||||
.TP
|
||||
\fB\-\-prefix\fR \fIformula\fR
|
||||
Display the location in the cellar where \fIformula\fR is or would be installed\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-repository\fR
|
||||
Display where Homebrew\'s \fB\.git\fR directory is located\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-repository\fR \fIuser\fR\fB/\fR\fIrepo\fR
|
||||
Display where tap \fIuser\fR\fB/\fR\fIrepo\fR\'s directory is located\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-version\fR
|
||||
Print the version number of Homebrew to standard output and exit\.
|
||||
.
|
||||
.TP
|
||||
\fBanalytics\fR [\fBstate\fR]
|
||||
Display anonymous user behaviour analytics state\. Read more at \fIhttps://docs\.brew\.sh/Analytics\fR\.
|
||||
.
|
||||
@ -106,7 +60,7 @@ Regenerate UUID used in Homebrew\'s analytics\.
|
||||
Display the source to \fIformula\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBcleanup\fR [\fB\-\-prune=\fR\fIdays\fR] [\fB\-\-dry\-run\fR] [\fB\-s\fR] [<formula/cask> \.\.\.]
|
||||
\fBcleanup\fR [\fB\-\-prune=\fR\fIdays\fR] [\fB\-\-dry\-run\fR] [\fB\-s\fR] [\fIformulae\fR|\fIcasks\fR]
|
||||
Remove stale lock files and outdated downloads for formulae and casks, and remove old versions of installed formulae\. If arguments are specified, only do this for the specified formulae and casks\.
|
||||
.
|
||||
.IP
|
||||
@ -254,7 +208,7 @@ Open \fIformula\fR\'s homepage in a browser\.
|
||||
Display brief statistics for your Homebrew installation\.
|
||||
.
|
||||
.TP
|
||||
\fBinfo\fR \fIformula\fR (\fB\-\-verbose\fR)
|
||||
\fBinfo\fR \fIformula\fR [\fB\-\-verbose\fR]
|
||||
Display information about \fIformula\fR and analytics data (provided neither \fBHOMEBREW_NO_ANALYTICS\fR or \fBHOMEBREW_NO_GITHUB_API\fR are set)
|
||||
.
|
||||
.IP
|
||||
@ -265,7 +219,7 @@ Pass \fB\-\-verbose\fR to see more detailed analytics data\.
|
||||
Open a browser to the GitHub History page for \fIformula\fR\.
|
||||
.
|
||||
.IP
|
||||
To view formula history locally: \fBbrew log \-p <formula>\fR
|
||||
To view formula history locally: \fBbrew log \-p\fR \fIformula\fR
|
||||
.
|
||||
.TP
|
||||
\fBinfo\fR \fB\-\-json=\fR\fIversion\fR (\fB\-\-all\fR|\fB\-\-installed\fR|\fIformulae\fR)
|
||||
@ -435,7 +389,7 @@ If \fB\-\-fetch\-HEAD\fR is passed, fetch the upstream repository to detect if t
|
||||
.
|
||||
.TP
|
||||
\fBpin\fR \fIformulae\fR
|
||||
Pin the specified \fIformulae\fR, preventing them from being upgraded when issuing the \fBbrew upgrade <formulae>\fR command\. See also \fBunpin\fR\.
|
||||
Pin the specified \fIformulae\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR \fIformulae\fR command\. See also \fBunpin\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBpostinstall\fR \fIformula\fR
|
||||
@ -495,6 +449,16 @@ Start a Homebrew build environment shell\. Uses our years\-battle\-hardened Home
|
||||
If \fB\-\-env=std\fR is passed, use the standard \fBPATH\fR instead of superenv\'s\.
|
||||
.
|
||||
.TP
|
||||
\fBshellenv\fR
|
||||
Prints export statements \- run them in a shell and this installation of Homebrew will be included into your PATH, MANPATH, and INFOPATH\.
|
||||
.
|
||||
.IP
|
||||
HOMEBREW_PREFIX, HOMEBREW_CELLAR and HOMEBREW_REPOSITORY are also exported to save multiple queries of those variables\.
|
||||
.
|
||||
.IP
|
||||
Consider adding evaluating the output in your dotfiles (e\.g\. \fB~/\.profile\fR) with \fBeval $(brew shellenv)\fR
|
||||
.
|
||||
.TP
|
||||
\fBstyle\fR [\fB\-\-fix\fR] [\fB\-\-display\-cop\-names\fR] [\fB\-\-only\-cops=\fR\fIcops\fR|\fB\-\-except\-cops=\fR\fIcops\fR] [\fIfiles\fR|\fItaps\fR|\fIformulae\fR]
|
||||
Check formulae or files for conformance to Homebrew style guidelines\.
|
||||
.
|
||||
@ -518,6 +482,37 @@ Exits with a non\-zero status if any style violations are found\.
|
||||
Symlink all of the specific \fIversion\fR of \fIformula\fR\'s install to Homebrew prefix\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR
|
||||
List all installed taps\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR [\fB\-\-full\fR] [\fB\-\-force\-auto\-update\fR] \fIuser\fR\fB/\fR\fIrepo\fR [\fIURL\fR]
|
||||
Tap a formula repository\.
|
||||
.
|
||||
.IP
|
||||
With \fIURL\fR unspecified, taps a formula repository from GitHub using HTTPS\. Since so many taps are hosted on GitHub, this command is a shortcut for \fBbrew tap\fR \fIuser\fR\fB/\fR\fIrepo\fR \fBhttps://github\.com/\fR\fIuser\fR\fB/homebrew\-\fR\fIrepo\fR\.
|
||||
.
|
||||
.IP
|
||||
With \fIURL\fR specified, taps a formula repository from anywhere, using any transport protocol that \fBgit\fR handles\. The one\-argument form of \fBtap\fR simplifies but also limits\. This two\-argument command makes no assumptions, so taps can be cloned from places other than GitHub and using protocols other than HTTPS, e\.g\., SSH, GIT, HTTP, FTP(S), RSYNC\.
|
||||
.
|
||||
.IP
|
||||
By default, the repository is cloned as a shallow copy (\fB\-\-depth=1\fR), but if \fB\-\-full\fR is passed, a full clone will be used\. To convert a shallow copy to a full copy, you can retap passing \fB\-\-full\fR without first untapping\.
|
||||
.
|
||||
.IP
|
||||
By default, only taps hosted on GitHub are auto\-updated (for performance reasons)\. If \fB\-\-force\-auto\-update\fR is passed, this tap will be auto\-updated even if it is not hosted on GitHub\.
|
||||
.
|
||||
.IP
|
||||
\fBtap\fR is re\-runnable and exits successfully if there\'s nothing to do\. However, retapping with a different \fIURL\fR will cause an exception, so first \fBuntap\fR if you need to modify the \fIURL\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR \fB\-\-repair\fR
|
||||
Migrate tapped formulae from symlink\-based to directory\-based structure\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR \fB\-\-list\-pinned\fR
|
||||
List all pinned taps\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\-info\fR
|
||||
Display a brief summary of all installed taps\.
|
||||
.
|
||||
@ -547,37 +542,6 @@ Pin \fItap\fR, prioritizing its formulae over core when formula names are suppli
|
||||
Unpin \fItap\fR so its formulae are no longer prioritized\. See also \fBtap\-pin\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR
|
||||
List all installed taps\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR [\fB\-\-full\fR] [\fB\-\-force\-auto\-update\fR] \fIuser\fR\fB/\fR\fIrepo\fR [\fIURL\fR]
|
||||
Tap a formula repository\.
|
||||
.
|
||||
.IP
|
||||
With \fIURL\fR unspecified, taps a formula repository from GitHub using HTTPS\. Since so many taps are hosted on GitHub, this command is a shortcut for \fBtap <user>/<repo> https://github\.com/<user>/homebrew\-<repo>\fR\.
|
||||
.
|
||||
.IP
|
||||
With \fIURL\fR specified, taps a formula repository from anywhere, using any transport protocol that \fBgit\fR handles\. The one\-argument form of \fBtap\fR simplifies but also limits\. This two\-argument command makes no assumptions, so taps can be cloned from places other than GitHub and using protocols other than HTTPS, e\.g\., SSH, GIT, HTTP, FTP(S), RSYNC\.
|
||||
.
|
||||
.IP
|
||||
By default, the repository is cloned as a shallow copy (\fB\-\-depth=1\fR), but if \fB\-\-full\fR is passed, a full clone will be used\. To convert a shallow copy to a full copy, you can retap passing \fB\-\-full\fR without first untapping\.
|
||||
.
|
||||
.IP
|
||||
By default, only taps hosted on GitHub are auto\-updated (for performance reasons)\. If \fB\-\-force\-auto\-update\fR is passed, this tap will be auto\-updated even if it is not hosted on GitHub\.
|
||||
.
|
||||
.IP
|
||||
\fBtap\fR is re\-runnable and exits successfully if there\'s nothing to do\. However, retapping with a different \fIURL\fR will cause an exception, so first \fBuntap\fR if you need to modify the \fIURL\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR \fB\-\-repair\fR
|
||||
Migrate tapped formulae from symlink\-based to directory\-based structure\.
|
||||
.
|
||||
.TP
|
||||
\fBtap\fR \fB\-\-list\-pinned\fR
|
||||
List all pinned taps\.
|
||||
.
|
||||
.TP
|
||||
\fBuninstall\fR, \fBrm\fR, \fBremove\fR [\fB\-\-force\fR] [\fB\-\-ignore\-dependencies\fR] \fIformula\fR
|
||||
Uninstall \fIformula\fR\.
|
||||
.
|
||||
@ -589,7 +553,7 @@ If \fB\-\-ignore\-dependencies\fR is passed, uninstalling won\'t fail, even if f
|
||||
.
|
||||
.TP
|
||||
\fBunlink\fR [\fB\-\-dry\-run\fR] \fIformula\fR
|
||||
Remove symlinks for \fIformula\fR from the Homebrew prefix\. This can be useful for temporarily disabling a formula: \fBbrew unlink <formula> && <commands> && brew link <formula>\fR
|
||||
Remove symlinks for \fIformula\fR from the Homebrew prefix\. This can be useful for temporarily disabling a formula: \fBbrew unlink\fR \fIformula\fR \fB&&\fR \fIcommands\fR \fB&& brew link\fR \fIformula\fR
|
||||
.
|
||||
.IP
|
||||
If \fB\-\-dry\-run\fR or \fB\-n\fR is passed, Homebrew will list all files which would be unlinked, but will not actually unlink or delete any files\.
|
||||
@ -606,13 +570,27 @@ If \fB\-\-git\fR (or \fB\-g\fR) is passed, a Git repository will be initialized
|
||||
.
|
||||
.TP
|
||||
\fBunpin\fR \fIformulae\fR
|
||||
Unpin \fIformulae\fR, allowing them to be upgraded by \fBbrew upgrade <formulae>\fR\. See also \fBpin\fR\.
|
||||
Unpin \fIformulae\fR, allowing them to be upgraded by \fBbrew upgrade\fR \fIformulae\fR\. See also \fBpin\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBuntap\fR \fItap\fR
|
||||
Remove a tapped repository\.
|
||||
.
|
||||
.TP
|
||||
\fBupdate\fR [\fB\-\-merge\fR] [\fB\-\-force\fR]
|
||||
Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\fR(1) and perform any necessary migrations\.
|
||||
.
|
||||
.IP
|
||||
If \fB\-\-merge\fR is specified then \fBgit merge\fR is used to include updates (rather than \fBgit rebase\fR)\.
|
||||
.
|
||||
.IP
|
||||
If \fB\-\-force\fR (or \fB\-f\fR) is specified then always do a slower, full update check even if unnecessary\.
|
||||
.
|
||||
.TP
|
||||
\fBupdate\-reset\fR [\fIrepositories\fR]
|
||||
Fetches and resets Homebrew and all tap repositories (or the specified \fBrepositories\fR) using \fBgit\fR(1) to their latest \fBorigin/master\fR\. Note this will destroy all your uncommitted or committed changes\.
|
||||
.
|
||||
.TP
|
||||
\fBupgrade\fR [\fIinstall\-options\fR] [\fB\-\-cleanup\fR] [\fB\-\-fetch\-HEAD\fR] [\fB\-\-ignore\-pinned\fR] [\fB\-\-display\-times\fR] [\fIformulae\fR]
|
||||
Upgrade outdated, unpinned brews (with existing install options)\.
|
||||
.
|
||||
@ -651,28 +629,50 @@ By default, \fBuses\fR shows all formulae that specify \fIformulae\fR as a requi
|
||||
By default, \fBuses\fR shows usage of \fIformulae\fR by stable builds\. To find cases where \fIformulae\fR is used by development or HEAD build, pass \fB\-\-devel\fR or \fB\-\-HEAD\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBshellenv\fR
|
||||
Prints export statements \- run them in a shell and this installation of Homebrew will be included into your PATH, MANPATH, and INFOPATH\.
|
||||
.
|
||||
.IP
|
||||
HOMEBREW_PREFIX, HOMEBREW_CELLAR and HOMEBREW_REPOSITORY are also exported to save multiple queries of those variables\.
|
||||
.
|
||||
.IP
|
||||
Consider adding evaluating the output in your dotfiles (e\.g\. \fB~/\.profile\fR) with \fBeval $(brew shellenv)\fR
|
||||
\fB\-\-cache\fR
|
||||
Display Homebrew\'s download cache\. See also \fBHOMEBREW_CACHE\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBupdate\-reset\fR [\fIrepositories\fR]
|
||||
Fetches and resets Homebrew and all tap repositories (or the specified \fBrepositories\fR) using \fBgit\fR(1) to their latest \fBorigin/master\fR\. Note this will destroy all your uncommitted or committed changes\.
|
||||
\fB\-\-cache\fR [\fB\-\-build\-from\-source\fR|\fB\-s\fR] [\fB\-\-force\-bottle\fR] \fIformula\fR
|
||||
Display the file or directory used to cache \fIformula\fR\.
|
||||
.
|
||||
.TP
|
||||
\fBupdate\fR [\fB\-\-merge\fR] [\fB\-\-force\fR]
|
||||
Fetch the newest version of Homebrew and all formulae from GitHub using \fBgit\fR(1) and perform any necessary migrations\.
|
||||
\fB\-\-cellar\fR
|
||||
Display Homebrew\'s Cellar path\. \fIDefault:\fR \fB$(brew \-\-prefix)/Cellar\fR, or if that directory doesn\'t exist, \fB$(brew \-\-repository)/Cellar\fR\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-cellar\fR \fIformula\fR
|
||||
Display the location in the cellar where \fIformula\fR would be installed, without any sort of versioned directory as the last path\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-env\fR [\fB\-\-shell=\fR(\fIshell\fR|\fBauto\fR)|\fB\-\-plain\fR]
|
||||
Show a summary of the Homebrew build environment as a plain list\.
|
||||
.
|
||||
.IP
|
||||
If \fB\-\-merge\fR is specified then \fBgit merge\fR is used to include updates (rather than \fBgit rebase\fR)\.
|
||||
Pass \fB\-\-shell=\fR\fIshell\fR to generate a list of environment variables for the specified shell, or \fB\-\-shell=auto\fR to detect the current shell\.
|
||||
.
|
||||
.IP
|
||||
If \fB\-\-force\fR (or \fB\-f\fR) is specified then always do a slower, full update check even if unnecessary\.
|
||||
If the command\'s output is sent through a pipe and no shell is specified, the list is formatted for export to \fBbash\fR(1) unless \fB\-\-plain\fR is passed\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-prefix\fR
|
||||
Display Homebrew\'s install path\. \fIDefault:\fR \fB/usr/local\fR on macOS and \fB/home/linuxbrew/\.linuxbrew\fR on Linux
|
||||
.
|
||||
.TP
|
||||
\fB\-\-prefix\fR \fIformula\fR
|
||||
Display the location in the cellar where \fIformula\fR is or would be installed\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-repository\fR
|
||||
Display where Homebrew\'s \fB\.git\fR directory is located\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-repository\fR \fIuser\fR\fB/\fR\fIrepo\fR
|
||||
Display where tap \fIuser\fR\fB/\fR\fIrepo\fR\'s directory is located\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-version\fR
|
||||
Print the version number of Homebrew to standard output and exit\.
|
||||
.
|
||||
.SH "DEVELOPER COMMANDS"
|
||||
.
|
||||
@ -709,19 +709,19 @@ Activates debugging and profiling
|
||||
.
|
||||
.TP
|
||||
\fB\-\-only\fR
|
||||
Passing \fB\-\-only\fR=\fImethod\fR will run only the methods named audit_\fImethod\fR, \fBmethod\fR should be a comma\-separated list\.
|
||||
Passing \fB\-\-only=\fR\fImethod\fR will run only the methods named audit_\fImethod\fR\. \fImethod\fR should be a comma\-separated list\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-except\fR
|
||||
Passing \fB\-\-except\fR=\fImethod\fR will run only the methods named audit_\fImethod\fR, \fBmethod\fR should be a comma\-separated list\.
|
||||
Passing \fB\-\-except=\fR\fImethod\fR will run only the methods named audit_\fImethod\fR, \fImethod\fR should be a comma\-separated list\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-only\-cops\fR
|
||||
Passing \fB\-\-only\-cops\fR=\fIcops\fR will check for violations of only the listed RuboCop cops\. \fBcops\fR should be a comma\-separated list of cop names\.
|
||||
Passing \fB\-\-only\-cops=\fR\fIcops\fR will check for violations of only the listed RuboCop cops\. \fIcops\fR should be a comma\-separated list of cop names\.
|
||||
.
|
||||
.TP
|
||||
\fB\-\-except\-cops\fR
|
||||
Passing \fB\-\-except\-cops\fR=\fIcops\fR will skip checking the listed RuboCop cops violations\. \fBcops\fR should be a comma\-separated list of cop names\.
|
||||
Passing \fB\-\-except\-cops=\fR\fIcops\fR will skip checking the listed RuboCop cops violations\. \fIcops\fR should be a comma\-separated list of cop names\.
|
||||
.
|
||||
.SS "\fBbottle\fR [\fIoptions\fR] \fIformulae\fR:"
|
||||
Generate a bottle (binary package) from a formula installed with \fB\-\-build\-bottle\fR\. If the formula specifies a rebuild version, it will be incremented in the generated DSL\. Passing \fB\-\-keep\-old\fR will attempt to keep it at its original value, while \fB\-\-no\-rebuild\fR will remove it\.
|
||||
@ -1396,15 +1396,15 @@ Sets the comma\-separated list of hostnames and domain names that should be excl
|
||||
Use the \fBhttp_proxy\fR, \fBhttps_proxy\fR, \fBall_proxy\fR, \fBno_proxy\fR and/or \fBftp_proxy\fR documented above\.
|
||||
.
|
||||
.P
|
||||
For example for an unauthenticated HTTP or SOCKS5 proxy:
|
||||
For example, for an unauthenticated HTTP or SOCKS5 proxy:
|
||||
.
|
||||
.IP "" 4
|
||||
.
|
||||
.nf
|
||||
|
||||
export http_proxy=http://<host>:<port>
|
||||
export http_proxy=http://$HOST:$PORT
|
||||
|
||||
export all_proxy=socks5://<host>:<port>
|
||||
export all_proxy=socks5://$HOST:$PORT
|
||||
.
|
||||
.fi
|
||||
.
|
||||
@ -1417,7 +1417,7 @@ And for an authenticated HTTP proxy:
|
||||
.
|
||||
.nf
|
||||
|
||||
export http_proxy=http://<user>:<password>@<host>:<port>
|
||||
export http_proxy=http://$USER:$PASSWORD@$HOST:$PORT
|
||||
.
|
||||
.fi
|
||||
.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user