aboutsummaryrefslogtreecommitdiffstats
path: root/Library
diff options
context:
space:
mode:
authorMartin Afanasjew2015-12-09 05:13:45 +0100
committerMartin Afanasjew2015-12-10 15:00:36 +0100
commit8144f90eac3103c369af1435440c7387ab583091 (patch)
tree90e7f41d1e025c0a7de9922cb6f31834d7efd644 /Library
parent4b3056e2fc6c2c0bcc7fca630c0e03adc20712ee (diff)
downloadbrew-8144f90eac3103c369af1435440c7387ab583091.tar.bz2
manpage: fix formatting of command list
Restore definition list in `COMMANDS` section, thus massively improve formatting. In theory, `ronn` supports nested (definition) lists. In practice, this does not work (and is unlikely to be fixed soon because upstream seems to be rather inactive) causing the entire definition list to be longer recognized because of a single nested list. Work around by rearranging the `tap` documentation (sole command with a nested list).
Diffstat (limited to 'Library')
-rw-r--r--Library/Homebrew/manpages/brew.1.md24
1 files changed, 12 insertions, 12 deletions
diff --git a/Library/Homebrew/manpages/brew.1.md b/Library/Homebrew/manpages/brew.1.md
index 135561145..0fdde0b0c 100644
--- a/Library/Homebrew/manpages/brew.1.md
+++ b/Library/Homebrew/manpages/brew.1.md
@@ -377,21 +377,21 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
* `switch` <name> <version>:
Symlink all of the specific <version> of <name>'s install to Homebrew prefix.
- * `tap` [`--full`] <user>`/`<repo> [<URL>]:
- Tap a formula repository or list existing taps. This command can be invoked
- in three ways.
+ * `tap`:
+ List all installed taps.
- + `tap` without arguments displays existing taps.
+ * `tap` [`--full`] <user>`/`<repo> [<URL>]:
+ Tap a formula repository.
- + `tap` <user>`/`<repo> taps a formula repository from GitHub using HTTPS.
- Since so many taps are hosted on GitHub, this command is a shortcut for
- `tap <user>/<repo> https://github.com/<user>/homebrew-<repo>`.
+ With <URL> unspecified, taps a formula repository from GitHub using HTTPS.
+ Since so many taps are hosted on GitHub, this command is a shortcut for
+ `tap <user>/<repo> https://github.com/<user>/homebrew-<repo>`.
- + `tap` <user>`/`<repo> <URL> 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.
+ With <URL> 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.