brew.1.md.erb: improve output consistency.

This commit is contained in:
Mike McQuaid 2019-01-30 21:33:55 +00:00
parent bbea109926
commit a10ba20459
No known key found for this signature in database
GPG Key ID: 48A898132FD8EE70

View File

@ -29,19 +29,19 @@ For the full command list, see the [COMMANDS](#commands) section.
With `--verbose` or `-v`, many commands print extra debugging information. Note that With `--verbose` or `-v`, many commands print extra debugging information. Note that
these flags should only appear after a command. these flags should only appear after a command.
* `install` <formula>: ### `install` <formula>:
Install <formula>. Install <formula>.
* `uninstall` <formula>: ### `uninstall` <formula>:
Uninstall <formula>. Uninstall <formula>.
* `update`: ### `list`:
Fetch the newest version of Homebrew from GitHub using `git`(1).
* `list`:
List all installed formulae. List all installed formulae.
* `search` (<text>|`/`<text>`/`): ### `search` (<text>|`/`<text>`/`):
Perform a substring search of cask tokens and formula names for <text>. If <text> Perform a substring search of cask tokens and formula names for <text>. If <text>
is surrounded with slashes, then it is interpreted as a regular expression. is surrounded with slashes, then it is interpreted as a regular expression.
The search for <text> is extended online to `homebrew/core` and `homebrew/cask`. The search for <text> is extended online to `homebrew/core` and `homebrew/cask`.
@ -49,30 +49,33 @@ these flags should only appear after a command.
## COMMANDS ## COMMANDS
<%= commands.join("\n") %> <%= commands %>
## DEVELOPER COMMANDS ## DEVELOPER COMMANDS
<%= developer_commands.join("\n") %> <%= developer_commands %>
## GLOBAL OPTIONS ## GLOBAL OPTIONS
<%= global_options.join("\n") %> <%= global_options %>
## OFFICIAL EXTERNAL COMMANDS ## OFFICIAL EXTERNAL COMMANDS
<%= homebrew_bundle.join.strip %> ### `bundle` <subcommand>:
Bundler for non-Ruby dependencies from Homebrew, Homebrew Cask and the Mac App Store. See `brew bundle --help`.
**Homebrew/homebrew-bundle**: <https://github.com/Homebrew/homebrew-bundle> **Homebrew/homebrew-bundle**: <https://github.com/Homebrew/homebrew-bundle>
* `cask` [`--version` | `audit` | `cat` | `cleanup` | `create` | `doctor` | `edit` | `fetch` | `home` | `info`]: ### `cask` <subcommand>:
Install macOS applications distributed as binaries.
Install macOS applications distributed as binaries. See brew-cask(1).
**Homebrew/homebrew-cask**: <https://github.com/Homebrew/homebrew-cask> **Homebrew/homebrew-cask**: <https://github.com/Homebrew/homebrew-cask>
<%= homebrew_services.join.strip %> ### `services` <subcommand>:
Manage background services with macOS' `launchctl`(1) daemon manager. See `brew services --help`.
**Homebrew/homebrew-services**: <https://github.com/Homebrew/homebrew-services> **Homebrew/homebrew-services**: <https://github.com/Homebrew/homebrew-services>
@ -213,7 +216,7 @@ Note that environment variables must have a value set to be detected. For exampl
rather than falling back to building from source. rather than falling back to building from source.
* `HOMEBREW_NO_COLOR`: * `HOMEBREW_NO_COLOR`:
If set, Homebrew will not print text with color added. If set, Homebrew will not print text with colour added.
* `HOMEBREW_NO_EMOJI`: * `HOMEBREW_NO_EMOJI`:
If set, Homebrew will not print the `HOMEBREW_INSTALL_BADGE` on a If set, Homebrew will not print the `HOMEBREW_INSTALL_BADGE` on a