fixes for grammar and wording

This commit is contained in:
EricFromCanada 2021-01-26 15:21:24 -05:00
parent 99ad3350ee
commit 6fc116318e
52 changed files with 160 additions and 159 deletions

View File

@ -152,7 +152,7 @@ class Build
system "git", "add", "-A" system "git", "add", "-A"
end end
if args.interactive? if args.interactive?
ohai "Entering interactive mode" ohai "Entering interactive mode..."
puts <<~EOS puts <<~EOS
Type `exit` to return and finalize the installation. Type `exit` to return and finalize the installation.
Install to this prefix: #{formula.prefix} Install to this prefix: #{formula.prefix}

View File

@ -303,7 +303,7 @@ module Cask
message = "uninstall script #{executable} does not exist" message = "uninstall script #{executable} does not exist"
raise CaskError, "#{message}." unless force raise CaskError, "#{message}." unless force
opoo "#{message}, skipping." opoo "#{message}; skipping."
return return
end end
@ -398,7 +398,7 @@ module Cask
false false
end end
opoo "The following files could not trashed, please do so manually:" opoo "The following files could not be trashed, please do so manually:"
$stderr.puts untrashable $stderr.puts untrashable
[trashed, untrashable] [trashed, untrashable]

View File

@ -48,7 +48,7 @@ module Cask
raise CaskError, "It seems the #{self.class.english_name} source '#{source}' is not there." raise CaskError, "It seems the #{self.class.english_name} source '#{source}' is not there."
end end
ohai "Moving #{self.class.english_name} '#{source.basename}' to '#{target}'." ohai "Moving #{self.class.english_name} '#{source.basename}' to '#{target}'"
if target.dirname.ascend.find(&:directory?).writable? if target.dirname.ascend.find(&:directory?).writable?
target.dirname.mkpath target.dirname.mkpath
else else
@ -84,7 +84,7 @@ module Cask
raise CaskError, "It seems the #{self.class.english_name} source '#{target}' is not there." raise CaskError, "It seems the #{self.class.english_name} source '#{target}' is not there."
end end
ohai "Backing #{self.class.english_name} '#{target.basename}' up to '#{source}'." ohai "Backing #{self.class.english_name} '#{target.basename}' up to '#{source}'"
source.dirname.mkpath source.dirname.mkpath
# We need to preserve extended attributes between copies. # We need to preserve extended attributes between copies.
@ -94,7 +94,7 @@ module Cask
end end
def delete(target, force: false, command: nil, **_) def delete(target, force: false, command: nil, **_)
ohai "Removing #{self.class.english_name} '#{target}'." ohai "Removing #{self.class.english_name} '#{target}'"
raise CaskError, "Cannot remove undeletable #{self.class.english_name}." if MacOS.undeletable?(target) raise CaskError, "Cannot remove undeletable #{self.class.english_name}." if MacOS.undeletable?(target)
return unless Utils.path_occupied?(target) return unless Utils.path_occupied?(target)

View File

@ -82,7 +82,7 @@ module Cask
altnames = command.run("/usr/bin/xattr", altnames = command.run("/usr/bin/xattr",
args: ["-p", ALT_NAME_ATTRIBUTE, file], args: ["-p", ALT_NAME_ATTRIBUTE, file],
print_stderr: false).stdout.sub(/\A\((.*)\)\Z/, '\1') print_stderr: false).stdout.sub(/\A\((.*)\)\Z/, '\1')
odebug "Existing metadata is: '#{altnames}'" odebug "Existing metadata is: #{altnames}"
altnames.concat(", ") unless altnames.empty? altnames.concat(", ") unless altnames.empty?
altnames.concat(%Q("#{altname}")) altnames.concat(%Q("#{altname}"))
altnames = "(#{altnames})" altnames = "(#{altnames})"

View File

@ -65,14 +65,14 @@ module Cask
end end
end end
ohai "Linking #{self.class.english_name} '#{source.basename}' to '#{target}'." ohai "Linking #{self.class.english_name} '#{source.basename}' to '#{target}'"
create_filesystem_link(**options) create_filesystem_link(**options)
end end
def unlink(**) def unlink(**)
return unless target.symlink? return unless target.symlink?
ohai "Unlinking #{self.class.english_name} '#{target}'." ohai "Unlinking #{self.class.english_name} '#{target}'"
target.delete target.delete
end end

View File

@ -115,7 +115,7 @@ module Cask
path.dirname.mkpath path.dirname.mkpath
begin begin
ohai "Downloading #{url}." ohai "Downloading #{url}"
curl_download url, to: path curl_download url, to: path
rescue ErrorDuringExecution rescue ErrorDuringExecution
raise CaskUnavailableError.new(token, "Failed to download #{Formatter.url(url)}.") raise CaskUnavailableError.new(token, "Failed to download #{Formatter.url(url)}.")

View File

@ -129,7 +129,7 @@ module Cask
matches = search_casks(cask_token) matches = search_casks(cask_token)
if matches.one? if matches.one?
"Did you mean #{matches.first}?" "Did you mean '#{matches.first}'?"
elsif !matches.empty? elsif !matches.empty?
"Did you mean one of these?\n#{Formatter.columns(matches.take(20))}" "Did you mean one of these?\n#{Formatter.columns(matches.take(20))}"
end end

View File

@ -80,7 +80,7 @@ module Cask
return if DSL::DSL_METHODS.include?(stanza) return if DSL::DSL_METHODS.include?(stanza)
raise UsageError, <<~EOS raise UsageError, <<~EOS
Unknown/unsupported stanza: '#{stanza}' Unknown/unsupported stanza '#{stanza}'.
Check cask reference for supported stanzas. Check cask reference for supported stanzas.
EOS EOS
end end

View File

@ -63,7 +63,7 @@ module Cask
end end
begin begin
ohai "Verifying checksum for cask '#{@cask}'." if verbose? ohai "Verifying checksum for cask '#{@cask}'" if verbose?
fn.verify_checksum(@cask.sha256) fn.verify_checksum(@cask.sha256)
rescue ChecksumMissingError rescue ChecksumMissingError
opoo <<~EOS opoo <<~EOS

View File

@ -201,7 +201,7 @@ module Cask
def version(arg = nil) def version(arg = nil)
set_unique_stanza(:version, arg.nil?) do set_unique_stanza(:version, arg.nil?) do
if !arg.is_a?(String) && arg != :latest if !arg.is_a?(String) && arg != :latest
raise CaskInvalidError.new(cask, "invalid 'version' value: '#{arg.inspect}'") raise CaskInvalidError.new(cask, "invalid 'version' value: #{arg.inspect}")
end end
DSL::Version.new(arg) DSL::Version.new(arg)
@ -216,7 +216,7 @@ module Cask
when String when String
Checksum.new(arg) Checksum.new(arg)
else else
raise CaskInvalidError.new(cask, "invalid 'sha256' value: '#{arg.inspect}'") raise CaskInvalidError.new(cask, "invalid 'sha256' value: #{arg.inspect}")
end end
end end
end end

View File

@ -92,7 +92,7 @@ module Cask
caveat :zsh_path_helper do |path| caveat :zsh_path_helper do |path|
<<~EOS <<~EOS
To use #{@cask}, zsh users may need to add the following line to their To use #{@cask}, zsh users may need to add the following line to their
~/.zprofile. (Among other effects, #{path} will be added to the ~/.zprofile. (Among other effects, #{path} will be added to the
PATH environment variable): PATH environment variable):
eval `/usr/libexec/path_helper -s` eval `/usr/libexec/path_helper -s`
EOS EOS

View File

