From a3e0647797eb78b6214c4ab7c0f018ae1f1e1015 Mon Sep 17 00:00:00 2001 From: EricFromCanada Date: Tue, 6 Aug 2019 13:23:19 -0400 Subject: [PATCH] manpages: whitespace fixes --- Library/Homebrew/cmd/--env.rb | 6 ++-- Library/Homebrew/cmd/cleanup.rb | 1 - Library/Homebrew/cmd/desc.rb | 18 +++++------ Library/Homebrew/cmd/diy.rb | 8 ++--- Library/Homebrew/cmd/fetch.rb | 2 +- Library/Homebrew/cmd/info.rb | 8 ++--- Library/Homebrew/cmd/install.rb | 34 ++++++++++----------- Library/Homebrew/cmd/outdated.rb | 8 ++--- Library/Homebrew/cmd/reinstall.rb | 3 +- Library/Homebrew/cmd/sh.rb | 4 +-- Library/Homebrew/cmd/tap-info.rb | 8 ++--- Library/Homebrew/cmd/unpack.rb | 4 +-- Library/Homebrew/cmd/upgrade.rb | 3 +- Library/Homebrew/dev-cmd/bump-formula-pr.rb | 1 - Library/Homebrew/dev-cmd/bump-revision.rb | 7 ++--- Library/Homebrew/dev-cmd/extract.rb | 5 ++- Library/Homebrew/manpages/brew.1.md.erb | 10 ++++-- 17 files changed, 66 insertions(+), 64 deletions(-) diff --git a/Library/Homebrew/cmd/--env.rb b/Library/Homebrew/cmd/--env.rb index c47f748ed3..399a2da0e4 100644 --- a/Library/Homebrew/cmd/--env.rb +++ b/Library/Homebrew/cmd/--env.rb @@ -18,9 +18,9 @@ module Homebrew If the command's output is sent through a pipe and no shell is specified, the list is formatted for export to `bash`(1) unless `--plain` is passed. EOS - flag "--shell=", - description: "Generate a list of environment variables for the specified shell, " \ - "or `--shell=auto` to detect the current shell." + flag "--shell=", + description: "Generate a list of environment variables for the specified shell, " \ + "or `--shell=auto` to detect the current shell." switch "--plain", description: "Plain output even when piped." end diff --git a/Library/Homebrew/cmd/cleanup.rb b/Library/Homebrew/cmd/cleanup.rb index bb83b9a61d..afead9e23f 100644 --- a/Library/Homebrew/cmd/cleanup.rb +++ b/Library/Homebrew/cmd/cleanup.rb @@ -15,7 +15,6 @@ module Homebrew and remove old versions of installed formulae. If arguments are specified, only do this for the specified formulae and casks. EOS - flag "--prune=", description: "Remove all cache files older than specified ." switch "-n", "--dry-run", diff --git a/Library/Homebrew/cmd/desc.rb b/Library/Homebrew/cmd/desc.rb index 8797309cba..03952a2352 100644 --- a/Library/Homebrew/cmd/desc.rb +++ b/Library/Homebrew/cmd/desc.rb @@ -19,15 +19,15 @@ module Homebrew Formula descriptions are cached; the cache is created on the first search, making that search slower than subsequent ones. EOS - flag "-s", "--search=", - description: "Search both name and description for provided . If is flanked by "\ - "slashes, it is interpreted as a regular expression." - flag "-n", "--name=", - description: "Search just the names for provided . If is flanked by slashes, it is "\ - "interpreted as a regular expression." - flag "-d", "--description=", - description: "Search just the descriptions for provided . If is flanked by slashes, "\ - "it is interpreted as a regular expression." + flag "-s", "--search=", + description: "Search both name and description for provided . If is flanked by "\ + "slashes, it is interpreted as a regular expression." + flag "-n", "--name=", + description: "Search just the names for provided . If is flanked by slashes, it is "\ + "interpreted as a regular expression." + flag "-d", "--description=", + description: "Search just the descriptions for provided . If is flanked by slashes, "\ + "it is interpreted as a regular expression." switch :verbose conflicts "--search=", "--name=", "--description=" end diff --git a/Library/Homebrew/cmd/diy.rb b/Library/Homebrew/cmd/diy.rb index c50633bd8a..ec8dc9c6ac 100644 --- a/Library/Homebrew/cmd/diy.rb +++ b/Library/Homebrew/cmd/diy.rb @@ -15,10 +15,10 @@ module Homebrew Using the output from this command, you can install your own software into the Cellar and then link it into Homebrew's prefix with `brew link`. EOS - flag "--name=", - description: "Explicitly set the provided of the package being installed." - flag "--version=", - description: "Explicitly set the provided of the package being installed." + flag "--name=", + description: "Explicitly set the provided of the package being installed." + flag "--version=", + description: "Explicitly set the provided of the package being installed." switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/fetch.rb b/Library/Homebrew/cmd/fetch.rb index 307a459f7d..b1fa2462df 100644 --- a/Library/Homebrew/cmd/fetch.rb +++ b/Library/Homebrew/cmd/fetch.rb @@ -26,7 +26,7 @@ module Homebrew description: "Remove a previously cached version and re-fetch." switch "--retry", description: "Retry if a download fails or re-download if the checksum of a previously cached "\ - "version no longer matches." + "version no longer matches." switch "--deps", description: "Download dependencies for any listed ." switch "-s", "--build-from-source", diff --git a/Library/Homebrew/cmd/info.rb b/Library/Homebrew/cmd/info.rb index b27b5c4fdd..811e73d20d 100644 --- a/Library/Homebrew/cmd/info.rb +++ b/Library/Homebrew/cmd/info.rb @@ -37,10 +37,10 @@ module Homebrew switch "--github", description: "Open a browser to the GitHub source page for . "\ "To view formula history locally: `brew log -p` " - flag "--json", - description: "Print a JSON representation of . Currently the default and only accepted "\ - "value for is `v1`. See the docs for examples of using the JSON "\ - "output: " + flag "--json", + description: "Print a JSON representation of . Currently the default and only accepted "\ + "value for is `v1`. See the docs for examples of using the JSON "\ + "output: " switch "--installed", depends_on: "--json", description: "Print JSON of formulae that are currently installed." diff --git a/Library/Homebrew/cmd/install.rb b/Library/Homebrew/cmd/install.rb index 85ba7e00d1..3480c1a540 100644 --- a/Library/Homebrew/cmd/install.rb +++ b/Library/Homebrew/cmd/install.rb @@ -23,16 +23,16 @@ module Homebrew is usually the name of the formula to install, but it can be specified in several different ways. - Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the installed formulae or, every 30 days, for all formulae. + Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the + installed formulae or, every 30 days, for all formulae. EOS - switch :debug, description: "If brewing fails, open an interactive debugging session with access to IRB "\ "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 "\ - "standard build environment." + 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 "\ + "standard build environment." switch "--ignore-dependencies", description: "An unsupported Homebrew development flag to skip installing any dependencies of "\ "any kind. If the dependencies are not already present, the formula will have issues. "\ @@ -41,13 +41,13 @@ module Homebrew switch "--only-dependencies", description: "Install the dependencies with specified options but do not install the "\ "specified formula." - flag "--cc=", - description: "Attempt to compile using provided . should be the "\ - "name of the compiler's executable, for instance `gcc-7` for GCC 7. "\ - "In order to use LLVM's clang, use `llvm_clang`. To specify the "\ - "Apple-provided clang, use `clang`. This parameter will only accept "\ - "compilers that are provided by Homebrew or bundled with macOS. "\ - "Please do not file issues if you encounter errors while using this flag." + flag "--cc=", + description: "Attempt to compile using provided . should be the "\ + "name of the compiler's executable, for instance `gcc-7` for GCC 7. "\ + "In order to use LLVM's clang, use `llvm_clang`. To specify the "\ + "Apple-provided clang, use `clang`. This parameter will only accept "\ + "compilers that are provided by Homebrew or bundled with macOS. "\ + "Please do not file issues if you encounter errors while using this flag." switch "-s", "--build-from-source", description: "Compile the specified from source even if a bottle is provided. "\ "Dependencies will still be installed from bottles if they are available." @@ -68,10 +68,10 @@ module Homebrew description: "Don't delete the temporary files created during installation." switch "--build-bottle", description: "Prepare the formula for eventual bottling during installation." - flag "--bottle-arch=", - depends_on: "--build-bottle", - description: "Optimise bottles for the given architecture rather than the oldest "\ - "architecture supported by the version of macOS the bottles are built on." + flag "--bottle-arch=", + depends_on: "--build-bottle", + description: "Optimise bottles for the given architecture rather than the oldest "\ + "architecture supported by the version of macOS the bottles are built on." switch :force, description: "Install without checking for previously installed keg-only or "\ "non-migrated versions." diff --git a/Library/Homebrew/cmd/outdated.rb b/Library/Homebrew/cmd/outdated.rb index 4354d47f76..c65e50aaa7 100644 --- a/Library/Homebrew/cmd/outdated.rb +++ b/Library/Homebrew/cmd/outdated.rb @@ -21,10 +21,10 @@ module Homebrew description: "List only the names of outdated brews (takes precedence over `--verbose`)." switch :verbose, description: "Display detailed version information." - flag "--json", - description: "Print output in JSON format. Currently the default and only accepted "\ - "value for is `v1`. See the docs for examples of using the JSON "\ - "output: " + flag "--json", + description: "Print output in JSON format. Currently the default and only accepted "\ + "value for is `v1`. See the docs for examples of using the JSON "\ + "output: " switch "--fetch-HEAD", description: "Fetch the upstream repository to detect if the HEAD installation of the "\ "formula is outdated. Otherwise, the repository's HEAD will be checked for "\ diff --git a/Library/Homebrew/cmd/reinstall.rb b/Library/Homebrew/cmd/reinstall.rb index a34a0a4330..16557a90b2 100644 --- a/Library/Homebrew/cmd/reinstall.rb +++ b/Library/Homebrew/cmd/reinstall.rb @@ -17,7 +17,8 @@ module Homebrew Uninstall and then install (with existing and any appended install options). - Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the reinstalled formulae or, every 30 days, for all formulae. + Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the + reinstalled formulae or, every 30 days, for all formulae. EOS switch :debug, description: "If brewing fails, open an interactive debugging session with access to IRB "\ diff --git a/Library/Homebrew/cmd/sh.rb b/Library/Homebrew/cmd/sh.rb index 244f9ad4ea..b82fbf9123 100644 --- a/Library/Homebrew/cmd/sh.rb +++ b/Library/Homebrew/cmd/sh.rb @@ -18,8 +18,8 @@ module Homebrew in an Xcode-only configuration since it adds tools like `make` to your `PATH` which otherwise build systems would not find. EOS - flag "--env=", - description: "Use the standard `PATH` instead of superenv's, when is passed" + flag "--env=", + description: "Use the standard `PATH` instead of superenv's, when is passed" switch :verbose switch :debug end diff --git a/Library/Homebrew/cmd/tap-info.rb b/Library/Homebrew/cmd/tap-info.rb index 3db683dbb7..1d18da3138 100644 --- a/Library/Homebrew/cmd/tap-info.rb +++ b/Library/Homebrew/cmd/tap-info.rb @@ -15,10 +15,10 @@ module Homebrew EOS switch "--installed", description: "Display information on all installed taps." - flag "--json", - description: "Print a JSON representation of . Currently the default and only accepted "\ - "value for is `v1`. See the docs for examples of using the JSON "\ - "output: " + flag "--json", + description: "Print a JSON representation of . Currently the default and only accepted "\ + "value for is `v1`. See the docs for examples of using the JSON "\ + "output: " switch :debug end end diff --git a/Library/Homebrew/cmd/unpack.rb b/Library/Homebrew/cmd/unpack.rb index d4333c2c42..8b49a963bb 100644 --- a/Library/Homebrew/cmd/unpack.rb +++ b/Library/Homebrew/cmd/unpack.rb @@ -15,8 +15,8 @@ module Homebrew Unpack the source files for into subdirectories of the current working directory. EOS - flag "--destdir=", - description: "Create subdirectories in the directory named by instead." + flag "--destdir=", + description: "Create subdirectories in the directory named by instead." switch "--patch", description: "Patches for will be applied to the unpacked source." switch "-g", "--git", diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb index 75c6ac10ce..1a42aa3930 100644 --- a/Library/Homebrew/cmd/upgrade.rb +++ b/Library/Homebrew/cmd/upgrade.rb @@ -21,7 +21,8 @@ module Homebrew If are given, upgrade only the specified brews (unless they are pinned; see `pin`, `unpin`). - Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the upgraded formulae or, every 30 days, for all formulae. + Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the + upgraded formulae or, every 30 days, for all formulae. EOS switch :debug, description: "If brewing fails, open an interactive debugging session with access to IRB "\ diff --git a/Library/Homebrew/dev-cmd/bump-formula-pr.rb b/Library/Homebrew/dev-cmd/bump-formula-pr.rb index 2aa7baf389..ffd711eec4 100644 --- a/Library/Homebrew/dev-cmd/bump-formula-pr.rb +++ b/Library/Homebrew/dev-cmd/bump-formula-pr.rb @@ -58,7 +58,6 @@ module Homebrew flag "--revision=", required_for: "--tag=", description: "Specify the new git commit corresponding to a specified ." - switch :force switch :quiet switch :verbose diff --git a/Library/Homebrew/dev-cmd/bump-revision.rb b/Library/Homebrew/dev-cmd/bump-revision.rb index 4c2610a798..db06fad423 100644 --- a/Library/Homebrew/dev-cmd/bump-revision.rb +++ b/Library/Homebrew/dev-cmd/bump-revision.rb @@ -12,13 +12,12 @@ module Homebrew `bump-revision` [] [] Create a commit to increment the revision of the formula. If no revision is - present, "revision 1" will be added. + present, "revision 1" will be added. EOS switch "-n", "--dry-run", description: "Print what would be done rather than doing it." - flag "--message=", - description: "Append the provided to the default commit message." - + flag "--message=", + description: "Append the provided to the default commit message." switch :force switch :quiet switch :verbose diff --git a/Library/Homebrew/dev-cmd/extract.rb b/Library/Homebrew/dev-cmd/extract.rb index 34cddd092c..1f2c0cddee 100644 --- a/Library/Homebrew/dev-cmd/extract.rb +++ b/Library/Homebrew/dev-cmd/extract.rb @@ -86,9 +86,8 @@ module Homebrew installed yet, attempt to install/clone the tap before continuing. To extract a from a tap that is not homebrew/core use //. EOS - - flag "--version=", - description: "Extract the provided of instead of the most recent." + flag "--version=", + description: "Extract the provided of instead of the most recent." switch :force switch :debug end diff --git a/Library/Homebrew/manpages/brew.1.md.erb b/Library/Homebrew/manpages/brew.1.md.erb index b8f83babd2..927de8ad54 100644 --- a/Library/Homebrew/manpages/brew.1.md.erb +++ b/Library/Homebrew/manpages/brew.1.md.erb @@ -42,6 +42,7 @@ Uninstall . List all installed formulae. ### `search` (|`/``/`): + Perform a substring search of cask tokens and formula names for . If is surrounded with slashes, then it is interpreted as a regular expression. The search for is extended online to `homebrew/core` and `homebrew/cask`. @@ -63,7 +64,8 @@ If no search term is given, all locally available formulae are listed. ### `bundle` : -Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask and the Mac App Store. See `brew bundle --help`. +Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask and the Mac App Store. +See `brew bundle --help`. **Homebrew/homebrew-bundle**: @@ -75,7 +77,8 @@ Install macOS applications distributed as binaries. See brew-cask(1). ### `services` : -Manage background services with macOS' `launchctl`(1) daemon manager. See `brew services --help`. +Manage background services with macOS' `launchctl`(1) daemon manager. +See `brew services --help`. **Homebrew/homebrew-services**: @@ -116,7 +119,8 @@ Note that environment variables must have a value set to be detected. For exampl `export HOMEBREW_NO_INSECURE_REDIRECT`. * `HOMEBREW_ARCH`: - Linux only: If set, Homebrew will pass the set value to type name to the compiler's `-march` option instead of using the default (`-march=native`). + Linux only: If set, Homebrew will pass the set value to type name to the compiler's + `-march` option instead of using the default (`-march=native`). * `HOMEBREW_ARTIFACT_DOMAIN`: If set, instructs Homebrew to prefix all download URLs, including those for bottles,