From 65207853075891c818b2bd61377fac0dc82a75c3 Mon Sep 17 00:00:00 2001 From: EricFromCanada Date: Tue, 6 Aug 2019 14:22:24 -0400 Subject: [PATCH] manpages: grammar fixes --- Library/Homebrew/cmd/--version.rb | 2 +- Library/Homebrew/cmd/analytics.rb | 2 +- Library/Homebrew/cmd/install.rb | 4 ++-- Library/Homebrew/cmd/migrate.rb | 6 +++--- Library/Homebrew/cmd/missing.rb | 2 +- Library/Homebrew/cmd/options.rb | 2 +- Library/Homebrew/cmd/reinstall.rb | 2 +- Library/Homebrew/cmd/search.rb | 2 +- Library/Homebrew/cmd/sh.rb | 2 +- Library/Homebrew/cmd/switch.rb | 2 +- Library/Homebrew/cmd/tap.rb | 8 ++++---- Library/Homebrew/cmd/uninstall.rb | 2 +- Library/Homebrew/cmd/upgrade.rb | 2 +- Library/Homebrew/cmd/uses.rb | 4 ++-- Library/Homebrew/dev-cmd/audit.rb | 2 +- Library/Homebrew/dev-cmd/prof.rb | 2 +- Library/Homebrew/dev-cmd/ruby.rb | 4 ++-- Library/Homebrew/diagnostic.rb | 2 +- 18 files changed, 26 insertions(+), 26 deletions(-) diff --git a/Library/Homebrew/cmd/--version.rb b/Library/Homebrew/cmd/--version.rb index c89ba493d5..e5f5453c47 100644 --- a/Library/Homebrew/cmd/--version.rb +++ b/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 diff --git a/Library/Homebrew/cmd/analytics.rb b/Library/Homebrew/cmd/analytics.rb index 7302ceeb2a..e34059d4ef 100644 --- a/Library/Homebrew/cmd/analytics.rb +++ b/Library/Homebrew/cmd/analytics.rb @@ -15,7 +15,7 @@ module Homebrew If `state` is passed, display anonymous user behaviour analytics state. Read more at . - 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 diff --git a/Library/Homebrew/cmd/install.rb b/Library/Homebrew/cmd/install.rb index 3480c1a540..1700b3da2f 100644 --- a/Library/Homebrew/cmd/install.rb +++ b/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}` diff --git a/Library/Homebrew/cmd/migrate.rb b/Library/Homebrew/cmd/migrate.rb index d4de084c4c..7ef015e885 100644 --- a/Library/Homebrew/cmd/migrate.rb +++ b/Library/Homebrew/cmd/migrate.rb @@ -11,12 +11,12 @@ module Homebrew usage_banner <<~EOS `migrate` [] - Migrate renamed packages to new name, where are old names of + Migrate renamed packages to new names, where are old names of packages. EOS switch :force, - description: "Treat installed and passed like if they are from "\ - "same taps and migrate them anyway." + description: "Treat installed and passed as if they are from "\ + "the same taps and migrate them anyway." switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/missing.rb b/Library/Homebrew/cmd/missing.rb index 532ac55c24..217060ec52 100644 --- a/Library/Homebrew/cmd/missing.rb +++ b/Library/Homebrew/cmd/missing.rb @@ -20,7 +20,7 @@ module Homebrew EOS comma_array "--hide", description: "Act as if none of the provided are installed. should be "\ - "comma-separated list of formulae." + "a comma-separated list of formulae." switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/options.rb b/Library/Homebrew/cmd/options.rb index 3f35f15024..979e425686 100644 --- a/Library/Homebrew/cmd/options.rb +++ b/Library/Homebrew/cmd/options.rb @@ -12,7 +12,7 @@ module Homebrew usage_banner <<~EOS `options` [] - Display install options specific to + Display install options specific to . EOS switch "--compact", description: "Show all options on a single line separated by spaces." diff --git a/Library/Homebrew/cmd/reinstall.rb b/Library/Homebrew/cmd/reinstall.rb index 16557a90b2..e3a3acc606 100644 --- a/Library/Homebrew/cmd/reinstall.rb +++ b/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 from source even if a bottle is available." switch "--force-bottle", diff --git a/Library/Homebrew/cmd/search.rb b/Library/Homebrew/cmd/search.rb index 7a5c0fda44..932493783a 100644 --- a/Library/Homebrew/cmd/search.rb +++ b/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 and casks with "\ + description: "Search for formulae with a description matching and casks with "\ "a name matching ." package_manager_switches = PACKAGE_MANAGERS.keys.map { |name| "--#{name}" } diff --git a/Library/Homebrew/cmd/sh.rb b/Library/Homebrew/cmd/sh.rb index b82fbf9123..c9a4197e43 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 is passed." switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/switch.rb b/Library/Homebrew/cmd/switch.rb index 56e005d1d8..c7e3a1850a 100644 --- a/Library/Homebrew/cmd/switch.rb +++ b/Library/Homebrew/cmd/switch.rb @@ -12,7 +12,7 @@ module Homebrew usage_banner <<~EOS `switch` - Symlink all of the specific of 's install to Homebrew prefix. + Symlink all of the specified of 's installation into Homebrew's prefix. EOS switch_option :verbose switch_option :debug diff --git a/Library/Homebrew/cmd/tap.rb b/Library/Homebrew/cmd/tap.rb index fc93506a49..5bd937d201 100644 --- a/Library/Homebrew/cmd/tap.rb +++ b/Library/Homebrew/cmd/tap.rb @@ -14,20 +14,20 @@ module Homebrew List all installed taps when no arguments are passed. - With unspecified, taps a formula repository from GitHub using HTTPS. + With 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` `/` `https://github.com/``/homebrew-`. - With specified, taps a formula repository from anywhere, using + With 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)." diff --git a/Library/Homebrew/cmd/uninstall.rb b/Library/Homebrew/cmd/uninstall.rb index f6d18e3cff..6604665548 100644 --- a/Library/Homebrew/cmd/uninstall.rb +++ b/Library/Homebrew/cmd/uninstall.rb @@ -17,7 +17,7 @@ module Homebrew Uninstall . EOS switch :force, - description: "Delete all installed versions of the " + description: "Delete all installed versions of ." switch "--ignore-dependencies", description: "Don't fail uninstall, even if is a dependency of any installed "\ "formulae." diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb index 1a42aa3930..1f59c25722 100644 --- a/Library/Homebrew/cmd/upgrade.rb +++ b/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 from source even if a bottle is available." switch "--force-bottle", diff --git a/Library/Homebrew/cmd/uses.rb b/Library/Homebrew/cmd/uses.rb index 590d6289f4..cf1edeef5f 100644 --- a/Library/Homebrew/cmd/uses.rb +++ b/Library/Homebrew/cmd/uses.rb @@ -37,9 +37,9 @@ module Homebrew switch "--skip-recommended", description: "Skip all formulae that specify as `:recommended` type dependency." switch "--devel", - description: "Show usage of by development build." + description: "Show usage of by development builds." switch "--HEAD", - description: "Show usage of by HEAD build." + description: "Show usage of by HEAD builds." switch :debug conflicts "--devel", "--HEAD" end diff --git a/Library/Homebrew/dev-cmd/audit.rb b/Library/Homebrew/dev-cmd/audit.rb index ad1fa76630..f6d99f555a 100644 --- a/Library/Homebrew/dev-cmd/audit.rb +++ b/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." diff --git a/Library/Homebrew/dev-cmd/prof.rb b/Library/Homebrew/dev-cmd/prof.rb index e84cd11aec..4666fa0d06 100644 --- a/Library/Homebrew/dev-cmd/prof.rb +++ b/Library/Homebrew/dev-cmd/prof.rb @@ -10,7 +10,7 @@ module Homebrew usage_banner <<~EOS `prof` - 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 diff --git a/Library/Homebrew/dev-cmd/ruby.rb b/Library/Homebrew/dev-cmd/ruby.rb index 3289500f7f..83d97cd313 100644 --- a/Library/Homebrew/dev-cmd/ruby.rb +++ b/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. - `brew ruby -e "puts :gcc.f.deps"` or `brew ruby script.rb` + Run a Ruby instance with Homebrew's libraries loaded, e.g. + `brew ruby -e "puts :gcc.f.deps"` or `brew ruby script.rb`. EOS switch "-e", description: "Execute the provided string argument as a script." diff --git a/Library/Homebrew/diagnostic.rb b/Library/Homebrew/diagnostic.rb index c713faf749..3698972ebe 100644 --- a/Library/Homebrew/diagnostic.rb +++ b/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