@ -19,7 +19,7 @@ module Cask
def initialize(pairs = {}) def initialize(pairs = {})
@pairs = pairs @pairs = pairs
pairs.each do |key, value| pairs.each do |key, value|
raise "invalid container key: '#{key.inspect}'" unless VALID_KEYS.include?(key) raise "invalid container key: #{key.inspect}" unless VALID_KEYS.include?(key)
send(:"#{key}=", value) send(:"#{key}=", value)
end end

View File

@ -52,7 +52,7 @@ module Cask
end end
def macos=(*args) def macos=(*args)
raise "Only a single 'depends_on macos:' is allowed." if defined?(@macos) raise "Only a single 'depends_on macos' is allowed." if defined?(@macos)
begin begin
@macos = if args.count > 1 @macos = if args.count > 1

View File

@ -280,7 +280,7 @@ module Cask
raise CaskError, raise CaskError,
"Cask #{@cask} depends on hardware architecture being one of " \ "Cask #{@cask} depends on hardware architecture being one of " \
"[#{@cask.depends_on.arch.map(&:to_s).join(", ")}], " \ "[#{@cask.depends_on.arch.map(&:to_s).join(", ")}], " \
"but you are running #{@current_arch}" "but you are running #{@current_arch}."
end end
def x11_dependencies def x11_dependencies

View File

@ -32,7 +32,7 @@ module Cask
end end
if create && !path.directory? if create && !path.directory?
odebug "Creating metadata directory #{path}." odebug "Creating metadata directory: #{path}"
path.mkpath path.mkpath
end end
@ -50,7 +50,7 @@ module Cask
subdir = parent.join(leaf) subdir = parent.join(leaf)
if create && !subdir.directory? if create && !subdir.directory?
odebug "Creating metadata subdirectory #{subdir}." odebug "Creating metadata subdirectory: #{subdir}"
subdir.mkpath subdir.mkpath
end end

View File

@ -29,7 +29,7 @@ module Cask
full_paths = remove_nonexistent(paths) full_paths = remove_nonexistent(paths)
return if full_paths.empty? return if full_paths.empty?
ohai "Changing ownership of paths required by #{@cask}; your password may be necessary" ohai "Changing ownership of paths required by #{@cask}; your password may be necessary."
@command.run!("/usr/sbin/chown", args: ["-R", "--", "#{user}:#{group}", *full_paths], @command.run!("/usr/sbin/chown", args: ["-R", "--", "#{user}:#{group}", *full_paths],
sudo: true) sudo: true)
end end

View File

@ -62,7 +62,7 @@ class Caveats
if f.bin.directory? || f.sbin.directory? if f.bin.directory? || f.sbin.directory?
s << <<~EOS s << <<~EOS
If you need to have #{f.name} first in your PATH run: If you need to have #{f.name} first in your PATH, run:
EOS EOS
s << " #{Utils::Shell.prepend_path_in_profile(f.opt_bin.to_s)}\n" if f.bin.directory? s << " #{Utils::Shell.prepend_path_in_profile(f.opt_bin.to_s)}\n" if f.bin.directory?
s << " #{Utils::Shell.prepend_path_in_profile(f.opt_sbin.to_s)}\n" if f.sbin.directory? s << " #{Utils::Shell.prepend_path_in_profile(f.opt_sbin.to_s)}\n" if f.sbin.directory?

View File

@ -96,7 +96,7 @@ module Homebrew
fetched_bottle = false fetched_bottle = false
onoe e.message onoe e.message
opoo "Bottle fetch failed: fetching the source." opoo "Bottle fetch failed, fetching the source instead."
else else
fetched_bottle = true fetched_bottle = true
end end

View File

@ -184,7 +184,7 @@ module Homebrew
# head-only without --HEAD is an error # head-only without --HEAD is an error
if !args.HEAD? && f.stable.nil? if !args.HEAD? && f.stable.nil?
odie <<~EOS odie <<~EOS
#{f.full_name} is a head-only formula #{f.full_name} is a head-only formula.
To install it, run: To install it, run:
brew install --HEAD #{f.full_name} brew install --HEAD #{f.full_name}
EOS EOS
@ -208,7 +208,7 @@ module Homebrew
if f.outdated? if f.outdated?
optlinked_version = Keg.for(f.opt_prefix).version optlinked_version = Keg.for(f.opt_prefix).version
onoe <<~EOS onoe <<~EOS
#{f.full_name} #{optlinked_version} is already installed #{f.full_name} #{optlinked_version} is already installed.
To upgrade to #{f.version}, run: To upgrade to #{f.version}, run:
brew upgrade #{f.full_name} brew upgrade #{f.full_name}
EOS EOS
@ -216,7 +216,7 @@ module Homebrew
installed_formulae << f installed_formulae << f
elsif !args.quiet? elsif !args.quiet?
opoo <<~EOS opoo <<~EOS
#{f.full_name} #{f.pkg_version} is already installed and up-to-date #{f.full_name} #{f.pkg_version} is already installed and up-to-date.
To reinstall #{f.pkg_version}, run: To reinstall #{f.pkg_version}, run:
brew reinstall #{f.name} brew reinstall #{f.name}
EOS EOS
@ -239,13 +239,13 @@ module Homebrew
nil nil
else else
<<~EOS <<~EOS
#{msg} #{msg}.
The currently linked version is #{f.linked_version} The currently linked version is: #{f.linked_version}
EOS EOS
end end
elsif !f.linked? || f.keg_only? elsif !f.linked? || f.keg_only?
msg = <<~EOS msg = <<~EOS
#{msg}, it's just not linked #{msg}, it's just not linked.
To link this version, run: To link this version, run:
brew link #{f} brew link #{f}
EOS EOS
@ -257,7 +257,7 @@ module Homebrew
nil nil
else else
<<~EOS <<~EOS
#{msg} and up-to-date #{msg} and up-to-date.
To reinstall #{f.pkg_version}, run: To reinstall #{f.pkg_version}, run:
brew reinstall #{f.name} brew reinstall #{f.name}
EOS EOS
@ -266,21 +266,23 @@ module Homebrew
opoo msg if msg opoo msg if msg
elsif !f.any_version_installed? && old_formula = f.old_installed_formulae.first elsif !f.any_version_installed? && old_formula = f.old_installed_formulae.first
msg = "#{old_formula.full_name} #{old_formula.any_installed_version} already installed" msg = "#{old_formula.full_name} #{old_formula.any_installed_version} already installed"
if !old_formula.linked? && !old_formula.keg_only? msg = if !old_formula.linked? && !old_formula.keg_only?
msg = <<~EOS <<~EOS
#{msg}, it's just not linked. #{msg}, it's just not linked.
To link this version, run: To link this version, run:
brew link #{old_formula.full_name} brew link #{old_formula.full_name}
EOS EOS
elsif args.quiet? elsif args.quiet?
msg = nil nil
else
"#{msg}."
end end
opoo msg if msg opoo msg if msg
elsif f.migration_needed? && !args.force? elsif f.migration_needed? && !args.force?
# Check if the formula we try to install is the same as installed # Check if the formula we try to install is the same as installed
# but not migrated one. If --force is passed then install anyway. # but not migrated one. If --force is passed then install anyway.
opoo <<~EOS opoo <<~EOS
#{f.oldname} is already installed, it's just not migrated #{f.oldname} is already installed, it's just not migrated.
To migrate this formula, run: To migrate this formula, run:
brew migrate #{f} brew migrate #{f}
Or to force-install it, run: Or to force-install it, run:

View File

@ -104,7 +104,7 @@ module Homebrew
puts puts
raise raise
else else
puts "#{n} symlinks created" puts "#{n} symlinks created."
end end
puts_keg_only_path_message(keg) if keg_only && !Homebrew::EnvConfig.developer? puts_keg_only_path_message(keg) if keg_only && !Homebrew::EnvConfig.developer?

View File

@ -65,7 +65,7 @@ module Homebrew
if File.exist? "#{repo}/.git/shallow" if File.exist? "#{repo}/.git/shallow"
opoo <<~EOS opoo <<~EOS
#{name} is a shallow clone so only partial output will be shown. #{name} is a shallow clone so only partial output will be shown.
To get a full clone run: To get a full clone, run:
git -C "#{git_cd}" fetch --unshallow git -C "#{git_cd}" fetch --unshallow
EOS EOS
end end

View File

@ -54,7 +54,7 @@ module Homebrew
puts <<~EOS puts <<~EOS
#{Tty.bold}Read the analytics documentation (and how to opt-out) here: #{Tty.bold}Read the analytics documentation (and how to opt-out) here:
#{Formatter.url("https://docs.brew.sh/Analytics")}#{Tty.reset} #{Formatter.url("https://docs.brew.sh/Analytics")}#{Tty.reset}
No analytics have been recorded yet (or will be during this `brew` run). No analytics have been recorded yet (nor will be during this `brew` run).
EOS EOS
@ -343,7 +343,7 @@ class Reporter
new_tap = Tap.fetch(new_tap_name) new_tap = Tap.fetch(new_tap_name)
new_tap.install unless new_tap.installed? new_tap.install unless new_tap.installed?
ohai "#{name} has been moved to Homebrew.", <<~EOS ohai "#{name} has been moved to Homebrew.", <<~EOS
To uninstall the cask run: To uninstall the cask, run:
brew uninstall --cask --force #{name} brew uninstall --cask --force #{name}
EOS EOS
next if (HOMEBREW_CELLAR/new_name.split("/").last).directory? next if (HOMEBREW_CELLAR/new_name.split("/").last).directory?
@ -384,7 +384,7 @@ class Reporter
EOS EOS
else else
ohai "#{name} has been moved to Homebrew Cask.", <<~EOS ohai "#{name} has been moved to Homebrew Cask.", <<~EOS
To uninstall the formula and install the cask run: To uninstall the formula and install the cask, run:
brew uninstall --force #{name} brew uninstall --force #{name}
brew tap #{new_tap_name} brew tap #{new_tap_name}
brew install --cask #{new_name} brew install --cask #{new_name}

View File

@ -114,8 +114,8 @@ pop_stash() {
pop_stash_message() { pop_stash_message() {
[[ -z "$STASHED" ]] && return [[ -z "$STASHED" ]] && return
echo "To restore the stashed changes to $DIR run:" echo "To restore the stashed changes to $DIR, run:"
echo " 'cd $DIR && git stash pop'" echo " cd $DIR && git stash pop"
unset STASHED unset STASHED
} }

View File

@ -133,7 +133,7 @@ fetch() {
odie <<EOS odie <<EOS
Failed to download $VENDOR_URL and $VENDOR_URL2! Failed to download $VENDOR_URL and $VENDOR_URL2!
Do not file an issue on GitHub about this: you will need to figure out for Do not file an issue on GitHub about this; you will need to figure out for
yourself what issue with your internet connection restricts your access to yourself what issue with your internet connection restricts your access to
both Bintray (used for Homebrew bottles/binary packages) and GitHub both Bintray (used for Homebrew bottles/binary packages) and GitHub
(used for Homebrew updates). (used for Homebrew updates).

View File

@ -56,7 +56,7 @@ HOMEBREW_CELLAR = Pathname(EnvVar["HOMEBREW_CELLAR"]).freeze
# Where downloads (bottles, source tarballs, etc.) are cached # Where downloads (bottles, source tarballs, etc.) are cached
HOMEBREW_CACHE = Pathname(EnvVar["HOMEBREW_CACHE"]).freeze HOMEBREW_CACHE = Pathname(EnvVar["HOMEBREW_CACHE"]).freeze
# Where brews installed via URL are cached # Where formulae installed via URL are cached
HOMEBREW_CACHE_FORMULA = (HOMEBREW_CACHE/"Formula").freeze HOMEBREW_CACHE_FORMULA = (HOMEBREW_CACHE/"Formula").freeze
# Where build, postinstall, and test logs of formulae are written to # Where build, postinstall, and test logs of formulae are written to

View File

@ -110,7 +110,7 @@ module Homebrew
ohai "Fetching remote #{homebrew_core_remote}" ohai "Fetching remote #{homebrew_core_remote}"
safe_system "git", "fetch", homebrew_core_remote, "HEAD", default_origin_branch safe_system "git", "fetch", homebrew_core_remote, "HEAD", default_origin_branch
if quiet_system "git", "cat-file", "-e", "#{full_origin_branch}:#{formula_path}" if quiet_system "git", "cat-file", "-e", "#{full_origin_branch}:#{formula_path}"
ohai "#{formula.full_name} exists in #{full_origin_branch}" ohai "#{formula.full_name} exists in #{full_origin_branch}."
safe_system "git", "checkout", full_origin_branch safe_system "git", "checkout", full_origin_branch
return tap_full_name, homebrew_core_remote, default_origin_branch, previous_branch return tap_full_name, homebrew_core_remote, default_origin_branch, previous_branch
end end

View File

@ -48,7 +48,7 @@ module Homebrew
"to create a new formula!" "to create a new formula!"
end.presence end.presence
# If no brews are listed, open the project root in an editor. # If no formulae are listed, open the project root in an editor.
paths ||= [HOMEBREW_REPOSITORY] paths ||= [HOMEBREW_REPOSITORY]
exec_editor(*paths) exec_editor(*paths)

View File

@ -22,7 +22,7 @@ module Homebrew
description <<~EOS description <<~EOS
Generate Homebrew's manpages. Generate Homebrew's manpages.
Not (yet) working on Apple Silicon. *Note:* Not (yet) working on Apple Silicon.
EOS EOS
switch "--fail-if-changed", switch "--fail-if-changed",
description: "Return a failing status code if changes are detected in the manpage outputs. This "\ description: "Return a failing status code if changes are detected in the manpage outputs. This "\

View File

@ -13,14 +13,15 @@ module Homebrew
def unbottled_args def unbottled_args
Homebrew::CLI::Parser.new do Homebrew::CLI::Parser.new do
description <<~EOS description <<~EOS
Outputs the unbottled dependents of formulae. Show the unbottled dependents of formulae.
EOS EOS
flag "--tag=", flag "--tag=",
description: "Use the specified bottle tag (e.g. big_sur) instead of the current OS." description: "Use the specified bottle tag (e.g. `big_sur`) instead of the current OS."
switch "--dependents", switch "--dependents",
description: "Don't get analytics data and sort by number of dependents instead." description: "Skip getting analytics data and sort by number of dependents instead."
switch "--total", switch "--total",
description: "Output the number of unbottled and total formulae." description: "Print the number of unbottled and total formulae."
conflicts "--dependents", "--total" conflicts "--dependents", "--total"
named_args :formula named_args :formula

View File

@ -264,11 +264,11 @@ module Homebrew
] ]
__check_stray_files "/usr/local/lib/pkgconfig", "*.pc", allow_list, <<~EOS __check_stray_files "/usr/local/lib/pkgconfig", "*.pc", allow_list, <<~EOS
Unbrewed .pc files were found in /usr/local/lib/pkgconfig. Unbrewed '.pc' files were found in /usr/local/lib/pkgconfig.
If you didn't put them there on purpose they could cause problems when If you didn't put them there on purpose they could cause problems when
building Homebrew formulae, and may need to be deleted. building Homebrew formulae, and may need to be deleted.
Unexpected .pc files: Unexpected '.pc' files:
EOS EOS
end end
@ -285,11 +285,11 @@ module Homebrew
] ]
__check_stray_files "/usr/local/lib", "*.la", allow_list, <<~EOS __check_stray_files "/usr/local/lib", "*.la", allow_list, <<~EOS
Unbrewed .la files were found in /usr/local/lib. Unbrewed '.la' files were found in /usr/local/lib.
If you didn't put them there on purpose they could cause problems when If you didn't put them there on purpose they could cause problems when
building Homebrew formulae, and may need to be deleted. building Homebrew formulae, and may need to be deleted.
Unexpected .la files: Unexpected '.la' files:
EOS EOS
end end
@ -351,7 +351,7 @@ module Homebrew
The following directories do not exist: The following directories do not exist:
#{not_exist_dirs.join("\n")} #{not_exist_dirs.join("\n")}
You should create these directories and change their ownership to your account. You should create these directories and change their ownership to your user.
sudo mkdir -p #{not_exist_dirs.join(" ")} sudo mkdir -p #{not_exist_dirs.join(" ")}
sudo chown -R $(whoami) #{not_exist_dirs.join(" ")} sudo chown -R $(whoami) #{not_exist_dirs.join(" ")}
EOS EOS
@ -405,7 +405,7 @@ module Homebrew
unless conflicts.empty? unless conflicts.empty?
message = inject_file_list conflicts, <<~EOS message = inject_file_list conflicts, <<~EOS
/usr/bin occurs before #{HOMEBREW_PREFIX}/bin /usr/bin occurs before #{HOMEBREW_PREFIX}/bin in your PATH.
This means that system-provided programs will be used instead of those This means that system-provided programs will be used instead of those
provided by Homebrew. Consider setting your PATH so that provided by Homebrew. Consider setting your PATH so that
#{HOMEBREW_PREFIX}/bin occurs before /usr/bin. Here is a one-liner: #{HOMEBREW_PREFIX}/bin occurs before /usr/bin. Here is a one-liner:
@ -429,8 +429,8 @@ module Homebrew
return if @seen_prefix_bin return if @seen_prefix_bin
<<~EOS <<~EOS
Homebrew's bin was not found in your PATH. Homebrew's "bin" was not found in your PATH.
Consider setting the PATH for example like so: Consider setting your PATH for example like so:
#{Utils::Shell.prepend_path_in_profile("#{HOMEBREW_PREFIX}/bin")} #{Utils::Shell.prepend_path_in_profile("#{HOMEBREW_PREFIX}/bin")}
EOS EOS
end end
@ -445,9 +445,9 @@ module Homebrew
return if sbin.children.one? && sbin.children.first.basename.to_s == ".keepme" return if sbin.children.one? && sbin.children.first.basename.to_s == ".keepme"
<<~EOS <<~EOS
Homebrew's sbin was not found in your PATH but you have installed Homebrew's "sbin" was not found in your PATH but you have installed
formulae that put executables in #{HOMEBREW_PREFIX}/sbin. formulae that put executables in #{HOMEBREW_PREFIX}/sbin.
Consider setting the PATH for example like so: Consider setting your PATH for example like so:
#{Utils::Shell.prepend_path_in_profile("#{HOMEBREW_PREFIX}/sbin")} #{Utils::Shell.prepend_path_in_profile("#{HOMEBREW_PREFIX}/sbin")}
EOS EOS
end end
@ -726,7 +726,7 @@ module Homebrew
return unless File.exist? "#{ENV["HOME"]}/.pydistutils.cfg" return unless File.exist? "#{ENV["HOME"]}/.pydistutils.cfg"
<<~EOS <<~EOS
A .pydistutils.cfg file was found in $HOME, which may cause Python A '.pydistutils.cfg' file was found in $HOME, which may cause Python
builds to fail. See: builds to fail. See:
#{Formatter.url("https://bugs.python.org/issue6138")} #{Formatter.url("https://bugs.python.org/issue6138")}
#{Formatter.url("https://bugs.python.org/issue4655")} #{Formatter.url("https://bugs.python.org/issue4655")}
@ -768,7 +768,7 @@ module Homebrew
inject_file_list unlinked, <<~EOS inject_file_list unlinked, <<~EOS
You have unlinked kegs in your Cellar. You have unlinked kegs in your Cellar.
Leaving kegs unlinked can lead to build-trouble and cause brews that depend on Leaving kegs unlinked can lead to build-trouble and cause formulae that depend on
those kegs to fail to run properly once built. Run `brew link` on these: those kegs to fail to run properly once built. Run `brew link` on these:
EOS EOS
end end

View File

@ -16,8 +16,8 @@ module Homebrew
default: "native", default: "native",
}, },
HOMEBREW_ARTIFACT_DOMAIN: { HOMEBREW_ARTIFACT_DOMAIN: {
description: "Prefix all download URLs, including those for bottles, with this " \ description: "Prefix all download URLs, including those for bottles, with this value. " \
"variable. For example, `HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080` will cause a " \ "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 " \ "formula with the URL `https://example.com/foo.tar.gz` to instead download from " \
"`http://localhost:8080/example.com/foo.tar.gz`.", "`http://localhost:8080/example.com/foo.tar.gz`.",
}, },

View File

@ -280,9 +280,9 @@ module SharedEnvExtension
self["F77"] ||= fc self["F77"] ||= fc
else else
if (gfortran = which("gfortran", (HOMEBREW_PREFIX/"bin").to_s)) if (gfortran = which("gfortran", (HOMEBREW_PREFIX/"bin").to_s))
ohai "Using Homebrew-provided Fortran compiler." ohai "Using Homebrew-provided Fortran compiler"
elsif (gfortran = which("gfortran", PATH.new(ORIGINAL_PATHS))) elsif (gfortran = which("gfortran", PATH.new(ORIGINAL_PATHS)))
ohai "Using a Fortran compiler found at #{gfortran}." ohai "Using a Fortran compiler found at #{gfortran}"
end end
if gfortran if gfortran
puts "This may be changed by setting the FC environment variable." puts "This may be changed by setting the FC environment variable."

View File

@ -19,7 +19,7 @@ module FormulaCellarChecks
return if ORIGINAL_PATHS.include? prefix_bin return if ORIGINAL_PATHS.include? prefix_bin
<<~EOS <<~EOS
#{prefix_bin} is not in your PATH "#{prefix_bin}" is not in your PATH.
You can amend this by altering your #{Utils::Shell.profile} file. You can amend this by altering your #{Utils::Shell.profile} file.
EOS EOS
end end
@ -29,8 +29,8 @@ module FormulaCellarChecks
return unless (formula.prefix/"man").directory? return unless (formula.prefix/"man").directory?
<<~EOS <<~EOS
A top-level "man" directory was found A top-level "man" directory was found.
Homebrew requires that man pages live under share. Homebrew requires that man pages live under "share".
This can often be fixed by passing `--mandir=\#{man}` to `configure`. This can often be fixed by passing `--mandir=\#{man}` to `configure`.
EOS EOS
end end
@ -40,8 +40,8 @@ module FormulaCellarChecks
return unless (formula.prefix/"info").directory? return unless (formula.prefix/"info").directory?
<<~EOS <<~EOS
A top-level "info" directory was found A top-level "info" directory was found.
Homebrew suggests that info pages live under share. Homebrew suggests that info pages live under "share".
This can often be fixed by passing `--infodir=\#{info}` to `configure`. This can often be fixed by passing `--infodir=\#{info}` to `configure`.
EOS EOS
end end
@ -53,11 +53,11 @@ module FormulaCellarChecks
return if jars.empty? return if jars.empty?
<<~EOS <<~EOS
JARs were installed to "#{formula.lib}" JARs were installed to "#{formula.lib}".
Installing JARs to "lib" can cause conflicts between packages. Installing JARs to "lib" can cause conflicts between packages.
For Java software, it is typically better for the formula to For Java software, it is typically better for the formula to
install to "libexec" and then symlink or wrap binaries into "bin". install to "libexec" and then symlink or wrap binaries into "bin".
See "activemq", "jruby", etc. for examples. See formulae 'activemq', 'jruby', etc. for examples.
The offending files are: The offending files are:
#{jars * "\n "} #{jars * "\n "}
EOS EOS
@ -81,7 +81,7 @@ module FormulaCellarChecks
return if non_libraries.empty? return if non_libraries.empty?
<<~EOS <<~EOS
Non-libraries were installed to "#{formula.lib}" Non-libraries were installed to "#{formula.lib}".
Installing non-libraries to "lib" is discouraged. Installing non-libraries to "lib" is discouraged.
The offending files are: The offending files are:
#{non_libraries * "\n "} #{non_libraries * "\n "}
@ -95,7 +95,7 @@ module FormulaCellarChecks
return if non_exes.empty? return if non_exes.empty?
<<~EOS <<~EOS
Non-executables were installed to "#{bin}" Non-executables were installed to "#{bin}".
The offending files are: The offending files are:
#{non_exes * "\n "} #{non_exes * "\n "}
EOS EOS
@ -109,11 +109,10 @@ module FormulaCellarChecks
return if generics.empty? return if generics.empty?
<<~EOS <<~EOS
Generic binaries were installed to "#{bin}" Generic binaries were installed to "#{bin}".
Binaries with generic names are likely to conflict with other software, Binaries with generic names are likely to conflict with other software.
and suggest that this software should be installed to "libexec" and then Homebrew suggests that this software is installed to "libexec" and then
symlinked as needed. symlinked as needed.
The offending files are: The offending files are:
#{generics * "\n "} #{generics * "\n "}
EOS EOS
@ -124,9 +123,9 @@ module FormulaCellarChecks
return if pth_found.empty? return if pth_found.empty?
<<~EOS <<~EOS
easy-install.pth files were found 'easy-install.pth' files were found.
These .pth files are likely to cause link conflicts. Please invoke These '.pth' files are likely to cause link conflicts.
setup.py using Language::Python.setup_install_args. Please invoke `setup.py` using 'Language::Python.setup_install_args'.
The offending files are: The offending files are:
#{pth_found * "\n "} #{pth_found * "\n "}
EOS EOS
@ -144,7 +143,7 @@ module FormulaCellarChecks
return unless bad_dir_name return unless bad_dir_name
<<~EOS <<~EOS
Emacs Lisp files were installed into the wrong site-lisp subdirectory. Emacs Lisp files were installed into the wrong "site-lisp" subdirectory.
They should be installed into: They should be installed into:
#{share}/emacs/site-lisp/#{name} #{share}/emacs/site-lisp/#{name}
EOS EOS
@ -161,11 +160,10 @@ module FormulaCellarChecks
return if elisps.empty? return if elisps.empty?
<<~EOS <<~EOS
Emacs Lisp files were linked directly to #{HOMEBREW_PREFIX}/share/emacs/site-lisp Emacs Lisp files were linked directly to "#{HOMEBREW_PREFIX}/share/emacs/site-lisp".
This may cause conflicts with other packages. This may cause conflicts with other packages.
They should instead be installed into: They should instead be installed into:
#{share}/emacs/site-lisp/#{name} #{share}/emacs/site-lisp/#{name}
The offending files are: The offending files are:
#{elisps * "\n "} #{elisps * "\n "}
EOS EOS
@ -251,7 +249,7 @@ module FormulaCellarChecks
Dir.chdir("/") do Dir.chdir("/") do
unless File.exist?(program_location) unless File.exist?(program_location)
return <<~EOS return <<~EOS
The plist #{key} does not exist: The plist "#{key}" does not exist:
#{program_location} #{program_location}
EOS EOS
end end
@ -260,7 +258,7 @@ module FormulaCellarChecks
end end
<<~EOS <<~EOS
The plist #{key} is not executable: The plist "#{key}" is not executable:
#{program_location} #{program_location}
EOS EOS
end end
@ -274,7 +272,7 @@ module FormulaCellarChecks
link.exist? && File.realpath(link).start_with?(HOMEBREW_CELLAR/name) link.exist? && File.realpath(link).start_with?(HOMEBREW_CELLAR/name)
end end
"Python formulae that are keg-only should not create `pip3` and `wheel3` symlinks" "Python formulae that are keg-only should not create `pip3` and `wheel3` symlinks."
end end
def audit_installed def audit_installed

View File

@ -1026,10 +1026,10 @@ class FormulaInstaller
return if link_overwrite_backup.empty? return if link_overwrite_backup.empty?
opoo "These files were overwritten during `brew link` step:" opoo "These files were overwritten during the `brew link` step:"
puts link_overwrite_backup.keys puts link_overwrite_backup.keys
puts puts
puts "They have been backed up in #{backup_dir}" puts "They have been backed up to: #{backup_dir}"
@show_summary_heading = true @show_summary_heading = true
end end
@ -1063,7 +1063,7 @@ class FormulaInstaller
Cleaner.new(formula).clean Cleaner.new(formula).clean
rescue Exception => e # rubocop:disable Lint/RescueException rescue Exception => e # rubocop:disable Lint/RescueException
opoo "The cleaning step did not complete successfully" opoo "The cleaning step did not complete successfully"
puts "Still, the installation was successful, so we will link it into your prefix" puts "Still, the installation was successful, so we will link it into your prefix."
odebug e, e.backtrace odebug e, e.backtrace
Homebrew.failed = true Homebrew.failed = true
@show_summary_heading = true @show_summary_heading = true

View File

@ -603,7 +603,7 @@ class Keg
begin begin
keg = Keg.for(src) keg = Keg.for(src)
rescue NotAKegError rescue NotAKegError
puts "Won't resolve conflicts for symlink #{dst} as it doesn't resolve into the Cellar" if verbose puts "Won't resolve conflicts for symlink #{dst} as it doesn't resolve into the Cellar." if verbose
return return
end end

View File

@ -104,7 +104,7 @@ can take several different forms:
* An arbitrary file: * An arbitrary file:
Homebrew can install formulae from a local path. It can point to either a Homebrew can install formulae from a local path. It can point to either a
formula file or a bottle. formula file or a bottle.
Prefix relative paths with `./` to prevent them being interpreted as a Prefix relative paths with `./` to prevent them from being interpreted as a
formula or tap name. formula or tap name.
## SPECIFYING CASKS ## SPECIFYING CASKS

View File

@ -141,7 +141,7 @@ module Homebrew
ohai "Searching for a previously deleted formula (in the last month)..." ohai "Searching for a previously deleted formula (in the last month)..."
if (tap.path/".git/shallow").exist? if (tap.path/".git/shallow").exist?
opoo <<~EOS opoo <<~EOS
#{tap} is shallow clone. To get complete history run: #{tap} is shallow clone. To get its complete history, run:
git -C "$(brew --repo #{tap})" fetch --unshallow git -C "$(brew --repo #{tap})" fetch --unshallow
EOS EOS
@ -168,10 +168,10 @@ module Homebrew
#{name} was deleted from #{tap.name} in commit #{short_hash}: #{name} was deleted from #{tap.name} in commit #{short_hash}:
#{commit_message} #{commit_message}
To show the formula before removal run: To show the formula before removal, run:
git -C "$(brew --repo #{tap})" show #{short_hash}^:#{relative_path} git -C "$(brew --repo #{tap})" show #{short_hash}^:#{relative_path}
If you still use this formula consider creating your own tap: If you still use this formula, consider creating your own tap:
#{Formatter.url("https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap")} #{Formatter.url("https://docs.brew.sh/How-to-Create-and-Maintain-a-Tap")}
EOS EOS
end end

