manpages: output formatting fixes

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"

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."

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

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 <std> is passed."
+             description: "Use the standard `PATH` instead of superenv's when `std` is passed."
       switch :verbose
       switch :debug
     end

Library/Homebrew/cmd/tap.rb

@@ -19,7 +19,7 @@ module Homebrew
         `brew tap` <user>`/`<repo> `https://github.com/`<user>`/homebrew-`<repo>.
 
         With <URL> 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.

Library/Homebrew/cmd/update-reset.sh

@@ -1,6 +1,6 @@
 #:  * `update-reset` [<repository>]
 #:
-#:  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 <repository>) using `git`(1) to their latest `origin/master`. Note this will destroy all your uncommitted or committed changes.
 
 homebrew-update-reset() {
   local DIR

Library/Homebrew/dev-cmd/bump-formula-pr.rb

@@ -11,7 +11,7 @@ module Homebrew
       usage_banner <<~EOS
         `bump-formula-pr` [<options>] [<formula>]
 
-        Create a pull request to update a formula with a new URL or a new tag.
+        Create a pull request to update <formula> with a new URL or a new tag.
 
         If a <URL> is specified, the <SHA-256> checksum of the new download should also
         be specified. A best effort to determine the <SHA-256> and <formula> name will

Library/Homebrew/dev-cmd/bump-revision.rb

@@ -11,7 +11,7 @@ module Homebrew
       usage_banner <<~EOS
         `bump-revision` [<options>] [<formula>]
 
-        Create a commit to increment the revision of the formula. If no revision is
+        Create a commit to increment the revision of <formula>. If no revision is
         present, "revision 1" will be added.
       EOS
       switch "-n", "--dry-run",

Library/Homebrew/dev-cmd/edit.rb

@@ -11,8 +11,8 @@ module Homebrew
       usage_banner <<~EOS
         `edit` [<formula>]
 
-        Open a formula in the editor set by `EDITOR` or `HOMEBREW_EDITOR`, or open the
+        Open <formula> in the editor set by `EDITOR` or `HOMEBREW_EDITOR`, or open the
-        Homebrew repository for editing if no <formula> is provided.
+        Homebrew repository for editing if no formula is provided.
       EOS
       switch :force
       switch :verbose

Library/Homebrew/dev-cmd/extract.rb

@@ -84,7 +84,7 @@ module Homebrew
         Look through repository history to find the most recent version of <formula> and
         create a copy in <tap>`/Formula/`<formula>`@`<version>`.rb`. If the tap is not
         installed yet, attempt to install/clone the tap before continuing. To extract
-        a <formula> from a tap that is not homebrew/core use <user>/<repo>/<formula>.
+        a formula from a tap that is not `homebrew/core` use <user>`/`<repo>`/`<formula>.
       EOS
       flag   "--version=",
              description: "Extract the provided <version> of <formula> instead of the most recent."

Library/Homebrew/dev-cmd/formula.rb

@@ -11,7 +11,7 @@ module Homebrew
       usage_banner <<~EOS
         `formula` <formula>
 
-        Display the path where a formula is located.
+        Display the path where <formula> is located.
       EOS
       switch :verbose
       switch :debug

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`.

Library/Homebrew/manpages/brew.1.md.erb

@@ -71,7 +71,7 @@ See `brew bundle --help`.
 
 ### `cask` <subcommand>:
 
-Install macOS applications distributed as binaries. See brew-cask(1).
+Install macOS applications distributed as binaries. See `brew-cask`(1).
 
 **Homebrew/homebrew-cask**: <https://github.com/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`: