cut v0.60.0
[Homebrew/homebrew-cask-versions.git] / man / man1 / brew-cask.1
blob17b06b9b1db24faa335b385f7cf768714f5501db
1 .\" generated with Ronn/v0.7.3
2 .\" http://github.com/rtomayko/ronn/tree/0.7.3
4 .TH "BREW\-CASK" "1" "December 2015" "Homebrew-cask" "brew-cask"
6 .SH "SYNOPSIS"
7 \fBbrew cask\fR command [options] [\fItoken\fR \.\.\.]
9 .SH "DESCRIPTION"
10 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 graphical user interface\.
12 .SH "ALPHA\-QUALITY SOFTWARE"
13 Homebrew\-cask works robustly enough that we welcome new users, but the project is still in early development\. That means command names, option names, and other aspects of this manual are still subject to change\.
15 .SH "FREQUENTLY USED COMMANDS"
17 .TP
18 \fBinstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
19 Install Cask identified by \fItoken\fR\.
21 .TP
22 \fBuninstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
23 Uninstall Cask identified by \fItoken\fR\.
25 .TP
26 \fBsearch\fR \fItext\fR | /\fIregexp\fR/
27 Perform a substring search of known Cask tokens for \fItext\fR\. If the text is delimited by slashes, it is interpreted as a Ruby regular expression\.
29 .IP
30 The tokens returned by \fBsearch\fR are suitable as arguments for most other commands, such as \fBinstall\fR or \fBuninstall\fR\.
32 .SH "COMMANDS"
34 .TP
35 \fBaudit\fR [ \fItoken\fR \.\.\. ]
36 Check the given Casks for installability\. If no tokens are given on the command line, all Casks are audited\.
38 .TP
39 \fBcat\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
40 Dump the given Cask definition file to the standard output\.
42 .TP
43 \fBcleanup\fR [\-\-outdated]
44 Clean up cached downloads and tracker symlinks\. With \fB\-\-outdated\fR, only clean up cached downloads older than 10 days old\.
46 .TP
47 \fBcreate\fR \fItoken\fR
48 Generate a Cask definition file for the Cask identified by \fItoken\fR and open a template for it in your favorite editor\.
50 .TP
51 \fBdoctor\fR or \fBdr\fR
52 Check for configuration issues\. Can be useful to upload as a gist for developers along with a bug report\.
54 .TP
55 \fBedit\fR \fItoken\fR
56 Open the given Cask definition file for editing\.
58 .TP
59 \fBfetch\fR [\-\-force] \fItoken\fR [ \fItoken\fR \.\.\. ]
60 Fetch remote resources for the given Cask to the local cache\. With \fB\-\-force\fR, force re\-download even if the resources are already cached\.
62 .TP
63 \fBhome\fR or \fBhomepage\fR [\fItoken\fR]
64 Display the homepage associated with a given Cask in a browser\.
66 .IP
67 With no arguments, display the project page \fIhttp://caskroom\.io\fR\.
69 .TP
70 \fBinfo\fR or \fBabv\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
71 Display information about the given Cask\.
73 .TP
74 \fBinstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
75 Install the given Cask\. With \fB\-\-force\fR, re\-install even if the Cask appears to be already present\.
77 .IP
78 \fItoken\fR is usually the ID of a Cask as returned by \fBbrew cask search\fR, but see \fIOTHER WAYS TO SPECIFY A CASK\fR for variations\.
80 .TP
81 \fBlist\fR or \fBls\fR [\-1 | \-l] [ \fItoken\fR \.\.\. ]
82 Without any arguments, list all installed Casks\. With \fB\-1\fR, always format the output in a single column\. With \fB\-l\fR, give a more detailed listing\.
84 .IP
85 If \fItoken\fR is given, summarize the staged files associated with the given Cask\.
87 .TP
88 \fBsearch\fR or \fB\-S\fR
89 Display all Casks available for install\.
91 .TP
92 \fBsearch\fR or \fB\-S\fR \fItext\fR | /\fIregexp\fR/
93 Perform a substring search of known Cask tokens for \fItext\fR\. If the text is delimited by slashes, it is interpreted as a Ruby regular expression\.
95 .TP
96 \fBuninstall [\-\-force]\fR or \fBrm\fR or \fBremove\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
97 Uninstall the given Cask\. With \fB\-\-force\fR, uninstall even if the Cask does not appear to be present\.
99 .IP
100 Note that \fBuninstall \-\-force\fR is currently imperfect\. It will follow the \fBuninstall\fR instructions from \fInewest\fR Cask definition, even if the given Cask has changed since you installed it\. The result is that \fBuninstall \-\-force\fR will always succeed in removing relevant files under \fB/opt/homebrew\-cask\fR, but will sometimes fail to remove relevant installed files outside of \fB/opt/homebrew\-cask\fR\. This issue is being addressed\.
103 \fBuninstall\fR without \fB\-\-force\fR is also imperfect\. It may be unable to perform an \fBuninstall\fR operation if the given Cask has changed since you installed it\. This issue is being addressed\.
106 \fBupdate\fR
107 For convenience\. \fBbrew cask update\fR is a synonym for \fBbrew update\fR\.
110 \fBzap\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
111 Unconditionally remove \fIall\fR files associated with the given Cask\.
114 Implicitly performs all actions associated with \fBuninstall\fR, even if the Cask does not appear to be currently installed\.
117 Removes all staged versions of the Cask distribution found under \fB/opt/homebrew\-cask/Caskroom/<token>\fR
120 If the Cask definition contains a \fBzap\fR stanza, performs additional \fBzap\fR actions as defined there, such as removing local preference files\. \fBzap\fR actions are variable, depending on the level of detail defined by the Cask author\.
123 \fB\fBzap\fR may remove resources which are shared between applications\.\fR
125 .SH "OPTIONS"
126 To make these options persistent, see the ENVIRONMENT section, below\.
129 Some of these (such as \fB\-\-prefpanedir\fR) may be subject to removal in a future version\.
132 \fB\-\-force\fR
133 Force an install to proceed even when a previously\-existing install is detected\.
136 \fB\-\-caskroom=<path>\fR
137 Location of the Caskroom, where all binaries are stored\. The default value is: \fB/opt/homebrew\-cask/Caskroom\fR\.
140 \fB\-\-verbose\fR
141 Give additional feedback during installation\.
144 \fB\-\-appdir=<path>\fR
145 Target location for Application links\. The default value is \fB~/Applications\fR\.
148 \fB\-\-colorpickerdir=<path>\fR
149 Target location for Color Picker links\. The default value is \fB~/Library/Color Pickers\fR\.
152 \fB\-\-prefpanedir=<path>\fR
153 Target location for Preference Pane links\. The default value is \fB~/Library/Preference Panes\fR\.
156 \fB\-\-qlplugindir=<path>\fR
157 Target location for QuickLook Plugin links\. The default value is \fB~/Library/QuickLook\fR\.
160 \fB\-\-fontdir=<path>\fR
161 Target location for Font links\. The default value is \fB~/Library/Fonts\fR\.
164 \fB\-\-servicedir=<path>\fR
165 Target location for Service links\. The default value is \fB~/Library/Services\fR\.
168 \fB\-\-input_methoddir=<path>\fR
169 Target location for Input Method links\. The default value is \fB~/Library/Input Methods\fR\.
172 \fB\-\-internet_plugindir=<path>\fR
173 Target location for Internet Plugin links\. The default value is \fB~/Library/Internet Plug\-Ins\fR\.
176 \fB\-\-screen_saverdir=<path>\fR
177 Target location for Screen Saver links\. The default value is \fB~/Library/Screen Savers\fR\.
180 \fB\-\-no\-binaries\fR
181 Do not link “helper” executables to \fB/usr/local/bin\fR\.
184 \fB\-\-binarydir=<path>\fR
185 Target location for “helper” executable links\. The default value is \fB/usr/local/bin\fR\.
188 \fB\-\-debug\fR
189 Output debugging information of use to Cask authors and developers\.
191 .SH "INTERACTION WITH HOMEBREW"
192 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: \fBbrew update && brew upgrade brew\-cask && brew cleanup && brew cask cleanup\fR
195 And updates to individual Cask definitions are received whenever you issue the Homebrew command: brew update
197 .SH "OTHER WAYS TO SPECIFY A CASK"
198 Most homebrew\-cask commands can accept a Cask token as an argument\. As described above, the argument can take the form of:
200 .IP "\(bu" 4
201 A token as returned by \fBbrew cask search\fR, \fIeg\fR \fBgoogle\-chrome\fR
203 .IP "" 0
206 Homebrew\-cask also accepts three other forms in place of plain tokens:
208 .IP "\(bu" 4
209 A fully\-qualified token which includes the Tap name, \fIeg\fR \fBcaskroom/fonts/font\-symbola\fR
211 .IP "\(bu" 4
212 A fully\-qualified pathname to a Cask file, \fIeg\fR \fB/usr/local/Cellar/brew\-cask/0\.25\.0/Casks/google\-chrome\.rb\fR
214 .IP "\(bu" 4
215 A \fBcurl\fR\-retrievable URI to a Cask file, \fIeg\fR \fBhttps://raw\.github\.com/caskroom/homebrew\-cask/f54bbfaae0f2fa7210484f46313a459cb8a14d2f/Casks/google\-chrome\.rb\fR
217 .IP "" 0
219 .SH "ENVIRONMENT"
220 Homebrew\-cask respects many of the environment variables used by the parent command \fBbrew\fR\. Please refer to the \fBbrew\fR(1) man page for more information\.
223 Environment variables specific to homebrew\-cask:
226 HOMEBREW_CASK_OPTS
227 This variable may contain any arguments normally used as options on the command\-line\. This is particularly useful to make options persistent\. For example, you might add to your \.bash_profile or \.zshenv something like: \fBexport HOMEBREW_CASK_OPTS=\'\-\-appdir=/Applications \-\-caskroom=/etc/Caskroom\'\fR\.
229 .SH "SEE ALSO"
230 The homebrew\-cask home page: \fIhttp://caskroom\.io\fR\.
233 The homebrew\-cask GitHub page: \fIhttps://github\.com/caskroom/homebrew\-cask\fR\.
236 \fBbrew\fR(1), \fBcurl\fR(1)
238 .SH "AUTHORS"
239 Paul Hinze and Contributors\.
242 Man page format based on \fBbrew\.1\.md\fR from Homebrew\.
244 .SH "BUGS"
245 We still have bugs — and we are busy fixing them! If you have a problem, don’t be shy about reporting it on our GitHub issues page \fIhttps://github\.com/caskroom/homebrew\-cask/issues?state=open\fR\.
248 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 your command\-line started with \fBbrew cask\fR, bring the bug to us first!