View File

@ -266,7 +266,7 @@ module OS
Update them from Software Update in #{software_update_location} or run: Update them from Software Update in #{software_update_location} or run:
softwareupdate --all --install --force softwareupdate --all --install --force
If that doesn't show you an update run: If that doesn't show you any updates, run:
sudo rm -rf /Library/Developer/CommandLineTools sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install sudo xcode-select --install

View File

@ -150,7 +150,7 @@ class Resource
def verify_download_integrity(fn) def verify_download_integrity(fn)
if fn.file? if fn.file?
ohai "Verifying checksum for '#{fn.basename}'." if verbose? ohai "Verifying checksum for '#{fn.basename}'" if verbose?
fn.verify_checksum(checksum) fn.verify_checksum(checksum)
end end
rescue ChecksumMissingError rescue ChecksumMissingError

View File

@ -1,6 +1,6 @@
#!/bin/bash #!/bin/bash
pathremove () { pathremove() {
local IFS=':' NEWPATH="" DIR="" PATHVARIABLE=${2:-PATH} local IFS=':' NEWPATH="" DIR="" PATHVARIABLE=${2:-PATH}
for DIR in ${!PATHVARIABLE} ; do for DIR in ${!PATHVARIABLE} ; do
if [ "$DIR" != "$1" ] ; then if [ "$DIR" != "$1" ] ; then

View File

@ -89,7 +89,7 @@ class SystemCommand
env.each_key do |name| env.each_key do |name|
next if /^[\w&&\D]\w*$/.match?(name) next if /^[\w&&\D]\w*$/.match?(name)
raise ArgumentError, "Invalid variable name: '#{name}'" raise ArgumentError, "Invalid variable name: #{name}"
end end
@env = env @env = env
@input = Array(input) @input = Array(input)

View File

@ -89,8 +89,8 @@ describe Cask::Artifact::App, :cask do
describe "target is both writable and user-owned" do describe "target is both writable and user-owned" do
it "overwrites the existing app" do it "overwrites the existing app" do
stdout = <<~EOS stdout = <<~EOS
==> Removing App '#{target_path}'. ==> Removing App '#{target_path}'
==> Moving App 'Caffeine.app' to '#{target_path}'. ==> Moving App 'Caffeine.app' to '#{target_path}'
EOS EOS
stderr = <<~EOS stderr = <<~EOS
@ -137,8 +137,8 @@ describe Cask::Artifact::App, :cask do
).and_call_original ).and_call_original
stdout = <<~EOS stdout = <<~EOS
==> Removing App '#{target_path}'. ==> Removing App '#{target_path}'
==> Moving App 'Caffeine.app' to '#{target_path}'. ==> Moving App 'Caffeine.app' to '#{target_path}'
EOS EOS
stderr = <<~EOS stderr = <<~EOS
@ -180,8 +180,8 @@ describe Cask::Artifact::App, :cask do
it "overwrites the existing app" do it "overwrites the existing app" do
stdout = <<~EOS stdout = <<~EOS
==> Removing App '#{target_path}'. ==> Removing App '#{target_path}'
==> Moving App 'Caffeine.app' to '#{target_path}'. ==> Moving App 'Caffeine.app' to '#{target_path}'
EOS EOS
stderr = <<~EOS stderr = <<~EOS

View File

@ -12,7 +12,7 @@ describe Cask::Cmd::Install, :cask do
output = Regexp.new <<~EOS output = Regexp.new <<~EOS
==> Downloading file:.*caffeine.zip ==> Downloading file:.*caffeine.zip
==> Installing Cask local-caffeine ==> Installing Cask local-caffeine
==> Moving App 'Caffeine.app' to '.*Caffeine.app'. ==> Moving App 'Caffeine.app' to '.*Caffeine.app'
.*local-caffeine was successfully installed! .*local-caffeine was successfully installed!
EOS EOS
@ -118,7 +118,7 @@ describe Cask::Cmd::Install, :cask do
}.to raise_error( }.to raise_error(
Cask::CaskUnavailableError, Cask::CaskUnavailableError,
"Cask 'localcaffeine' is unavailable: No Cask with this name exists. "\ "Cask 'localcaffeine' is unavailable: No Cask with this name exists. "\
"Did you mean “local-caffeine”?", "Did you mean 'local-caffeine'?",
) )
end end

View File

@ -15,11 +15,11 @@ describe Cask::Cmd::Reinstall, :cask do
==> Downloading file:.*caffeine.zip ==> Downloading file:.*caffeine.zip
Already downloaded: .*--caffeine.zip Already downloaded: .*--caffeine.zip
==> Uninstalling Cask local-caffeine ==> Uninstalling Cask local-caffeine
==> Backing App 'Caffeine.app' up to '.*Caffeine.app'. ==> Backing App 'Caffeine.app' up to '.*Caffeine.app'
==> Removing App '.*Caffeine.app'. ==> Removing App '.*Caffeine.app'
==> Purging files for version 1.2.3 of Cask local-caffeine ==> Purging files for version 1.2.3 of Cask local-caffeine
==> Installing Cask local-caffeine ==> Installing Cask local-caffeine
==> Moving App 'Caffeine.app' to '.*Caffeine.app'. ==> Moving App 'Caffeine.app' to '.*Caffeine.app'
.*local-caffeine was successfully installed! .*local-caffeine was successfully installed!
EOS EOS

View File

@ -15,8 +15,8 @@ describe Cask::Cmd::Uninstall, :cask do
output = Regexp.new <<~EOS output = Regexp.new <<~EOS
==> Uninstalling Cask local-caffeine ==> Uninstalling Cask local-caffeine
==> Backing App 'Caffeine.app' up to '.*Caffeine.app'. ==> Backing App 'Caffeine.app' up to '.*Caffeine.app'
==> Removing App '.*Caffeine.app'. ==> Removing App '.*Caffeine.app'
==> Purging files for version 1.2.3 of Cask local-caffeine ==> Purging files for version 1.2.3 of Cask local-caffeine
EOS EOS

View File

@ -70,7 +70,7 @@ describe Homebrew::Diagnostic::Checks do
expect(subject.check_user_path_1).to be nil expect(subject.check_user_path_1).to be nil
expect(subject.check_user_path_2) expect(subject.check_user_path_2)
.to match("Homebrew's bin was not found in your PATH.") .to match("Homebrew's \"bin\" was not found in your PATH.")
end end
specify "#check_user_path_3" do specify "#check_user_path_3" do
@ -83,7 +83,7 @@ describe Homebrew::Diagnostic::Checks do
expect(subject.check_user_path_1).to be nil expect(subject.check_user_path_1).to be nil
expect(subject.check_user_path_2).to be nil expect(subject.check_user_path_2).to be nil
expect(subject.check_user_path_3) expect(subject.check_user_path_3)
.to match("Homebrew's sbin was not found in your PATH") .to match("Homebrew's \"sbin\" was not found in your PATH")
ensure ensure
sbin.rmtree sbin.rmtree
end end

View File

@ -194,7 +194,7 @@ describe Tap do
expect(services_tap).not_to be_private expect(services_tap).not_to be_private
end end
it "returns nil if the Tap is not a Git repo" do it "returns nil if the Tap is not a Git repository" do
expect(subject.remote).to be nil expect(subject.remote).to be nil
end end

View File

