diff --git a/Library/Homebrew/cmd/fetch.rb b/Library/Homebrew/cmd/fetch.rb index b1fa2462df..85b9abf1e1 100644 --- a/Library/Homebrew/cmd/fetch.rb +++ b/Library/Homebrew/cmd/fetch.rb @@ -36,7 +36,6 @@ module Homebrew switch "--force-bottle", description: "Download a bottle if it exists for the current or newest version of macOS, "\ "even if it would not be used during installation." - switch :verbose switch :debug conflicts "--devel", "--HEAD" conflicts "--build-from-source", "--build-bottle", "--force-bottle" diff --git a/Library/Homebrew/cmd/list.rb b/Library/Homebrew/cmd/list.rb index ed088f0e8d..57f4a7cd59 100644 --- a/Library/Homebrew/cmd/list.rb +++ b/Library/Homebrew/cmd/list.rb @@ -16,7 +16,7 @@ module Homebrew EOS switch "--full-name", description: "Print formulae with fully-qualified names. If `--full-name` is not "\ - "passed, other options (i.e. `-1`, `-l`, `-t` and `-r`) are passed to `ls` "\ + "passed, other options (i.e. `-1`, `-l`, `-r` and `-t`) are passed to `ls`(1) "\ "which produces the actual output." switch "--unbrewed", description: "List all files in the Homebrew prefix not installed by Homebrew." diff --git a/Library/Homebrew/cmd/log.rb b/Library/Homebrew/cmd/log.rb index 7ca70f6b4c..ec315bd1b7 100644 --- a/Library/Homebrew/cmd/log.rb +++ b/Library/Homebrew/cmd/log.rb @@ -19,7 +19,7 @@ module Homebrew description: "Also output diffstat from commit." switch "--oneline", description: "Output only one line per commit." - switch "-1", "--max-count=1", + flag "-1", "--max-count", description: "Output only one commit." end end diff --git a/Library/Homebrew/cmd/sh.rb b/Library/Homebrew/cmd/sh.rb index c9a4197e43..9f48359fe0 100644 --- a/Library/Homebrew/cmd/sh.rb +++ b/Library/Homebrew/cmd/sh.rb @@ -19,7 +19,7 @@ module Homebrew which otherwise build systems would not find. EOS flag "--env=", - description: "Use the standard `PATH` instead of superenv's when is passed." + description: "Use the standard `PATH` instead of superenv's when `std` is passed." switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/tap.rb b/Library/Homebrew/cmd/tap.rb index 5bd937d201..c9a2046be8 100644 --- a/Library/Homebrew/cmd/tap.rb +++ b/Library/Homebrew/cmd/tap.rb @@ -19,7 +19,7 @@ module Homebrew `brew tap` `/` `https://github.com/``/homebrew-`. With specified, tap a formula repository from anywhere, using - any transport protocol that `git` handles. The one-argument form of `tap` + any transport protocol that `git`(1) handles. The one-argument form of `tap` 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. diff --git a/Library/Homebrew/cmd/update-reset.sh b/Library/Homebrew/cmd/update-reset.sh index 70e2867a62..72ea395e4e 100644 --- a/Library/Homebrew/cmd/update-reset.sh +++ b/Library/Homebrew/cmd/update-reset.sh @@ -1,6 +1,6 @@ #: * `update-reset` [] #: -#: Fetches and resets Homebrew and all tap repositories (or any specified `repository`) using `git`(1) to their latest `origin/master`. Note this will destroy all your uncommitted or committed changes. +#: Fetches and resets Homebrew and all tap repositories (or any specified ) using `git`(1) to their latest `origin/master`. Note this will destroy all your uncommitted or committed changes. homebrew-update-reset() { local DIR diff --git a/Library/Homebrew/dev-cmd/bump-formula-pr.rb b/Library/Homebrew/dev-cmd/bump-formula-pr.rb index ffd711eec4..d79b69e4a8 100644 --- a/Library/Homebrew/dev-cmd/bump-formula-pr.rb +++ b/Library/Homebrew/dev-cmd/bump-formula-pr.rb @@ -11,7 +11,7 @@ module Homebrew usage_banner <<~EOS `bump-formula-pr` [] [] - Create a pull request to update a formula with a new URL or a new tag. + Create a pull request to update with a new URL or a new tag. If a is specified, the checksum of the new download should also be specified. A best effort to determine the and name will diff --git a/Library/Homebrew/dev-cmd/bump-revision.rb b/Library/Homebrew/dev-cmd/bump-revision.rb index db06fad423..94f9776ee4 100644 --- a/Library/Homebrew/dev-cmd/bump-revision.rb +++ b/Library/Homebrew/dev-cmd/bump-revision.rb @@ -11,7 +11,7 @@ module Homebrew usage_banner <<~EOS `bump-revision` [] [] - Create a commit to increment the revision of the formula. If no revision is + Create a commit to increment the revision of . If no revision is present, "revision 1" will be added. EOS switch "-n", "--dry-run", diff --git a/Library/Homebrew/dev-cmd/edit.rb b/Library/Homebrew/dev-cmd/edit.rb index b4ace42c59..ba2495c319 100644 --- a/Library/Homebrew/dev-cmd/edit.rb +++ b/Library/Homebrew/dev-cmd/edit.rb @@ -11,8 +11,8 @@ module Homebrew usage_banner <<~EOS `edit` [] - Open a formula in the editor set by `EDITOR` or `HOMEBREW_EDITOR`, or open the - Homebrew repository for editing if no is provided. + Open in the editor set by `EDITOR` or `HOMEBREW_EDITOR`, or open the + Homebrew repository for editing if no formula is provided. EOS switch :force switch :verbose diff --git a/Library/Homebrew/dev-cmd/extract.rb b/Library/Homebrew/dev-cmd/extract.rb index 1f2c0cddee..8c2457a864 100644 --- a/Library/Homebrew/dev-cmd/extract.rb +++ b/Library/Homebrew/dev-cmd/extract.rb @@ -84,7 +84,7 @@ module Homebrew Look through repository history to find the most recent version of and create a copy in `/Formula/``@``.rb`. If the tap is not installed yet, attempt to install/clone the tap before continuing. To extract - a from a tap that is not homebrew/core use //. + a formula from a tap that is not `homebrew/core` use `/``/`. EOS flag "--version=", description: "Extract the provided of instead of the most recent." diff --git a/Library/Homebrew/dev-cmd/formula.rb b/Library/Homebrew/dev-cmd/formula.rb index 7b1ca23073..75b2ed1590 100644 --- a/Library/Homebrew/dev-cmd/formula.rb +++ b/Library/Homebrew/dev-cmd/formula.rb @@ -11,7 +11,7 @@ module Homebrew usage_banner <<~EOS `formula` - Display the path where a formula is located. + Display the path where is located. EOS switch :verbose switch :debug diff --git a/Library/Homebrew/dev-cmd/ruby.rb b/Library/Homebrew/dev-cmd/ruby.rb index 83d97cd313..68a44f7645 100644 --- a/Library/Homebrew/dev-cmd/ruby.rb +++ b/Library/Homebrew/dev-cmd/ruby.rb @@ -8,7 +8,7 @@ module Homebrew def ruby_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `ruby` [`-e`]: + `ruby` [`-e`] Run a Ruby instance with Homebrew's libraries loaded, e.g. `brew ruby -e "puts :gcc.f.deps"` or `brew ruby script.rb`. diff --git a/Library/Homebrew/manpages/brew.1.md.erb b/Library/Homebrew/manpages/brew.1.md.erb index 927de8ad54..2a70e97bc4 100644 --- a/Library/Homebrew/manpages/brew.1.md.erb +++ b/Library/Homebrew/manpages/brew.1.md.erb @@ -71,7 +71,7 @@ See `brew bundle --help`. ### `cask` : -Install macOS applications distributed as binaries. See brew-cask(1). +Install macOS applications distributed as binaries. See `brew-cask`(1). **Homebrew/homebrew-cask**: @@ -198,7 +198,7 @@ Note that environment variables must have a value set to be detected. For exampl even if the system version of Ruby is new enough. * `HOMEBREW_FORCE_BREWED_GIT`: - If set, Homebrew will always use a Homebrew-installed `git` rather than the + If set, Homebrew will always use a Homebrew-installed `git`(1) rather than the system version. Automatically set if the system version of `git` is too old. * `HOMEBREW_GITHUB_API_TOKEN`: