manpages: grammar fixes

Library/Homebrew/cmd/--version.rb

@@ -10,7 +10,7 @@ module Homebrew
       usage_banner <<~EOS
         `--version`
 
-        Print the version number of Homebrew, Homebrew/homebrew-core and Homebrew/homebrew-cask
+        Print the version numbers of Homebrew, Homebrew/homebrew-core and Homebrew/homebrew-cask
         (if tapped) to standard output and exit.
       EOS
     end

Library/Homebrew/cmd/analytics.rb

@@ -15,7 +15,7 @@ module Homebrew
         If `state` is passed, display anonymous user behaviour analytics state.
         Read more at <https://docs.brew.sh/Analytics>.
 
-        If `regenerate-uuid` is passed, regenerate UUID used in Homebrew's analytics.
+        If `regenerate-uuid` is passed, regenerate the UUID used in Homebrew's analytics.
       EOS
       switch :verbose
       switch :debug

Library/Homebrew/cmd/install.rb

@@ -28,7 +28,7 @@ module Homebrew
       EOS
       switch :debug,
              description: "If brewing fails, open an interactive debugging session with access to IRB "\
-                          "or a shell inside the temporary build directory"
+                          "or a shell inside the temporary build directory."
       flag   "--env=",
              description: "If `std` is passed, use the standard build environment instead of superenv. "\
                           "If `super` is passed, use superenv even if the formula specifies the "\
@@ -230,7 +230,7 @@ module Homebrew
         opoo msg
       elsif f.migration_needed? && !args.force?
         # Check if the formula we try to install is the same as installed
-        # but not migrated one. If --force passed then install anyway.
+        # but not migrated one. If --force is passed then install anyway.
         opoo <<~EOS
           #{f.oldname} is already installed, it's just not migrated
           You can migrate this formula with `brew migrate #{f}`

Library/Homebrew/cmd/migrate.rb

@@ -11,12 +11,12 @@ module Homebrew
       usage_banner <<~EOS
         `migrate` [<options>] <formula>
 
-        Migrate renamed packages to new name, where <formula> are old names of
+        Migrate renamed packages to new names, where <formula> are old names of
         packages.
       EOS
       switch :force,
-             description: "Treat installed <formula> and passed <formula> like if they are from "\
+             description: "Treat installed <formula> and passed <formula> as if they are from "\
-                          "same taps and migrate them anyway."
+                          "the same taps and migrate them anyway."
       switch :verbose
       switch :debug
     end

Library/Homebrew/cmd/missing.rb

@@ -20,7 +20,7 @@ module Homebrew
       EOS
       comma_array "--hide",
                   description: "Act as if none of the provided <hidden> are installed. <hidden> should be "\
-                               "comma-separated list of formulae."
+                               "a comma-separated list of formulae."
       switch :verbose
       switch :debug
     end

Library/Homebrew/cmd/options.rb

@@ -12,7 +12,7 @@ module Homebrew
       usage_banner <<~EOS
         `options` [<options>] <formula>
 
-        Display install options specific to <formula>
+        Display install options specific to <formula>.
       EOS
       switch "--compact",
              description: "Show all options on a single line separated by spaces."

Library/Homebrew/cmd/reinstall.rb

@@ -22,7 +22,7 @@ module Homebrew
       EOS
       switch :debug,
              description: "If brewing fails, open an interactive debugging session with access to IRB "\
-                          "or a shell inside the temporary build directory"
+                          "or a shell inside the temporary build directory."
       switch "-s", "--build-from-source",
              description: "Compile <formula> from source even if a bottle is available."
       switch "--force-bottle",

Library/Homebrew/cmd/search.rb

@@ -40,7 +40,7 @@ module Homebrew
              description: "Display all locally available casks (including tapped ones). "\
                           "No online search is performed."
       switch "--desc",
-             description: "search formulae with a description matching <text> and casks with "\
+             description: "Search for formulae with a description matching <text> and casks with "\
                           "a name matching <text>."
 
       package_manager_switches = PACKAGE_MANAGERS.keys.map { |name| "--#{name}" }

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/switch.rb

@@ -12,7 +12,7 @@ module Homebrew
       usage_banner <<~EOS
         `switch` <formula> <version>
 
-        Symlink all of the specific <version> of <formula>'s install to Homebrew prefix.
+        Symlink all of the specified <version> of <formula>'s installation into Homebrew's prefix.
       EOS
       switch_option :verbose
       switch_option :debug

Library/Homebrew/cmd/tap.rb

@@ -14,20 +14,20 @@ module Homebrew
 
         List all installed taps when no arguments are passed.
 
-        With <URL> unspecified, taps a formula repository from GitHub using HTTPS.
+        With <URL> unspecified, tap a formula repository from GitHub using HTTPS.
         Since so many taps are hosted on GitHub, this command is a shortcut for
         `brew tap` <user>`/`<repo> `https://github.com/`<user>`/homebrew-`<repo>.
 
-        With <URL> specified, taps a formula repository from anywhere, using
+        With <URL> specified, tap a formula repository from anywhere, using
         any transport protocol that `git` 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.
+        using protocols other than HTTPS, e.g. SSH, GIT, HTTP, FTP(S), RSYNC.
       EOS
       switch "--full",
              description: "Use a full clone when tapping a repository. By default, the repository is "\
                           "cloned as a shallow copy (`--depth=1`). To convert a shallow copy to a "\
-                          "full copy, you can retap passing `--full` without first untapping."
+                          "full copy, you can retap by passing `--full` without first untapping."
       switch "--force-auto-update",
              description: "Auto-update tap even if it is not hosted on GitHub. By default, only taps "\
                           "hosted on GitHub are auto-updated (for performance reasons)."

Library/Homebrew/cmd/uninstall.rb

@@ -17,7 +17,7 @@ module Homebrew
         Uninstall <formula>.
       EOS
       switch :force,
-             description: "Delete all installed versions of the <formula>"
+             description: "Delete all installed versions of <formula>."
       switch "--ignore-dependencies",
              description: "Don't fail uninstall, even if <formula> is a dependency of any installed "\
                           "formulae."

Library/Homebrew/cmd/upgrade.rb

@@ -26,7 +26,7 @@ module Homebrew
       EOS
       switch :debug,
              description: "If brewing fails, open an interactive debugging session with access to IRB "\
-                          "or a shell inside the temporary build directory"
+                          "or a shell inside the temporary build directory."
       switch "-s", "--build-from-source",
              description: "Compile <formula> from source even if a bottle is available."
       switch "--force-bottle",

Library/Homebrew/cmd/uses.rb

@@ -37,9 +37,9 @@ module Homebrew
       switch "--skip-recommended",
              description: "Skip all formulae that specify <formula> as `:recommended` type dependency."
       switch "--devel",
-             description: "Show usage of <formula> by development build."
+             description: "Show usage of <formula> by development builds."
       switch "--HEAD",
-             description: "Show usage of <formula> by HEAD build."
+             description: "Show usage of <formula> by HEAD builds."
       switch :debug
       conflicts "--devel", "--HEAD"
     end

Library/Homebrew/dev-cmd/audit.rb

@@ -38,7 +38,7 @@ module Homebrew
       switch "--display-cop-names",
              description: "Include the RuboCop cop name for each violation in the output."
       switch "--display-filename",
-             description: "Prefix every line of output with name of the file or formula being audited, to "\
+             description: "Prefix every line of output with the file or formula name being audited, to "\
                           "make output easy to grep."
       switch "-D", "--audit-debug",
              description: "Enable debugging and profiling of audit methods."

Library/Homebrew/dev-cmd/prof.rb

@@ -10,7 +10,7 @@ module Homebrew
       usage_banner <<~EOS
         `prof` <command>
 
-        Run Homebrew with the Ruby profiler e.g. `brew prof readall`.
+        Run Homebrew with the Ruby profiler, e.g. `brew prof readall`.
       EOS
     end
   end

Library/Homebrew/dev-cmd/ruby.rb

@@ -10,8 +10,8 @@ module Homebrew
       usage_banner <<~EOS
         `ruby` [`-e`]:
 
-        Run a Ruby instance with Homebrew's libraries loaded e.g.
+        Run a Ruby instance with Homebrew's libraries loaded, e.g.
-        `brew ruby -e "puts :gcc.f.deps"` or `brew ruby script.rb`
+        `brew ruby -e "puts :gcc.f.deps"` or `brew ruby script.rb`.
       EOS
       switch "-e",
              description: "Execute the provided string argument as a script."

Library/Homebrew/diagnostic.rb

@@ -105,7 +105,7 @@ module Homebrew
           You will encounter build failures with some formulae.
           Please create pull requests instead of asking for help on Homebrew's GitHub,
           Discourse, Twitter or IRC. You are responsible for resolving any issues you
-          experience, as you are running this #{what}.
+          experience while you are running this #{what}.
         EOS
       end