@ -24,7 +24,7 @@ module Homebrew
keg.lock do keg.lock do
print "Unlinking #{keg}... " print "Unlinking #{keg}... "
puts if verbose puts if verbose
puts "#{keg.unlink(**options)} symlinks removed" puts "#{keg.unlink(**options)} symlinks removed."
end end
end end
end end

View File

@ -1,6 +1,6 @@
export HOMEBREW_REQUIRED_RUBY_VERSION=2.6.3 export HOMEBREW_REQUIRED_RUBY_VERSION=2.6.3
test_ruby () { test_ruby() {
if [[ ! -x $1 ]] if [[ ! -x $1 ]]
then then
return 1 return 1

View File

@ -191,7 +191,7 @@ __brew_internal_commands() {
'test:Run the test method provided by an installed formula' 'test:Run the test method provided by an installed formula'
'tests:Run Homebrew'\''s unit and integration tests' 'tests:Run Homebrew'\''s unit and integration tests'
'typecheck:Check for typechecking errors using Sorbet' 'typecheck:Check for typechecking errors using Sorbet'
'unbottled:Outputs the unbottled dependents of formulae' 'unbottled:Show the unbottled dependents of formulae'
'uninstall:Uninstall a formula or cask' 'uninstall:Uninstall a formula or cask'
'unlink:Remove symlinks for formula from Homebrew'\''s prefix' 'unlink:Remove symlinks for formula from Homebrew'\''s prefix'
'unpack:Unpack the source files for formula into subdirectories of the current working directory' 'unpack:Unpack the source files for formula into subdirectories of the current working directory'
@ -1197,7 +1197,7 @@ _brew_outdated() {
'--formula[List only outdated formulae]' \ '--formula[List only outdated formulae]' \
'--greedy[Print outdated casks with `auto_updates` or `version :latest`]' \ '--greedy[Print outdated casks with `auto_updates` or `version :latest`]' \
'--help[Show this message]' \ '--help[Show this message]' \
'--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. ]' \ '--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. ]' \
'--quiet[List only the names of outdated kegs (takes precedence over `--verbose`)]' \ '--quiet[List only the names of outdated kegs (takes precedence over `--verbose`)]' \
'--verbose[Include detailed version information]' \ '--verbose[Include detailed version information]' \
'::formula:__brew_formulae' \ '::formula:__brew_formulae' \
@ -1599,11 +1599,11 @@ _brew_typecheck() {
_brew_unbottled() { _brew_unbottled() {
_arguments \ _arguments \
'--debug[Display any debugging information]' \ '--debug[Display any debugging information]' \
'--dependents[Don'\''t get analytics data and sort by number of dependents instead]' \ '--dependents[Skip getting analytics data and sort by number of dependents instead]' \
'--help[Show this message]' \ '--help[Show this message]' \
'--quiet[Make some output more quiet]' \ '--quiet[Make some output more quiet]' \
'--tag[Use the specified bottle tag (e.g. big_sur) instead of the current OS]' \ '--tag[Use the specified bottle tag (e.g. `big_sur`) instead of the current OS]' \
'--total[Output the number of unbottled and total formulae]' \ '--total[Print the number of unbottled and total formulae]' \
'--verbose[Make some output more verbose]' \ '--verbose[Make some output more verbose]' \
'::formula:__brew_formulae' '::formula:__brew_formulae'
} }

View File

@ -418,7 +418,7 @@ information is displayed in interactive shells, and suppressed otherwise.
* `--cask`: * `--cask`:
List only outdated casks. List only outdated casks.
* `--json`: * `--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. 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`: * `--fetch-HEAD`:
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. 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.
* `--greedy`: * `--greedy`:
@ -500,9 +500,9 @@ No online search is performed.
* `--pull-request`: * `--pull-request`:
Search for GitHub pull requests containing *`text`*. Search for GitHub pull requests containing *`text`*.
* `--open`: * `--open`:
Search for only open GitHub pull requests Search for only open GitHub pull requests.
* `--closed`: * `--closed`:
Search for only closed GitHub pull requests Search for only closed GitHub pull requests.
* `--macports`: * `--macports`:
Search for *`text`* in the given package manager's list. Search for *`text`* in the given package manager's list.
* `--fink`: * `--fink`:
@ -765,6 +765,10 @@ non-zero status if any errors are found.
Run additional, slower style checks that require a network connection. Run additional, slower style checks that require a network connection.
* `--new`: * `--new`:
Run various additional style checks to determine if a new formula or cask is eligible for Homebrew. This should be used when creating new formula and implies `--strict` and `--online`. Run various additional style checks to determine if a new formula or cask is eligible for Homebrew. This should be used when creating new formula and implies `--strict` and `--online`.
* `--[no-]appcast`:
Audit the appcast.
* `--token-conflicts`:
Audit for token conflicts.
* `--tap`: * `--tap`:
Check the formulae within the given tap, specified as *`user`*`/`*`repo`*. Check the formulae within the given tap, specified as *`user`*`/`*`repo`*.
* `--fix`: * `--fix`:
@ -789,10 +793,6 @@ non-zero status if any errors are found.
Treat all named arguments as formulae. Treat all named arguments as formulae.
* `--cask`: * `--cask`:
Treat all named arguments as casks. Treat all named arguments as casks.
* `--[no-]appcast`:
Audit the appcast
* `--token-conflicts`:
Audit for token conflicts
### `bottle` [*`options`*] *`installed_formula`*|*`file`* [...] ### `bottle` [*`options`*] *`installed_formula`*|*`file`* [...]
@ -1093,7 +1093,7 @@ casks to check is taken from `HOMEBREW_LIVECHECK_WATCHLIST` or
Generate Homebrew's manpages. Generate Homebrew's manpages.
Not (yet) working on Apple Silicon. *Note:* Not (yet) working on Apple Silicon.
* `--fail-if-changed`: * `--fail-if-changed`:
Return a failing status code if changes are detected in the manpage outputs. This can be used to notify CI when the manpages are out of date. Additionally, the date used in new manpages will match those in the existing manpages (to allow comparison without factoring in the date). Return a failing status code if changes are detected in the manpage outputs. This can be used to notify CI when the manpages are out of date. Additionally, the date used in new manpages will match those in the existing manpages (to allow comparison without factoring in the date).
@ -1362,14 +1362,14 @@ Not (yet) working on Apple Silicon.
### `unbottled` [*`options`*] [*`formula`* ...] ### `unbottled` [*`options`*] [*`formula`* ...]
Outputs the unbottled dependents of formulae. Show the unbottled dependents of formulae.
* `--tag`: * `--tag`:
Use the specified bottle tag (e.g. big_sur) instead of the current OS. Use the specified bottle tag (e.g. `big_sur`) instead of the current OS.
* `--dependents`: * `--dependents`:
Don't get analytics data and sort by number of dependents instead. Skip getting analytics data and sort by number of dependents instead.
* `--total`: * `--total`:
Output the number of unbottled and total formulae. Print the number of unbottled and total formulae.
### `unpack` [*`options`*] *`formula`* [...] ### `unpack` [*`options`*] *`formula`* [...]
@ -1676,7 +1676,7 @@ can take several different forms:
* An arbitrary file: * An arbitrary file:
Homebrew can install formulae from a local path. It can point to either a Homebrew can install formulae from a local path. It can point to either a
formula file or a bottle. formula file or a bottle.
Prefix relative paths with `./` to prevent them being interpreted as a Prefix relative paths with `./` to prevent them from being interpreted as a
formula or tap name. formula or tap name.
## SPECIFYING CASKS ## SPECIFYING CASKS
@ -1697,7 +1697,7 @@ example, run `export HOMEBREW_NO_INSECURE_REDIRECT=1` rather than just
*Default:* `native`. *Default:* `native`.
- `HOMEBREW_ARTIFACT_DOMAIN` - `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`. <br>Prefix all download URLs, including those for bottles, with this value. 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` - `HOMEBREW_AUTO_UPDATE_SECS`
<br>Automatically check for updates once per this seconds interval. <br>Automatically check for updates once per this seconds interval.
@ -1878,7 +1878,7 @@ example, run `export HOMEBREW_NO_INSECURE_REDIRECT=1` rather than just
*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. *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` - `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 HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS days. <br>If set, `brew install`, `brew upgrade` and `brew reinstall` will never automatically cleanup installed/upgraded/reinstalled formulae or all formulae every `HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS` days.
- `HOMEBREW_PRY` - `HOMEBREW_PRY`
<br>If set, use Pry for the `brew irb` command. <br>If set, use Pry for the `brew irb` command.

View File

@ -565,7 +565,7 @@ List only outdated casks\.
. .
.TP .TP
\fB\-\-json\fR \fB\-\-json\fR
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\. Print output in JSON format\. There are two versions: \fBv1\fR and \fBv2\fR\. \fBv1\fR is deprecated and is currently the default if no version is specified\. \fBv2\fR prints outdated formulae and casks\.
. .
.TP .TP
\fB\-\-fetch\-HEAD\fR \fB\-\-fetch\-HEAD\fR
@ -678,11 +678,11 @@ Search for GitHub pull requests containing \fItext\fR\.
. .
.TP .TP
\fB\-\-open\fR \fB\-\-open\fR
Search for only open GitHub pull requests Search for only open GitHub pull requests\.
. .
.TP .TP
\fB\-\-closed\fR \fB\-\-closed\fR
Search for only closed GitHub pull requests Search for only closed GitHub pull requests\.
. .
.TP .TP
\fB\-\-macports\fR \fB\-\-macports\fR
@ -1030,6 +1030,14 @@ Run additional, slower style checks that require a network connection\.
Run various additional style checks to determine if a new formula or cask is eligible for Homebrew\. This should be used when creating new formula and implies \fB\-\-strict\fR and \fB\-\-online\fR\. Run various additional style checks to determine if a new formula or cask is eligible for Homebrew\. This should be used when creating new formula and implies \fB\-\-strict\fR and \fB\-\-online\fR\.
. .
.TP .TP
\fB\-\-[no\-]appcast\fR
Audit the appcast\.
.
.TP
\fB\-\-token\-conflicts\fR
Audit for token conflicts\.
.
.TP
\fB\-\-tap\fR \fB\-\-tap\fR
Check the formulae within the given tap, specified as \fIuser\fR\fB/\fR\fIrepo\fR\. Check the formulae within the given tap, specified as \fIuser\fR\fB/\fR\fIrepo\fR\.
. .
@ -1077,14 +1085,6 @@ Treat all named arguments as formulae\.
\fB\-\-cask\fR \fB\-\-cask\fR
Treat all named arguments as casks\. Treat all named arguments as casks\.
. .
.TP
\fB\-\-[no\-]appcast\fR
Audit the appcast
.
.TP
\fB\-\-token\-conflicts\fR
Audit for token conflicts
.
.SS "\fBbottle\fR [\fIoptions\fR] \fIinstalled_formula\fR|\fIfile\fR [\.\.\.]" .SS "\fBbottle\fR [\fIoptions\fR] \fIinstalled_formula\fR|\fIfile\fR [\.\.\.]"
Generate a bottle (binary package) from a formula that was 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\. Generate a bottle (binary package) from a formula that was 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\.
. .
@ -1506,7 +1506,7 @@ Only check casks\.
Generate Homebrew\'s manpages\. Generate Homebrew\'s manpages\.
. .
.P .P
Not (yet) working on Apple Silicon\. \fINote:\fR Not (yet) working on Apple Silicon\.
. .
.TP .TP
\fB\-\-fail\-if\-changed\fR \fB\-\-fail\-if\-changed\fR
@ -1878,19 +1878,19 @@ Typecheck a single file\.
Ignores input files that contain the given string in their paths (relative to the input path passed to Sorbet)\. Ignores input files that contain the given string in their paths (relative to the input path passed to Sorbet)\.
. .
.SS "\fBunbottled\fR [\fIoptions\fR] [\fIformula\fR \.\.\.]" .SS "\fBunbottled\fR [\fIoptions\fR] [\fIformula\fR \.\.\.]"
Outputs the unbottled dependents of formulae\. Show the unbottled dependents of formulae\.
. .
.TP .TP
\fB\-\-tag\fR \fB\-\-tag\fR
Use the specified bottle tag (e\.g\. big_sur) instead of the current OS\. Use the specified bottle tag (e\.g\. \fBbig_sur\fR) instead of the current OS\.
. .
.TP .TP
\fB\-\-dependents\fR \fB\-\-dependents\fR
Don\'t get analytics data and sort by number of dependents instead\. Skip getting analytics data and sort by number of dependents instead\.
. .
.TP .TP
\fB\-\-total\fR \fB\-\-total\fR
Output the number of unbottled and total formulae\. Print the number of unbottled and total formulae\.
. .
.SS "\fBunpack\fR [\fIoptions\fR] \fIformula\fR [\.\.\.]" .SS "\fBunpack\fR [\fIoptions\fR] \fIformula\fR [\.\.\.]"
Unpack the source files for \fIformula\fR into subdirectories of the current working directory\. Unpack the source files for \fIformula\fR into subdirectories of the current working directory\.
@ -2322,7 +2322,7 @@ Sometimes a formula from a tapped repository may conflict with one in \fBhomebre
. .
.TP .TP
An arbitrary file An arbitrary file
Homebrew can install formulae from a local path\. It can point to either a formula file or a bottle\. Prefix relative paths with \fB\./\fR to prevent them being interpreted as a formula or tap name\. Homebrew can install formulae from a local path\. It can point to either a formula file or a bottle\. Prefix relative paths with \fB\./\fR to prevent them from being interpreted as a formula or tap name\.
. .
.SH "SPECIFYING CASKS" .SH "SPECIFYING CASKS"
Many Homebrew Cask commands accept one or more \fIcask\fR arguments\. These can be specified the same way as the \fIformula\fR arguments described in \fBSPECIFYING FORMULAE\fR above\. Many Homebrew Cask commands accept one or more \fIcask\fR arguments\. These can be specified the same way as the \fIformula\fR arguments described in \fBSPECIFYING FORMULAE\fR above\.
@ -2343,7 +2343,7 @@ Linux only: Pass this value to a type name representing the compiler\'s \fB\-mar
\fBHOMEBREW_ARTIFACT_DOMAIN\fR \fBHOMEBREW_ARTIFACT_DOMAIN\fR
. .
.br .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\. Prefix all download URLs, including those for bottles, with this value\. 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 .TP
\fBHOMEBREW_AUTO_UPDATE_SECS\fR \fBHOMEBREW_AUTO_UPDATE_SECS\fR
@ -2682,7 +2682,7 @@ If set, forbid redirects from secure HTTPS to insecure HTTP\.
\fBHOMEBREW_NO_INSTALL_CLEANUP\fR \fBHOMEBREW_NO_INSTALL_CLEANUP\fR
. .
.br .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 HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS days\. If set, \fBbrew install\fR, \fBbrew upgrade\fR and \fBbrew reinstall\fR will never automatically cleanup installed/upgraded/reinstalled formulae or all formulae every \fBHOMEBREW_CLEANUP_PERIODIC_FULL_DAYS\fR days\.
. .
.TP .TP
\fBHOMEBREW_PRY\fR \fBHOMEBREW_PRY\fR