doc/src/brew-cask.1.md: removed double spacing
This commit is contained in:
parent
b66fbf0a82
commit
2615833b15
|
@ -8,13 +8,13 @@ homebrew-cask(1) — A friendly binary installer for OS X
|
|||
## DESCRIPTION
|
||||
|
||||
Homebrew-cask is a tool for installing precompiled OS X binaries (such as
|
||||
Applications) from the command line. The user is never required to use the
|
||||
Applications) from the command line. The user is never required to use the
|
||||
graphical user interface.
|
||||
|
||||
## ALPHA-QUALITY SOFTWARE
|
||||
|
||||
Homebrew-cask works robustly enough that we welcome new users, but the
|
||||
project is still in early development. That means command names, option
|
||||
project is still in early development. That means command names, option
|
||||
names, and other aspects of this manual are still subject to change.
|
||||
|
||||
## FREQUENTLY USED COMMANDS
|
||||
|
@ -26,7 +26,7 @@ names, and other aspects of this manual are still subject to change.
|
|||
Uninstall Cask identified by <token>.
|
||||
|
||||
* `search` <text> | /<regexp>/:
|
||||
Perform a substring search of known Cask tokens for <text>. If the text
|
||||
Perform a substring search of known Cask tokens for <text>. If the text
|
||||
is delimited by slashes, it is interpreted as a Ruby regular expression.
|
||||
|
||||
The tokens returned by `search` are suitable as arguments for most other
|
||||
|
@ -42,7 +42,7 @@ names, and other aspects of this manual are still subject to change.
|
|||
Dump the given Cask definition file to the standard output.
|
||||
|
||||
* `cleanup` [--outdated]:
|
||||
Clean up cached downloads and tracker symlinks. With `--outdated`,
|
||||
Clean up cached downloads and tracker symlinks. With `--outdated`,
|
||||
only clean up cached downloads older than 10 days old.
|
||||
|
||||
* `create` <token>:
|
||||
|
@ -50,14 +50,14 @@ names, and other aspects of this manual are still subject to change.
|
|||
and open a template for it in your favorite editor.
|
||||
|
||||
* `doctor` or `dr`:
|
||||
Check for configuration issues. Can be useful to upload as a gist for
|
||||
Check for configuration issues. Can be useful to upload as a gist for
|
||||
developers along with a bug report.
|
||||
|
||||
* `edit` <token>:
|
||||
Open the given Cask definition file for editing.
|
||||
|
||||
* `fetch` [--force] <token> [ <token> ... ]:
|
||||
Fetch remote resources for the given Cask to the local cache. With
|
||||
Fetch remote resources for the given Cask to the local cache. With
|
||||
`--force`, force re-download even if the resources are already cached.
|
||||
|
||||
* `home` or `homepage` [<token>]:
|
||||
|
@ -69,35 +69,35 @@ names, and other aspects of this manual are still subject to change.
|
|||
Display information about the given Cask.
|
||||
|
||||
* `install [--force]` <token> [ <token> ... ]:
|
||||
Install the given Cask. With `--force`, re-install even if the Cask
|
||||
Install the given Cask. With `--force`, re-install even if the Cask
|
||||
appears to be already present.
|
||||
|
||||
<token> is usually the ID of a Cask as returned by `brew cask search`,
|
||||
but see [OTHER WAYS TO SPECIFY A CASK][] for variations.
|
||||
|
||||
* `list` or `ls` [-1 | -l] [ <token> ... ]:
|
||||
Without any arguments, list all installed Casks. With `-1`, always
|
||||
format the output in a single column. With `-l`, give a more detailed
|
||||
Without any arguments, list all installed Casks. With `-1`, always
|
||||
format the output in a single column. With `-l`, give a more detailed
|
||||
listing.
|
||||
|
||||
If <token> is given, summarize the staged files associated with the
|
||||
given Cask.
|
||||
|
||||
* `uninstall [--force]` or `rm` or `remove` <token> [ <token> ... ]:
|
||||
Uninstall the given Cask. With `--force`, uninstall even if the Cask
|
||||
Uninstall the given Cask. With `--force`, uninstall even if the Cask
|
||||
does not appear to be present.
|
||||
|
||||
Note that `uninstall --force` is currently imperfect. It will follow
|
||||
Note that `uninstall --force` is currently imperfect. It will follow
|
||||
the `uninstall` instructions from *newest* Cask definition, even if
|
||||
the given Cask has changed since you installed it. The result is that
|
||||
the given Cask has changed since you installed it. The result is that
|
||||
`uninstall --force` will always succeed in removing relevant files
|
||||
under `/opt/homebrew-cask`, but will sometimes fail to remove relevant
|
||||
installed files outside of `/opt/homebrew-cask`. This issue is being
|
||||
installed files outside of `/opt/homebrew-cask`. This issue is being
|
||||
addressed.
|
||||
|
||||
`uninstall` without `--force` is also imperfect. It may be unable to
|
||||
`uninstall` without `--force` is also imperfect. It may be unable to
|
||||
perform an `uninstall` operation if the given Cask has changed since you
|
||||
installed it. This issue is being addressed.
|
||||
installed it. This issue is being addressed.
|
||||
|
||||
* `zap` <token> [ <token> ... ]:
|
||||
Unconditionally remove _all_ files associated with the given Cask.
|
||||
|
@ -110,7 +110,7 @@ names, and other aspects of this manual are still subject to change.
|
|||
|
||||
If the Cask definition contains a `zap` stanza, performs additional
|
||||
`zap` actions as defined there, such as removing local preference
|
||||
files. `zap` actions are variable, depending on the level of detail
|
||||
files. `zap` actions are variable, depending on the level of detail
|
||||
defined by the Cask author.
|
||||
|
||||
**`zap` may remove resources which are shared between applications.**
|
||||
|
@ -119,7 +119,7 @@ names, and other aspects of this manual are still subject to change.
|
|||
Display all Casks available for install.
|
||||
|
||||
* `search` or `-S` <text> | /<regexp>/:
|
||||
Perform a substring search of known Cask tokens for <text>. If the text
|
||||
Perform a substring search of known Cask tokens for <text>. If the text
|
||||
is delimited by slashes, it is interpreted as a Ruby regular expression.
|
||||
|
||||
* `update`:
|
||||
|
@ -137,51 +137,51 @@ in a future version.
|
|||
is detected.
|
||||
|
||||
* `--caskroom=<path>`:
|
||||
Location of the Caskroom, where all binaries are stored. The default value is: `/opt/homebrew-cask/Caskroom`.
|
||||
Location of the Caskroom, where all binaries are stored. The default value is: `/opt/homebrew-cask/Caskroom`.
|
||||
|
||||
* `--verbose`:
|
||||
Give additional feedback during installation.
|
||||
|
||||
* `--appdir=<path>`:
|
||||
Target location for Application links. The default value is `~/Applications`.
|
||||
Target location for Application links. The default value is `~/Applications`.
|
||||
|
||||
* `--colorpickerdir=<path>`:
|
||||
Target location for Color Picker links. The default value is `~/Library/Color Pickers`.
|
||||
Target location for Color Picker links. The default value is `~/Library/Color Pickers`.
|
||||
|
||||
* `--prefpanedir=<path>`:
|
||||
Target location for Preference Pane links. The default value is `~/Library/Preference Panes`.
|
||||
Target location for Preference Pane links. The default value is `~/Library/Preference Panes`.
|
||||
|
||||
* `--qlplugindir=<path>`:
|
||||
Target location for QuickLook Plugin links. The default value is `~/Library/QuickLook`.
|
||||
Target location for QuickLook Plugin links. The default value is `~/Library/QuickLook`.
|
||||
|
||||
* `--fontdir=<path>`:
|
||||
Target location for Font links. The default value is `~/Library/Fonts`.
|
||||
Target location for Font links. The default value is `~/Library/Fonts`.
|
||||
|
||||
* `--servicedir=<path>`:
|
||||
Target location for Service links. The default value is `~/Library/Services`.
|
||||
Target location for Service links. The default value is `~/Library/Services`.
|
||||
|
||||
* `--input_methoddir=<path>`:
|
||||
Target location for Input Method links. The default value is `~/Library/Input Methods`.
|
||||
Target location for Input Method links. The default value is `~/Library/Input Methods`.
|
||||
|
||||
* `--internet_plugindir=<path>`:
|
||||
Target location for Internet Plugin links. The default value is `~/Library/Internet Plug-Ins`.
|
||||
Target location for Internet Plugin links. The default value is `~/Library/Internet Plug-Ins`.
|
||||
|
||||
* `--screen_saverdir=<path>`:
|
||||
Target location for Screen Saver links. The default value is `~/Library/Screen Savers`.
|
||||
Target location for Screen Saver links. The default value is `~/Library/Screen Savers`.
|
||||
|
||||
* `--no-binaries`:
|
||||
Do not link “helper” executables to `/usr/local/bin`.
|
||||
|
||||
* `--binarydir=<path>`:
|
||||
Target location for “helper” executable links. The default value is `/usr/local/bin`.
|
||||
Target location for “helper” executable links. The default value is `/usr/local/bin`.
|
||||
|
||||
* `--debug`:
|
||||
Output debugging information of use to Cask authors and developers.
|
||||
|
||||
## INTERACTION WITH HOMEBREW
|
||||
|
||||
Homebrew-cask is implemented as a external command for Homebrew. That means
|
||||
this project is entirely built upon the Homebrew infrastructure. For
|
||||
Homebrew-cask is implemented as a external command for Homebrew. That means
|
||||
this project is entirely built upon the Homebrew infrastructure. For
|
||||
example, upgrades to the Homebrew-cask tool are received through Homebrew:
|
||||
brew update && brew upgrade brew-cask && brew cleanup && brew cask cleanup
|
||||
|
||||
|
@ -191,7 +191,7 @@ the Homebrew command:
|
|||
|
||||
## OTHER WAYS TO SPECIFY A CASK
|
||||
|
||||
Most homebrew-cask commands can accept a Cask token as an argument. As
|
||||
Most homebrew-cask commands can accept a Cask token as an argument. As
|
||||
described above, the argument can take the form of:
|
||||
|
||||
* A token as returned by `brew cask search`, _eg_ `google-chrome`
|
||||
|
@ -210,7 +210,7 @@ Homebrew-cask also accepts three other forms in place of plain tokens:
|
|||
## ENVIRONMENT
|
||||
|
||||
Homebrew-cask respects many of the environment variables used by the
|
||||
parent command `brew`. Please refer to the `brew`(1) man page for more
|
||||
parent command `brew`. Please refer to the `brew`(1) man page for more
|
||||
information.
|
||||
|
||||
Environment variables specific to homebrew-cask:
|
||||
|
@ -241,5 +241,5 @@ We still have bugs — and we are busy fixing them! If you have a problem, don
|
|||
be shy about reporting it on our [GitHub issues page](https://github.com/caskroom/homebrew-cask/issues?state=open).
|
||||
|
||||
When reporting bugs, remember that homebrew-cask is an independent project from
|
||||
Homebrew. Do your best to direct bug reports to the appropriate project. If
|
||||
Homebrew. Do your best to direct bug reports to the appropriate project. If
|
||||
your command-line started with `brew cask`, bring the bug to us first!
|
||||
|
|
Loading…
Reference in New Issue