From 6cb7a00f2d09c69702fae8ea58f08509ab50c325 Mon Sep 17 00:00:00 2001 From: Mike McQuaid Date: Wed, 30 Jan 2019 21:32:35 +0000 Subject: [PATCH] cmd: remove --help headers and tweak docs. --- Library/Homebrew/cmd/analytics.rb | 10 ---- Library/Homebrew/cmd/cat.rb | 3 -- Library/Homebrew/cmd/cleanup.rb | 17 +------ Library/Homebrew/cmd/command.rb | 3 -- Library/Homebrew/cmd/commands.rb | 6 --- Library/Homebrew/cmd/config.rb | 5 -- Library/Homebrew/cmd/deps.rb | 61 +---------------------- Library/Homebrew/cmd/desc.rb | 10 ---- Library/Homebrew/cmd/diy.rb | 10 ---- Library/Homebrew/cmd/doctor.rb | 15 ++---- Library/Homebrew/cmd/fetch.rb | 32 ++---------- Library/Homebrew/cmd/gist-logs.rb | 18 +------ Library/Homebrew/cmd/home.rb | 6 --- Library/Homebrew/cmd/info.rb | 40 +-------------- Library/Homebrew/cmd/install.rb | 75 +---------------------------- Library/Homebrew/cmd/leaves.rb | 3 -- Library/Homebrew/cmd/link.rb | 16 +----- Library/Homebrew/cmd/list.rb | 26 ++-------- Library/Homebrew/cmd/migrate.rb | 13 ++--- Library/Homebrew/cmd/missing.rb | 13 +---- Library/Homebrew/cmd/options.rb | 14 +----- Library/Homebrew/cmd/outdated.rb | 21 +------- Library/Homebrew/cmd/pin.rb | 10 ++-- Library/Homebrew/cmd/postinstall.rb | 3 -- Library/Homebrew/cmd/prune.rb | 4 +- Library/Homebrew/cmd/readall.rb | 15 +----- Library/Homebrew/cmd/reinstall.rb | 30 +----------- Library/Homebrew/cmd/search.rb | 21 +------- Library/Homebrew/cmd/sh.rb | 9 ---- Library/Homebrew/cmd/style.rb | 23 +-------- Library/Homebrew/cmd/switch.rb | 3 -- Library/Homebrew/cmd/tap-info.rb | 23 ++------- Library/Homebrew/cmd/tap-pin.rb | 6 +-- Library/Homebrew/cmd/tap-unpin.rb | 5 +- Library/Homebrew/cmd/tap.rb | 34 ------------- Library/Homebrew/cmd/uninstall.rb | 11 +---- Library/Homebrew/cmd/unlink.rb | 8 --- Library/Homebrew/cmd/unpack.rb | 19 ++------ Library/Homebrew/cmd/unpin.rb | 8 +-- Library/Homebrew/cmd/untap.rb | 3 -- Library/Homebrew/cmd/upgrade.rb | 43 +---------------- Library/Homebrew/cmd/uses.rb | 42 +++++----------- 42 files changed, 63 insertions(+), 674 deletions(-) diff --git a/Library/Homebrew/cmd/analytics.rb b/Library/Homebrew/cmd/analytics.rb index 9aeb179d0e..a6824e96cd 100644 --- a/Library/Homebrew/cmd/analytics.rb +++ b/Library/Homebrew/cmd/analytics.rb @@ -1,13 +1,3 @@ -#: * `analytics` [`state`]: -#: Display anonymous user behaviour analytics state. -#: Read more at . -#: -#: * `analytics` (`on`|`off`): -#: Turn on/off Homebrew's analytics. -#: -#: * `analytics` `regenerate-uuid`: -#: Regenerate UUID used in Homebrew's analytics. - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/cat.rb b/Library/Homebrew/cmd/cat.rb index 5cf7077cc9..b7cfb1af96 100644 --- a/Library/Homebrew/cmd/cat.rb +++ b/Library/Homebrew/cmd/cat.rb @@ -1,6 +1,3 @@ -#: * `cat` : -#: Display the source to . - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/cleanup.rb b/Library/Homebrew/cmd/cleanup.rb index 751eef4fea..5a6f957928 100644 --- a/Library/Homebrew/cmd/cleanup.rb +++ b/Library/Homebrew/cmd/cleanup.rb @@ -1,17 +1,3 @@ -#: * `cleanup` [`--prune=`] [`--dry-run`] [`-s`] [|]: -#: Remove stale lock files and outdated downloads for formulae and casks, -#: and remove old versions of installed formulae. If arguments are specified, -#: only do this for the specified formulae and casks. -#: -#: If `--prune=` is specified, remove all cache files older than . -#: -#: If `--dry-run` or `-n` is passed, show what would be removed, but do not -#: actually remove anything. -#: -#: If `-s` is passed, scrub the cache, including downloads for even the latest -#: versions. Note downloads for any installed formula or cask will still not -#: be deleted. If you want to delete those too: `rm -rf "$(brew --cache)"` - require "cleanup" require "cli_parser" @@ -21,8 +7,7 @@ module Homebrew def cleanup_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `cleanup` [] [|] - + `cleanup` [] [|] Remove stale lock files and outdated downloads for formulae and casks, and remove old versions of installed formulae. If arguments are specified, diff --git a/Library/Homebrew/cmd/command.rb b/Library/Homebrew/cmd/command.rb index 9d468ee582..08d5b51c80 100644 --- a/Library/Homebrew/cmd/command.rb +++ b/Library/Homebrew/cmd/command.rb @@ -1,6 +1,3 @@ -#: * `command` : -#: Display the path to the file which is used when invoking `brew` . - require "commands" require "cli_parser" diff --git a/Library/Homebrew/cmd/commands.rb b/Library/Homebrew/cmd/commands.rb index adb29038a1..66b4466331 100644 --- a/Library/Homebrew/cmd/commands.rb +++ b/Library/Homebrew/cmd/commands.rb @@ -1,9 +1,3 @@ -#: * `commands` [`--quiet` [`--include-aliases`]]: -#: Show a list of built-in and external commands. -#: -#: If `--quiet` is passed, list only the names of commands without the header. -#: With `--include-aliases`, the aliases of internal commands will be included. - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/config.rb b/Library/Homebrew/cmd/config.rb index 44b6ec6198..492a6d47a8 100644 --- a/Library/Homebrew/cmd/config.rb +++ b/Library/Homebrew/cmd/config.rb @@ -1,8 +1,3 @@ -#: * `config`: -#: Show Homebrew and system configuration useful for debugging. If you file -#: a bug report, you will likely be asked for this information if you do not -#: provide it. - require "system_config" require "cli_parser" diff --git a/Library/Homebrew/cmd/deps.rb b/Library/Homebrew/cmd/deps.rb index e4d661659d..239e300d47 100644 --- a/Library/Homebrew/cmd/deps.rb +++ b/Library/Homebrew/cmd/deps.rb @@ -1,60 +1,3 @@ -#: * `deps` [`--1`] [`-n`] [`--union`] [`--full-name`] [`--installed`] [`--include-build`] [`--include-optional`] [`--skip-recommended`] [`--include-requirements`] : -#: Show dependencies for . When given multiple formula arguments, -#: show the intersection of dependencies for every formula. -#: -#: If `--1` is passed, only show dependencies one level down, instead of -#: recursing. -#: -#: If `-n` is passed, show dependencies in topological order. -#: -#: If `--union` is passed, show the union of dependencies for , -#: instead of the intersection. -#: -#: If `--full-name` is passed, list dependencies by their full name. -#: -#: If `--installed` is passed, only list those dependencies that are -#: currently installed. -#: -#: By default, `deps` shows required and recommended dependencies for -#: . To include the `:build` type dependencies, pass `--include-build`. -#: Similarly, pass `--include-optional` to include `:optional` dependencies or -#: `--include-test` to include (non-recursive) `:test` dependencies. -#: To skip `:recommended` type dependencies, pass `--skip-recommended`. -#: To include requirements in addition to dependencies, pass `--include-requirements`. -#: -#: * `deps` `--tree` [`--1`] [] [`--annotate`] (|`--installed`): -#: Show dependencies as a tree. When given multiple formula arguments, output -#: individual trees for every formula. -#: -#: If `--1` is passed, only one level of children is displayed. -#: -#: If `--installed` is passed, output a tree for every installed formula. -#: -#: The placeholder is any combination of options `--include-build`, -#: `--include-optional`, `--include-test`, `--skip-recommended`, and -#: `--include-requirements` as documented above. -#: -#: If `--annotate` is passed, the build, optional, and recommended dependencies -#: are marked as such in the output. -#: -#: * `deps` [] (`--installed`|`--all`): -#: Show dependencies for installed or all available formulae. Every line of -#: output starts with the formula name, followed by a colon and all direct -#: dependencies of that formula. -#: -#: The placeholder is any combination of options `--include-build`, -#: `--include-optional`, `--include-test`, and `--skip-recommended` as -#: documented above. -#: -#: Additional options specific to may be appended to the command, -#: and can be listed with `brew options` . - -# The undocumented `--for-each` option will switch into the mode used by `deps --all`, -# but only list dependencies for specified formula, one specified formula per line. -# This is used for debugging the `--installed`/`--all` display mode. - -# encoding: UTF-8 - require "formula" require "ostruct" require "cli_parser" @@ -81,11 +24,11 @@ module Homebrew switch "--installed", description: "Only list those dependencies that are currently installed." switch "--all", - description: "List all the dependencies for all available formuale." + description: "List all the dependencies for all available formulae." switch "--include-build", description: "Show `:build` type dependencies for ." switch "--include-optional", - description: "Show `:optional` dependecies for ." + description: "Show `:optional` dependencies for ." switch "--include-test", description: "Show `:test` dependencies for (non-recursive)." switch "--skip-recommended", diff --git a/Library/Homebrew/cmd/desc.rb b/Library/Homebrew/cmd/desc.rb index 5e9c972272..32538e0b47 100644 --- a/Library/Homebrew/cmd/desc.rb +++ b/Library/Homebrew/cmd/desc.rb @@ -1,13 +1,3 @@ -#: * `desc` : -#: Display 's name and one-line description. -#: -#: * `desc` [`--search`|`--name`|`--description`] (|`/``/`): -#: Search both name and description (`--search` or `-s`), just the names -#: (`--name` or `-n`), or just the descriptions (`--description` or `-d`) for -#: . If is flanked by slashes, it is interpreted as a regular -#: expression. Formula descriptions are cached; the cache is created on the -#: first search, making that search slower than subsequent ones. - require "descriptions" require "search" require "description_cache_store" diff --git a/Library/Homebrew/cmd/diy.rb b/Library/Homebrew/cmd/diy.rb index f0c2f75f76..5b8c21f284 100644 --- a/Library/Homebrew/cmd/diy.rb +++ b/Library/Homebrew/cmd/diy.rb @@ -1,13 +1,3 @@ -#: * `diy` [`--name=`] [`--version=`]: -#: Automatically determine the installation prefix for non-Homebrew software. -#: -#: 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`. -#: -#: The options `--name=` and `--version=` each take an argument -#: and allow you to explicitly set the name and version of the package you are -#: installing. - require "formula" require "cli_parser" diff --git a/Library/Homebrew/cmd/doctor.rb b/Library/Homebrew/cmd/doctor.rb index eeb7a1918f..4b18a3c7b1 100644 --- a/Library/Homebrew/cmd/doctor.rb +++ b/Library/Homebrew/cmd/doctor.rb @@ -1,14 +1,3 @@ -#: * `doctor`: -#: Check your system for potential problems. Doctor exits with a non-zero status -#: if any potential problems are found. Please note that these warnings are just -#: used to help the Homebrew maintainers with debugging if you file an issue. If -#: everything you use Homebrew for is working fine: please don't worry or file -#: an issue; just ignore this. - -# Undocumented options: -# `-D` activates debugging and profiling of the audit methods (not the same as `--debug`) -# `--list-checks` lists all audit methods - require "diagnostic" require "cli_parser" @@ -32,6 +21,10 @@ module Homebrew description: "Enable debugging and profiling of audit methods." switch :verbose switch :debug + + # Undocumented options: + # `-D` activates debugging and profiling of the doctor methods (not the same as `--debug`) + # `--list-checks` lists all doctor methods end end diff --git a/Library/Homebrew/cmd/fetch.rb b/Library/Homebrew/cmd/fetch.rb index 84a8e2bc24..07dc67e576 100644 --- a/Library/Homebrew/cmd/fetch.rb +++ b/Library/Homebrew/cmd/fetch.rb @@ -1,27 +1,3 @@ -#: * `fetch` [`--force`] [`--retry`] [`-v`] [`--devel`|`--HEAD`] [`--deps`] [`--build-from-source`|`--force-bottle`] : -#: Download the source packages for the given . -#: For tarballs, also print SHA-256 checksums. -#: -#: If `--HEAD` or `--devel` is passed, fetch that version instead of the -#: stable version. -#: -#: If `-v` is passed, do a verbose VCS checkout, if the URL represents a VCS. -#: This is useful for seeing if an existing VCS cache has been updated. -#: -#: If `--force` (or `-f`) is passed, remove a previously cached version and re-fetch. -#: -#: If `--retry` is passed, retry if a download fails or re-download if the -#: checksum of a previously cached version no longer matches. -#: -#: If `--deps` is passed, also download dependencies for any listed . -#: -#: If `--build-from-source` (or `-s`) or `--build-bottle` is passed, download the -#: source rather than a bottle. -#: -#: If `--force-bottle` is passed, download a bottle if it exists for the -#: current or newest version of macOS, even if it would not be used during -#: installation. - require "formula" require "fetch" require "cli_parser" @@ -32,15 +8,15 @@ module Homebrew def fetch_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `fetch` [] + `fetch` [] - Download the source packages for the given . + Download the source packages for the given . For tarballs, also print SHA-256 checksums. EOS switch "--HEAD", description: "Fetch HEAD version instead of stable version." switch "--devel", - description: "Fetch devel version instead of stable version." + description: "Fetch development version instead of stable version." switch :verbose, description: "Do a verbose VCS checkout, if the URL represents a VCS. This is useful for "\ "seeing if an existing VCS cache has been updated." @@ -50,7 +26,7 @@ module Homebrew description: "Retry if a download fails or re-download if the checksum of a previously cached "\ "version no longer matches." switch "--deps", - description: "Download dependencies for any listed ." + description: "Download dependencies for any listed ." switch "-s", "--build-from-source", description: "Download the source for rather than a bottle." switch "--build-bottle", diff --git a/Library/Homebrew/cmd/gist-logs.rb b/Library/Homebrew/cmd/gist-logs.rb index 28875abfca..66cb1dffe6 100644 --- a/Library/Homebrew/cmd/gist-logs.rb +++ b/Library/Homebrew/cmd/gist-logs.rb @@ -1,19 +1,3 @@ -#: * `gist-logs` [`--new-issue`|`-n`] [`--private`|`-p`] : -#: Upload logs for a failed build of to a new Gist. -#: -#: is usually the name of the formula to install, but it can be specified -#: in several different ways. -#: -#: If `--with-hostname` is passed, include the hostname in the Gist. -#: -#: If `--new-issue` is passed, automatically create a new issue in the appropriate -#: GitHub repository as well as creating the Gist. -#: -#: If `--private` is passed, the Gist will be marked private and will not -#: appear in listings but will be accessible with the link. -#: -#: If no logs are found, an error message is presented. - require "formula" require "install" require "system_config" @@ -27,7 +11,7 @@ module Homebrew def gist_logs_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `gist-logs` [] : + `gist-logs` [] Upload logs for a failed build of to a new Gist. diff --git a/Library/Homebrew/cmd/home.rb b/Library/Homebrew/cmd/home.rb index 145a23dda9..a9e1df4a86 100644 --- a/Library/Homebrew/cmd/home.rb +++ b/Library/Homebrew/cmd/home.rb @@ -1,9 +1,3 @@ -#: * `home`: -#: Open Homebrew's own homepage in a browser. -#: -#: * `home` : -#: Open 's homepage in a browser. - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/info.rb b/Library/Homebrew/cmd/info.rb index 3693a6cba9..c13b62f8db 100644 --- a/Library/Homebrew/cmd/info.rb +++ b/Library/Homebrew/cmd/info.rb @@ -1,39 +1,3 @@ -#: * `info`: -#: Display brief statistics for your Homebrew installation. -#: -#: * `info` `--analytics` [`--days=`] [`--category=`]: -#: Display Homebrew analytics data (provided neither `HOMEBREW_NO_ANALYTICS` -#: or `HOMEBREW_NO_GITHUB_API` are set) -#: -#: The value for `days` must be `30`, `90` or `365`. The default is `30`. -#: -#: The value for `category` must be `install`, `install-on-request`, -#: `build-error` or `os-version`. The default is `install`. -#: -#: * `info` [`--analytics`]: -#: Display information about and analytics data (provided neither -#: `HOMEBREW_NO_ANALYTICS` or `HOMEBREW_NO_GITHUB_API` are set) -#: -#: Pass `--verbose` to see more verbose analytics data. -#: -#: Pass `--analytics` to see only more verbose analytics data instead of -#: formula information. -#: -#: * `info` `--github` : -#: Open a browser to the GitHub History page for . -#: -#: To view formula history locally: `brew log -p` -#: -#: * `info` `--json[=`] (`--all`|`--installed`|): -#: Print a JSON representation of . Currently the default and -#: only accepted value for is `v1`. -#: -#: Pass `--all` to get information on all formulae, or `--installed` to get -#: information on all installed formulae. -#: -#: See the docs for examples of using the JSON output: -#: - require "missing_formula" require "caveats" require "cli_parser" @@ -49,7 +13,7 @@ module Homebrew def info_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `info []` + `info` [] Display brief statistics for your Homebrew installation. EOS @@ -67,7 +31,7 @@ module Homebrew description: "Open a browser to the GitHub History page for provided . "\ "To view formula history locally: `brew log -p` " flag "--json", - description: "Print a JSON representation of . Currently the default and only accepted "\ + 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 "--all", diff --git a/Library/Homebrew/cmd/install.rb b/Library/Homebrew/cmd/install.rb index 46a4bef490..a04140527e 100644 --- a/Library/Homebrew/cmd/install.rb +++ b/Library/Homebrew/cmd/install.rb @@ -1,74 +1,3 @@ -#: * `install` [`--debug`] [`--env=`(`std`|`super`)] [`--ignore-dependencies`|`--only-dependencies`] [`--cc=`] [`--build-from-source`|`--force-bottle`] [`--include-test`] [`--devel`|`--HEAD`] [`--keep-tmp`] [`--build-bottle`] [`--force`] [`--verbose`] [`--display-times`] [ ...]: -#: Install . -#: -#: is usually the name of the formula to install, but it can be specified -#: in several different ways. -#: -#: If `--debug` (or `-d`) is passed and brewing fails, open an interactive debugging -#: session with access to IRB or a shell inside the temporary build directory. -#: -#: If `--env=std` is passed, use the standard build environment instead of superenv. -#: -#: If `--env=super` is passed, use superenv even if the formula specifies the -#: standard build environment. -#: -#: If `--ignore-dependencies` is passed, skip installing any dependencies of -#: any kind. If they are not already present, the formula will probably fail -#: to install. -#: -#: If `--only-dependencies` is passed, install the dependencies with specified -#: options but do not install the specified formula. -#: -#: If `--cc=` is passed, attempt to compile using . -#: 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. -#: -#: If `--build-from-source` (or `-s`) is passed, compile the specified from -#: source even if a bottle is provided. Dependencies will still be installed -#: from bottles if they are available. -#: -#: If `--force-bottle` is passed, install from a bottle if it exists for the -#: current or newest version of macOS, even if it would not normally be used -#: for installation. -#: -#: If `--include-test` is passed, install testing dependencies. These are only -#: needed by formulae maintainers to run `brew test`. -#: -#: If `--devel` is passed, and defines it, install the development version. -#: -#: If `--HEAD` is passed, and defines it, install the HEAD version, -#: aka. master, trunk, unstable. -#: -#: If `--keep-tmp` is passed, the temporary files created during installation -#: are not deleted. -#: -#: If `--build-bottle` is passed, prepare the formula for eventual bottling -#: during installation. -#: -#: If `--force` (or `-f`) is passed, install without checking for previously -#: installed keg-only or non-migrated versions -#: -#: If `--verbose` (or `-v`) is passed, print the verification and postinstall steps. -#: -#: If `--display-times` is passed, install times for each formula are printed -#: at the end of the run. -#: -#: Installation options specific to may be appended to the command, -#: and can be listed with `brew options` . -#: -#: * `install` `--interactive` [`--git`] : -#: If `--interactive` (or `-i`) is passed, download and patch , then -#: open a shell. This allows the user to run `./configure --help` and -#: otherwise determine how to turn the software package into a Homebrew -#: formula. -#: -#: If `--git` (or `-g`) is passed, Homebrew will create a Git repository, useful for -#: creating patches to the software. - require "missing_formula" require "formula_installer" require "development_tools" @@ -128,9 +57,9 @@ module Homebrew 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 "\ - "updates when a new stable or devel version has been released." + "updates when a new stable or development version has been released." switch "--keep-tmp", - description: "Dont delete the temporary files created during installation." + description: "Don't delete the temporary files created during installation." switch "--build-bottle", description: "Prepare the formula for eventual bottling during installation." switch :force, diff --git a/Library/Homebrew/cmd/leaves.rb b/Library/Homebrew/cmd/leaves.rb index 2f4d1fb0ad..1971ff5da9 100644 --- a/Library/Homebrew/cmd/leaves.rb +++ b/Library/Homebrew/cmd/leaves.rb @@ -1,6 +1,3 @@ -#: * `leaves`: -#: Show installed formulae that are not dependencies of another installed formula. - require "formula" require "tab" require "cli_parser" diff --git a/Library/Homebrew/cmd/link.rb b/Library/Homebrew/cmd/link.rb index 7560263b19..4f2cd4371e 100644 --- a/Library/Homebrew/cmd/link.rb +++ b/Library/Homebrew/cmd/link.rb @@ -1,17 +1,3 @@ -#: * `ln`, `link` [`--overwrite`] [`--dry-run`] [`--force`] : -#: Symlink all of 's installed files into the Homebrew prefix. This -#: is done automatically when you install formulae but can be useful for DIY -#: installations. -#: -#: If `--overwrite` is passed, Homebrew will delete files which already exist in -#: the prefix while linking. -#: -#: If `--dry-run` or `-n` is passed, Homebrew will list all files which would -#: be linked or which would be deleted by `brew link --overwrite`, but will not -#: actually link or delete any files. -#: -#: If `--force` (or `-f`) is passed, Homebrew will allow keg-only formulae to be linked. - require "ostruct" require "caveats" require "cli_parser" @@ -22,7 +8,7 @@ module Homebrew def link_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `ln`, `link` + `ln`, `link` [] Symlink all of 's installed files into the Homebrew prefix. This is done automatically when you install formulae but can be useful for DIY diff --git a/Library/Homebrew/cmd/list.rb b/Library/Homebrew/cmd/list.rb index 74a3d1c1ca..15ceae6a86 100644 --- a/Library/Homebrew/cmd/list.rb +++ b/Library/Homebrew/cmd/list.rb @@ -1,23 +1,3 @@ -#: * `list`, `ls` [`--full-name`] [`-1`] [`-l`] [`-t`] [`-r`]: -#: List all installed formulae. If `--full-name` is passed, 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` which produces the actual output. -#: -#: * `list`, `ls` `--unbrewed`: -#: List all files in the Homebrew prefix not installed by Homebrew. -#: -#: * `list`, `ls` [`--verbose`] [`--versions` [`--multiple`]] [`--pinned`] []: -#: List the installed files for . Combined with `--verbose`, recursively -#: list the contents of all subdirectories in each 's keg. -#: -#: If `--versions` is passed, show the version number for installed formulae, -#: or only the specified formulae if are given. With `--multiple`, -#: only show formulae with multiple versions installed. -#: -#: If `--pinned` is passed, show the versions of pinned formulae, or only the -#: specified (pinned) formulae if are given. -#: See also `pin`, `unpin`. - require "metafiles" require "formula" require "cli_parser" @@ -28,7 +8,7 @@ module Homebrew def list_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `list`, `ls` [] [`-1`] [`-l`] [`-t`] [`-r`] + `list`, `ls` [] List all installed formulae. EOS @@ -40,13 +20,13 @@ module Homebrew description: "List all files in the Homebrew prefix not installed by Homebrew." switch "--versions", description: "Show the version number for installed formulae, or only the specified "\ - "formulae if are given." + "formulae if are given." switch "--multiple", depends_on: "--versions", description: "Only show formulae with multiple versions installed." switch "--pinned", description: "Show the versions of pinned formulae, or only the specified (pinned) "\ - "formulae if are given. See also `pin`, `unpin`." + "formulae if are given. See also `pin`, `unpin`." # passed through to ls switch "-1", description: "Force output to be one entry per line. " \ diff --git a/Library/Homebrew/cmd/migrate.rb b/Library/Homebrew/cmd/migrate.rb index f32e34f87b..eede2c97f4 100644 --- a/Library/Homebrew/cmd/migrate.rb +++ b/Library/Homebrew/cmd/migrate.rb @@ -1,10 +1,3 @@ -#: * `migrate` [`--force`] : -#: Migrate renamed packages to new name, where are old names of -#: packages. -#: -#: If `--force` (or `-f`) is passed, then treat installed and passed -#: like if they are from same taps and migrate them anyway. - require "migrator" require "cli_parser" @@ -14,13 +7,13 @@ module Homebrew def migrate_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `migrate` [] + `migrate` [] - Migrate renamed packages to new name, where are old names of + Migrate renamed packages to new name, where are old names of packages. EOS switch :force, - description: "Treat installed and passed like if they are from "\ + description: "Treat installed and passed like if they are from "\ "same taps and migrate them anyway." switch :verbose switch :debug diff --git a/Library/Homebrew/cmd/missing.rb b/Library/Homebrew/cmd/missing.rb index 224c525bcc..d0229470ec 100644 --- a/Library/Homebrew/cmd/missing.rb +++ b/Library/Homebrew/cmd/missing.rb @@ -1,12 +1,3 @@ -#: * `missing` [`--hide=`] []: -#: Check the given for missing dependencies. If no are -#: given, check all installed brews. -#: -#: If `--hide=` is passed, act as if none of are installed. -#: should be a comma-separated list of formulae. -#: -#: `missing` exits with a non-zero status if any formulae are missing dependencies. - require "formula" require "tab" require "diagnostic" @@ -18,9 +9,9 @@ module Homebrew def missing_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `missing` [] [] + `missing` [] [] - Check the given for missing dependencies. If no are + Check the given for missing dependencies. If no are given, check all installed brews. `missing` exits with a non-zero status if any formulae are missing dependencies. diff --git a/Library/Homebrew/cmd/options.rb b/Library/Homebrew/cmd/options.rb index 8fa65c3a1a..e17f303ca6 100644 --- a/Library/Homebrew/cmd/options.rb +++ b/Library/Homebrew/cmd/options.rb @@ -1,13 +1,3 @@ -#: * `options` [`--compact`] (`--all`|`--installed`|): -#: Display install options specific to . -#: -#: If `--compact` is passed, show all options on a single line separated by -#: spaces. -#: -#: If `--all` is passed, show options for all formulae. -#: -#: If `--installed` is passed, show options for all installed formulae. - require "formula" require "options" require "cli_parser" @@ -18,9 +8,9 @@ module Homebrew def options_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `options` [] + `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/outdated.rb b/Library/Homebrew/cmd/outdated.rb index 6477dc2b8d..0858eec572 100644 --- a/Library/Homebrew/cmd/outdated.rb +++ b/Library/Homebrew/cmd/outdated.rb @@ -1,22 +1,3 @@ -#: * `outdated` [`--quiet`|`--verbose`|`--json=`] [`--fetch-HEAD`]: -#: Show formulae that have an updated version available. -#: -#: By default, version information is displayed in interactive shells, and -#: suppressed otherwise. -#: -#: If `--quiet` is passed, list only the names of outdated brews (takes -#: precedence over `--verbose`). -#: -#: If `--verbose` (or `-v`) is passed, display detailed version information. -#: -#: If `--json=` is passed, the output will be in JSON format. -#: Currently the only accepted value for is `v1`. -#: -#: If `--fetch-HEAD` is passed, fetch the upstream repository to detect if -#: the HEAD installation of the formula is outdated. Otherwise, the -#: repository's HEAD will be checked for updates when a new stable or devel -#: version has been released. - require "formula" require "keg" require "cli_parser" @@ -44,7 +25,7 @@ module Homebrew 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 "\ - "updates when a new stable or devel version has been released." + "updates when a new stable or development version has been released." switch :debug conflicts "--quiet", "--verbose", "--json=" end diff --git a/Library/Homebrew/cmd/pin.rb b/Library/Homebrew/cmd/pin.rb index e93ce5938b..e28812b2ee 100644 --- a/Library/Homebrew/cmd/pin.rb +++ b/Library/Homebrew/cmd/pin.rb @@ -1,7 +1,3 @@ -#: * `pin` : -#: Pin the specified , preventing them from being upgraded when -#: issuing the `brew upgrade` command. See also `unpin`. - require "formula" require "cli_parser" @@ -11,10 +7,10 @@ module Homebrew def pin_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `pin` + `pin` - Pin the specified , preventing them from being upgraded when - issuing the `brew upgrade` command. See also `unpin`. + Pin the specified , preventing them from being upgraded when + issuing the `brew upgrade` command. See also `unpin`. EOS switch :debug end diff --git a/Library/Homebrew/cmd/postinstall.rb b/Library/Homebrew/cmd/postinstall.rb index 7db46b56e1..315b751428 100644 --- a/Library/Homebrew/cmd/postinstall.rb +++ b/Library/Homebrew/cmd/postinstall.rb @@ -1,6 +1,3 @@ -#: * `postinstall` : -#: Rerun the post-install steps for . - require "sandbox" require "formula_installer" require "cli_parser" diff --git a/Library/Homebrew/cmd/prune.rb b/Library/Homebrew/cmd/prune.rb index 387af49764..89500eb633 100644 --- a/Library/Homebrew/cmd/prune.rb +++ b/Library/Homebrew/cmd/prune.rb @@ -1,6 +1,3 @@ -#: * `prune` [`--dry-run`]: -#: Deprecated. Use `brew cleanup` instead. - require "keg" require "cli_parser" require "cleanup" @@ -19,6 +16,7 @@ module Homebrew description: "Show what would be removed, but do not actually remove anything." switch :verbose switch :debug + hide_from_man_page! end end diff --git a/Library/Homebrew/cmd/readall.rb b/Library/Homebrew/cmd/readall.rb index 3d51c83733..124da2e18d 100644 --- a/Library/Homebrew/cmd/readall.rb +++ b/Library/Homebrew/cmd/readall.rb @@ -1,14 +1,3 @@ -#: * `readall` [`--aliases`] [`--syntax`] []: -#: Import all formulae from specified (defaults to all installed taps). -#: -#: This can be useful for debugging issues across all formulae when making -#: significant changes to `formula.rb`, testing the performance of loading -#: all formulae or to determine if any current formulae have Ruby issues. -#: -#: If `--aliases` is passed, also verify any alias symlinks in each tap. -#: -#: If `--syntax` is passed, also syntax-check all of Homebrew's Ruby files. - require "readall" require "cli_parser" @@ -18,9 +7,9 @@ module Homebrew def readall_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `readall` [] [] + `readall` [] [] - Import all formulae from specified (defaults to all installed taps). + Import all formulae from specified (defaults to all installed taps). This can be useful for debugging issues across all formulae when making significant changes to `formula.rb`, testing the performance of loading all formulae or to determine if any current formulae have Ruby issues. diff --git a/Library/Homebrew/cmd/reinstall.rb b/Library/Homebrew/cmd/reinstall.rb index d1d7a0f05c..35fdecee02 100644 --- a/Library/Homebrew/cmd/reinstall.rb +++ b/Library/Homebrew/cmd/reinstall.rb @@ -1,31 +1,3 @@ -#: * `reinstall` [`--debug`] [`--build-from-source`|`--force-bottle`] [`--keep-tmp`] [`--force`] [`--verbose`] [`--display-times`] : -#: Uninstall and then install (with existing and any appended install options). -#: -#: If `--debug` (or `-d`) is passed and brewing fails, open an interactive debugging -#: session with access to IRB or a shell inside the temporary build directory. -#: -#: If `--build-from-source` (or `-s`) is passed, compile the specified from -#: source even if a bottle is provided. Dependencies will still be installed -#: from bottles if they are available. -#: -#: If `--force-bottle` is passed, install from a bottle if it exists for the -#: current or newest version of macOS, even if it would not normally be used -#: for installation. -#: -#: If `--keep-tmp` is passed, the temporary files created during installation -#: are not deleted. -#: -#: If `--force` (or `-f`) is passed, install without checking for previously -#: installed keg-only or non-migrated versions -#: -#: If `--verbose` (or `-v`) is passed, print the verification and postinstall steps. -#: -#: If `--display-times` is passed, install times for each formula are printed -#: at the end of the run. -#: -#: Installation options specific to may be appended to the command, -#: and can be listed with `brew options` . - require "formula_installer" require "development_tools" require "messages" @@ -52,7 +24,7 @@ module Homebrew description: "Install from a bottle if it exists for the current or newest version of "\ "macOS, even if it would not normally be used for installation." switch "--keep-tmp", - description: "Dont delete the temporary files created during installation." + description: "Don't delete the temporary files created during installation." switch :force, description: "Install without checking for previously installed keg-only or "\ "non-migrated versions." diff --git a/Library/Homebrew/cmd/search.rb b/Library/Homebrew/cmd/search.rb index aff503cb2d..11c065e6c1 100644 --- a/Library/Homebrew/cmd/search.rb +++ b/Library/Homebrew/cmd/search.rb @@ -1,22 +1,3 @@ -#: * `search`, `-S`: -#: Display all locally available formulae (including tapped ones). -#: No online search is performed. -#: -#: * `search` `--casks`: -#: Display all locally available casks (including tapped ones). -#: No online search is performed. -#: -#: * `search` [`--desc`] (|`/``/`): -#: 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`. -#: -#: If `--desc` is passed, search formulae with a description matching and -#: casks with a name matching . -#: -#: * `search` (`--debian`|`--fedora`|`--fink`|`--macports`|`--opensuse`|`--ubuntu`) : -#: Search for in the given package manager's list. - require "formula" require "missing_formula" require "descriptions" @@ -44,7 +25,7 @@ module Homebrew def search_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `search`, `-S` [] (|`/``/`) + `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. diff --git a/Library/Homebrew/cmd/sh.rb b/Library/Homebrew/cmd/sh.rb index 071f098917..90d1f6895b 100644 --- a/Library/Homebrew/cmd/sh.rb +++ b/Library/Homebrew/cmd/sh.rb @@ -1,12 +1,3 @@ -#: * `sh` [`--env=std`]: -#: Start a Homebrew build environment shell. Uses our years-battle-hardened -#: Homebrew build logic to help your `./configure && make && make install` -#: or even your `gem install` succeed. Especially handy if you run Homebrew -#: in an Xcode-only configuration since it adds tools like `make` to your `PATH` -#: which otherwise build systems would not find. -#: -#: If `--env=std` is passed, use the standard `PATH` instead of superenv's. - require "extend/ENV" require "formula" require "cli_parser" diff --git a/Library/Homebrew/cmd/style.rb b/Library/Homebrew/cmd/style.rb index d09a362f6f..0256fe2b0e 100644 --- a/Library/Homebrew/cmd/style.rb +++ b/Library/Homebrew/cmd/style.rb @@ -1,22 +1,3 @@ -#: * `style` [`--fix`] [`--display-cop-names`] [`--only-cops=`|`--except-cops=`] [||]: -#: Check formulae or files for conformance to Homebrew style guidelines. -#: -#: Lists of , and may not be combined. If none are -#: provided, `style` will run style checks on the whole Homebrew library, -#: including core code and all formulae. -#: -#: If `--fix` is passed, automatically fix style violations using RuboCop's -#: auto-correct feature. -#: -#: If `--display-cop-names` is passed, include the RuboCop cop name for each -#: violation in the output. -#: -#: Passing `--only-cops=` will check for violations of only the listed -#: RuboCop , while `--except-cops=` will skip checking the listed -#: . For either option should be a comma-separated list of cop names. -#: -#: Exits with a non-zero status if any style violations are found. - require "json" require "open3" require "style" @@ -28,11 +9,11 @@ module Homebrew def style_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `style` [] [||] + `style` [] [||] Check formulae or files for conformance to Homebrew style guidelines. - Lists of , and may not be combined. If none are + Lists of , and may not be combined. If none are provided, `style` will run style checks on the whole Homebrew library, including core code and all formulae. EOS diff --git a/Library/Homebrew/cmd/switch.rb b/Library/Homebrew/cmd/switch.rb index 7bcc295a4d..1122f68c01 100644 --- a/Library/Homebrew/cmd/switch.rb +++ b/Library/Homebrew/cmd/switch.rb @@ -1,6 +1,3 @@ -#: * `switch` : -#: Symlink all of the specific of 's install to Homebrew prefix. - require "formula" require "keg" require "cli_parser" diff --git a/Library/Homebrew/cmd/tap-info.rb b/Library/Homebrew/cmd/tap-info.rb index e0cbba78d1..6db14fcea0 100644 --- a/Library/Homebrew/cmd/tap-info.rb +++ b/Library/Homebrew/cmd/tap-info.rb @@ -1,20 +1,3 @@ -#: * `tap-info`: -#: Display a brief summary of all installed taps. -#: -#: * `tap-info` (`--installed`|): -#: Display detailed information about one or more . -#: -#: Pass `--installed` to display information on all installed taps. -#: -#: * `tap-info` `--json=` (`--installed`|): -#: Print a JSON representation of . Currently the only accepted value -#: for is `v1`. -#: -#: Pass `--installed` to get information on installed taps. -#: -#: See the docs for examples of using the JSON output: -#: - require "cli_parser" module Homebrew @@ -23,10 +6,10 @@ module Homebrew def tap_info_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `tap-info` [] [] + `tap-info` [] [] - Display detailed information about one or more provided . - Display a brief summary of all installed taps if no are passed. + Display detailed information about one or more provided . + Display a brief summary of all installed taps if no are passed. EOS switch "--installed", description: "Display information on all installed taps." diff --git a/Library/Homebrew/cmd/tap-pin.rb b/Library/Homebrew/cmd/tap-pin.rb index 7878d550f2..0617e5ea8e 100644 --- a/Library/Homebrew/cmd/tap-pin.rb +++ b/Library/Homebrew/cmd/tap-pin.rb @@ -1,7 +1,3 @@ -#: * `tap-pin` : -#: Pin , prioritizing its formulae over core when formula names are supplied -#: by the user. See also `tap-unpin`. - require "cli_parser" module Homebrew @@ -12,7 +8,7 @@ module Homebrew usage_banner <<~EOS `tap-pin` - Pin , prioritizing its formulae over core when formula names are supplied + Pin , prioritising its formulae over core when formula names are supplied by the user. See also `tap-unpin`. EOS switch :debug diff --git a/Library/Homebrew/cmd/tap-unpin.rb b/Library/Homebrew/cmd/tap-unpin.rb index 056de3e1fd..7d030b969b 100644 --- a/Library/Homebrew/cmd/tap-unpin.rb +++ b/Library/Homebrew/cmd/tap-unpin.rb @@ -1,6 +1,3 @@ -#: * `tap-unpin` : -#: Unpin so its formulae are no longer prioritized. See also `tap-pin`. - require "cli_parser" module Homebrew @@ -11,7 +8,7 @@ module Homebrew usage_banner <<~EOS `tap-unpin` - Unpin so its formulae are no longer prioritized. See also `tap-pin`. + Unpin so its formulae are no longer prioritised. See also `tap-pin`. EOS switch :debug end diff --git a/Library/Homebrew/cmd/tap.rb b/Library/Homebrew/cmd/tap.rb index cc7f1cd6e3..917d5615c2 100644 --- a/Library/Homebrew/cmd/tap.rb +++ b/Library/Homebrew/cmd/tap.rb @@ -1,37 +1,3 @@ -#: * `tap`: -#: List all installed taps. -#: -#: * `tap` [`--full`] [`--force-auto-update`] `/` []: -#: Tap a formula repository. -#: -#: With unspecified, taps 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 -#: 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. -#: -#: By default, the repository is cloned as a shallow copy (`--depth=1`), but -#: if `--full` is passed, a full clone will be used. To convert a shallow copy -#: to a full copy, you can retap passing `--full` without first untapping. -#: -#: By default, only taps hosted on GitHub are auto-updated (for performance -#: reasons). If `--force-auto-update` is passed, this tap will be auto-updated -#: even if it is not hosted on GitHub. -#: -#: `tap` is re-runnable and exits successfully if there's nothing to do. -#: However, retapping with a different will cause an exception, so first -#: `untap` if you need to modify the . -#: -#: * `tap` `--repair`: -#: Migrate tapped formulae from symlink-based to directory-based structure. -#: -#: * `tap` `--list-pinned`: -#: List all pinned taps. - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/uninstall.rb b/Library/Homebrew/cmd/uninstall.rb index 8de4b4f0d5..15dc992a32 100644 --- a/Library/Homebrew/cmd/uninstall.rb +++ b/Library/Homebrew/cmd/uninstall.rb @@ -1,12 +1,3 @@ -#: * `uninstall`, `rm`, `remove` [`--force`] [`--ignore-dependencies`] : -#: Uninstall . -#: -#: If `--force` (or `-f`) is passed, and there are multiple versions of -#: installed, delete all installed versions. -#: -#: If `--ignore-dependencies` is passed, uninstalling won't fail, even if -#: formulae depending on would still be installed. - require "keg" require "formula" require "diagnostic" @@ -26,7 +17,7 @@ module Homebrew switch :force, description: "Delete all installed versions of the " switch "--ignore-dependencies", - description: "Dont fail uninstall, even if is a dependency of any installed "\ + description: "Don't fail uninstall, even if is a dependency of any installed "\ "formulae." switch :debug end diff --git a/Library/Homebrew/cmd/unlink.rb b/Library/Homebrew/cmd/unlink.rb index 81561f96d3..9e3b9f84a0 100644 --- a/Library/Homebrew/cmd/unlink.rb +++ b/Library/Homebrew/cmd/unlink.rb @@ -1,11 +1,3 @@ -#: * `unlink` [`--dry-run`] : -#: Remove symlinks for from the Homebrew prefix. This can be useful -#: for temporarily disabling a formula: -#: `brew unlink` `&&` `&& brew link` -#: -#: If `--dry-run` or `-n` is passed, Homebrew will list all files which would -#: be unlinked, but will not actually unlink or delete any files. - require "ostruct" require "cli_parser" diff --git a/Library/Homebrew/cmd/unpack.rb b/Library/Homebrew/cmd/unpack.rb index f091df6d78..764362af62 100644 --- a/Library/Homebrew/cmd/unpack.rb +++ b/Library/Homebrew/cmd/unpack.rb @@ -1,14 +1,3 @@ -#: * `unpack` [`--git`|`--patch`] [`--destdir=`] : -#: Unpack the source files for into subdirectories of the current -#: working directory. If `--destdir=` is given, the subdirectories will -#: be created in the directory named by instead. -#: -#: If `--patch` is passed, patches for will be applied to the -#: unpacked source. -#: -#: If `--git` (or `-g`) is passed, a Git repository will be initialized in the unpacked -#: source. This is useful for creating patches for the software. - require "stringio" require "formula" require "cli_parser" @@ -19,17 +8,17 @@ module Homebrew def unpack_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `usage` [] + `unpack` [] - Unpack the source files for into subdirectories of the current + Unpack the source files for into subdirectories of the current working directory. EOS flag "--destdir=", description: "Create subdirectories in the directory named by instead." switch "--patch", - description: "Patches for will be applied to the unpacked source." + description: "Patches for will be applied to the unpacked source." switch "-g", "--git", - description: "Initialize a Git repository in the unpacked source. This is useful for creating "\ + description: "Initialise a Git repository in the unpacked source. This is useful for creating "\ "patches for the software." switch :force switch :verbose diff --git a/Library/Homebrew/cmd/unpin.rb b/Library/Homebrew/cmd/unpin.rb index 4f4da23d43..9f75503499 100644 --- a/Library/Homebrew/cmd/unpin.rb +++ b/Library/Homebrew/cmd/unpin.rb @@ -1,7 +1,3 @@ -#: * `unpin` : -#: Unpin , allowing them to be upgraded by `brew upgrade` . -#: See also `pin`. - require "formula" require "cli_parser" @@ -11,9 +7,9 @@ module Homebrew def unpin_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `unpin` + `unpin` - Unpin , allowing them to be upgraded by `brew upgrade` . + Unpin , allowing them to be upgraded by `brew upgrade` . See also `pin`. EOS switch :verbose diff --git a/Library/Homebrew/cmd/untap.rb b/Library/Homebrew/cmd/untap.rb index 1dbeaf0621..250484f3df 100644 --- a/Library/Homebrew/cmd/untap.rb +++ b/Library/Homebrew/cmd/untap.rb @@ -1,6 +1,3 @@ -#: * `untap` : -#: Remove a tapped repository. - require "cli_parser" module Homebrew diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb index 71c6b81e7e..93b96c9ce5 100644 --- a/Library/Homebrew/cmd/upgrade.rb +++ b/Library/Homebrew/cmd/upgrade.rb @@ -1,42 +1,3 @@ -#: * `upgrade` [`--debug`] [`--build-from-source`|`--force-bottle`] [`--fetch-HEAD`] [`--ignore-pinned`] [`--keep-tmp`] [`--force`] [`--verbose`] [`--display-times`] [] [ ...]: -#: Upgrade outdated, unpinned brews (with existing and any appended install options). -#: -#: If are given, upgrade only the specified brews (unless they -#: are pinned; see `pin`, `unpin`). -#: -#: If `--debug` (or `-d`) is passed and brewing fails, open an interactive debugging -#: session with access to IRB or a shell inside the temporary build directory. -#: -#: If `--build-from-source` (or `-s`) is passed, compile the specified from -#: source even if a bottle is provided. Dependencies will still be installed -#: from bottles if they are available. -#: -#: If `--force-bottle` is passed, install from a bottle if it exists for the -#: current or newest version of macOS, even if it would not normally be used -#: for installation. -#: -#: If `--fetch-HEAD` is passed, fetch the upstream repository to detect if -#: the HEAD installation of the formula is outdated. Otherwise, the -#: repository's HEAD will be checked for updates when a new stable or devel -#: version has been released. -#: -#: If `--ignore-pinned` is passed, set a 0 exit code even if pinned formulae -#: are not upgraded. -#: -#: If `--keep-tmp` is passed, the temporary files created during installation -#: are not deleted. -#: -#: If `--force` (or `-f`) is passed, install without checking for previously -#: installed keg-only or non-migrated versions -#: -#: If `--verbose` (or `-v`) is passed, print the verification and postinstall steps. -#: -#: If `--display-times` is passed, install times for each formula are printed -#: at the end of the run. -#: -#: Additional options specific to may be appended to the command, -#: and can be listed with `brew options` . - require "install" require "reinstall" require "formula_installer" @@ -69,11 +30,11 @@ module Homebrew 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 "\ - "updates when a new stable or devel version has been released." + "updates when a new stable or development version has been released." switch "--ignore-pinned", description: "Set a 0 exit code even if pinned formulae are not upgraded." switch "--keep-tmp", - description: "Dont delete the temporary files created during installation." + description: "Don't delete the temporary files created during installation." switch :force, description: "Install without checking for previously installed keg-only or "\ "non-migrated versions." diff --git a/Library/Homebrew/cmd/uses.rb b/Library/Homebrew/cmd/uses.rb index 654211dbad..f25b3114a9 100644 --- a/Library/Homebrew/cmd/uses.rb +++ b/Library/Homebrew/cmd/uses.rb @@ -1,23 +1,3 @@ -#: * `uses` [`--installed`] [`--recursive`] [`--include-build`] [`--include-test`] [`--include-optional`] [`--skip-recommended`] [`--devel`|`--HEAD`] : -#: Show the formulae that specify as a dependency. When given -#: multiple formula arguments, show the intersection of formulae that use -#: . -#: -#: Use `--recursive` to resolve more than one level of dependencies. -#: -#: If `--installed` is passed, only list installed formulae. -#: -#: By default, `uses` shows all formulae that specify as a required -#: or recommended dependency. To include the `:build` type dependencies, pass -#: `--include-build`, to include the `:test` type dependencies, pass -#: `--include-test` and to include `:optional` dependencies pass -#: `--include-optional`. To skip `:recommended` type dependencies, pass -#: `--skip-recommended`. -#: -#: By default, `uses` shows usage of by stable builds. To find -#: cases where is used by development or HEAD build, pass -#: `--devel` or `--HEAD`. - require "formula" require "cli_parser" @@ -31,33 +11,33 @@ module Homebrew def uses_args Homebrew::CLI::Parser.new do usage_banner <<~EOS - `uses` [] + `uses` [] - Show the formulae that specify as a dependency. When given + Show the formulae that specify as a dependency. When given multiple formula arguments, show the intersection of formulae that use - . + . - By default, `uses` shows all formulae that specify as a required + By default, `uses` shows all formulae that specify as a required or recommended dependency. - By default, `uses` shows usage of by stable builds. + By default, `uses` shows usage of by stable builds. EOS switch "--recursive", description: "Resolve more than one level of dependencies." switch "--installed", description: "Only list installed formulae." switch "--include-build", - description: "Include all formulae that specify as `:build` type dependency." + description: "Include all formulae that specify as `:build` type dependency." switch "--include-test", - description: "Include all formulae that specify as `:test` type dependency." + description: "Include all formulae that specify as `:test` type dependency." switch "--include-optional", - description: "Include all formulae that specify as `:optional` type dependency." + description: "Include all formulae that specify as `:optional` type dependency." switch "--skip-recommended", - description: "Skip all formulae that specify as `:recommended` type dependency." + 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 build." switch "--HEAD", - description: "Show usage of by HEAD build." + description: "Show usage of by HEAD build." switch :debug conflicts "--devel", "--HEAD" end