cut v0.49.0

doc/CHANGELOG.md

@@ -1,5 +1,64 @@
 # CHANGELOG
 
+## 0.49.0
+
+* __Casks__
+  - 26 Casks added (406 updated) by 85 contributors since 0.48.0
+  - 2120 total Casks
+* __Features__
+ - [#7696][] DSL: add working `depends_on :macos`
+* __Breaking Changes__
+ - [#7673][] unify and recast "Cask name" & "title" as "token" (de-document visible Cask method `title`)
+ - [#7696][] DSL: deprecate and de-document `require_os_version` caveats method
+ - [#7507][] DSL: remove support for `caskroom_only`
+ - [#7506][] remove support for legacy form `destination_path`
+* __Fixes__
+ - [#7738][] Make `CLI::Alfred` and `Source::PathBase` work with Ruby 1.8 <3 [@claui][]
+ - [#7532][] get Alfred 'syncfolder' from Preferences. resolves #7216 <3 [@fniephaus][]
+ - [#7740][] relax sourceforge.jp URL pattern
+ - [#7605][] "cocoa" is a framework to remove from Cask names
+* __Internal Changes__
+ - [#7684][] revise accessibility methods in postflight mini-DSL
+ - [#7685][] revise plist methods in postflight mini-DSL
+ - [#7686][] revise suppress_move_to_applications method in postflight mini-DSL
+ - [#6184][] Introduce GPG operations
+ - [#7642][] Refactor backend classes to match pre/postflight renaming
+ - [#7568][] enforce header line consistency
+ - [#7530][] enforce a valid minimum DSL version in Casks
+ - [#7529][] remove all transitional tap migration code
+ - [#7510][] formalize more Cask whitespace linting
+ - [#7504][] enforce version `:latest` as a symbol
+ - [#7503][] adjust devscripts for DSL 1.0
+* __Documentation__
+  - 13 doc commits since 0.48.0
+* __Contributors__
+  - 39 new contributors since 0.48.0
+  - 1275 total contributors
+* __Release Date__
+  - 2014-12-02 06:04:00 UTC
+
+[#6184]: https://github.com/caskroom/homebrew-cask/issues/6184
+[#7503]: https://github.com/caskroom/homebrew-cask/issues/7503
+[#7504]: https://github.com/caskroom/homebrew-cask/issues/7504
+[#7506]: https://github.com/caskroom/homebrew-cask/issues/7506
+[#7507]: https://github.com/caskroom/homebrew-cask/issues/7507
+[#7510]: https://github.com/caskroom/homebrew-cask/issues/7510
+[#7529]: https://github.com/caskroom/homebrew-cask/issues/7529
+[#7530]: https://github.com/caskroom/homebrew-cask/issues/7530
+[#7532]: https://github.com/caskroom/homebrew-cask/issues/7532
+[#7568]: https://github.com/caskroom/homebrew-cask/issues/7568
+[#7605]: https://github.com/caskroom/homebrew-cask/issues/7605
+[#7642]: https://github.com/caskroom/homebrew-cask/issues/7642
+[#7673]: https://github.com/caskroom/homebrew-cask/issues/7673
+[#7684]: https://github.com/caskroom/homebrew-cask/issues/7684
+[#7685]: https://github.com/caskroom/homebrew-cask/issues/7685
+[#7686]: https://github.com/caskroom/homebrew-cask/issues/7686
+[#7696]: https://github.com/caskroom/homebrew-cask/issues/7696
+[#7738]: https://github.com/caskroom/homebrew-cask/issues/7738
+[#7740]: https://github.com/caskroom/homebrew-cask/issues/7740
+[@claui]: https://github.com/claui
+[@fniephaus]: https://github.com/fniephaus
+
 ## 0.48.0
 
 * __Casks__

doc/man/brew-cask.1

@@ -1,13 +1,13 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "HOMEBREW\-CASK" "1" "October 2014" "Homebrew-cask" "brew-cask"
+.TH "HOMEBREW\-CASK" "1" "December 2014" "Homebrew-cask" "brew-cask"
 .
 .SH "NAME"
 \fBhomebrew\-cask\fR \- A friendly binary installer for OS X
 .
 .SH "SYNOPSIS"
-\fBbrew cask\fR command [options] [\fICask\fR \.\.\.]
+\fBbrew cask\fR command [options] [\fItoken\fR \.\.\.]
 .
 .SH "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 graphical user interface\.
@@ -18,32 +18,32 @@ Homebrew\-cask works robustly enough that we welcome new users, but the project
 .SH "FREQUENTLY USED COMMANDS"
 .
 .TP
-\fBinstall [\-\-force]\fR \fICask\fR
+\fBinstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
-Install \fICask\fR\.
+Install Cask identified by \fItoken\fR\.
 .
 .TP
-\fBuninstall [\-\-force]\fR \fICask\fR
+\fBuninstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
-Uninstall \fICask\fR\.
+Uninstall Cask identified by \fItoken\fR\.
 .
 .TP
 \fBsearch\fR \fItext\fR | /\fIregexp\fR/
-Perform a substring search of Cask names for \fItext\fR\. If the text is delimited by slashes, it is interpreted as a Ruby regular expression\.
+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\.
 .
 .IP
-The Cask names returned by \fBsearch\fR are suitable as arguments for most other commands, such as \fBinstall\fR or \fBuninstall\fR\.
+The tokens returned by \fBsearch\fR are suitable as arguments for most other commands, such as \fBinstall\fR or \fBuninstall\fR\.
 .
 .SH "COMMANDS"
 .
 .TP
-\fBaudit\fR [\fICasks\fR]
+\fBaudit\fR [ \fItoken\fR \.\.\. ]
-Check \fICasks\fR for installability\. If no \fICasks\fR are given on the command line, all Casks are audited\.
+Check the given Casks for installability\. If no tokens are given on the command line, all Casks are audited\.
 .
 .TP
 \fBalfred\fR
 Modify Alfred\'s search scope to include the Caskroom directory where Applications are stored\.
 .
 .TP
-\fBcat\fR \fICask\fR
+\fBcat\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
 Dump the given Cask definition file to the standard output\.
 .
 .TP
@@ -51,46 +51,49 @@ Dump the given Cask definition file to the standard output\.
 Clean up cached downloads and tracker symlinks\. With \fB\-\-outdated\fR, only clean up cached downloads older than 10 days old\.
 .
 .TP
-\fBcreate\fR \fICask\fR
+\fBcreate\fR \fItoken\fR
-Generate a Cask definition file for the Cask named \fICask\fR and open a template for it in your favorite editor\.
+Generate a Cask definition file for the Cask identified by \fItoken\fR and open a template for it in your favorite editor\.
 .
 .TP
 \fBdoctor\fR or \fBdr\fR
 Check for configuration issues\. Can be useful to upload as a gist for developers along with a bug report\.
 .
 .TP
-\fBedit\fR \fICask\fR
+\fBedit\fR \fItoken\fR
 Open the given Cask definition file for editing\.
 .
 .TP
-\fBfetch\fR \fICask\fR [\-\-force]
+\fBfetch\fR [\-\-force] \fItoken\fR [ \fItoken\fR \.\.\. ]
 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\.
 .
 .TP
-\fBhome\fR or \fBhomepage\fR
+\fBhome\fR or \fBhomepage\fR [\fItoken\fR]
-Open the project page \fIhttp://caskroom\.io\fR in a browser\.
+Display the homepage associated with a given Cask in a browser\.
-.
-.TP
-\fBinfo\fR or \fBabv\fR \fICask\fR
-Display information about \fICask\fR\.
-.
-.TP
-\fBinstall [\-\-force]\fR \fICask\fR
-Install \fICask\fR\. With \fB\-\-force\fR, re\-install even if the Cask appears to be already present\.
 .
 .IP
-\fICask\fR is usually the name of a Cask as returned by \fBbrew cask search\fR, but see \fIOTHER WAYS TO SPECIFY A CASK\fR for variations\.
+With no arguments, display the project page \fIhttp://caskroom\.io\fR\.
 .
 .TP
-\fBlist\fR or \fBls\fR [\-1 | \-l] [\fICasks\fR]
+\fBinfo\fR or \fBabv\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
+Display information about the given Cask\.
+.
+.TP
+\fBinstall [\-\-force]\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
+Install the given Cask\. With \fB\-\-force\fR, re\-install even if the Cask appears to be already present\.
+.
+.IP
+\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\.
+.
+.TP
+\fBlist\fR or \fBls\fR [\-1 | \-l] [ \fItoken\fR \.\.\. ]
 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\.
 .
 .IP
-If \fICasks\fR are given, list the staged files for \fICasks\fR\.
+If \fItoken\fR is given, summarize the staged files associated with the given Cask\.
 .
 .TP
-\fBuninstall [\-\-force]\fR or \fBrm\fR or \fBremove\fR \fICask\fR
+\fBuninstall [\-\-force]\fR or \fBrm\fR or \fBremove\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
-Uninstall \fICask\fR\. With \fB\-\-force\fR, uninstall even if the Cask does not appear to be present\.
+Uninstall the given Cask\. With \fB\-\-force\fR, uninstall even if the Cask does not appear to be present\.
 .
 .IP
 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\.
@@ -99,14 +102,14 @@ Note that \fBuninstall \-\-force\fR is currently imperfect\. It will follow the
 \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\.
 .
 .TP
-\fBzap\fR \fICask\fR
+\fBzap\fR \fItoken\fR [ \fItoken\fR \.\.\. ]
-Unconditionally remove \fIall\fR files associated with \fICask\fR\.
+Unconditionally remove \fIall\fR files associated with the given Cask\.
 .
 .IP
 Implicitly performs all actions associated with \fBuninstall\fR, even if the Cask does not appear to be currently installed\.
 .
 .IP
-Removes all staged versions of the Cask distribution found under \fB/opt/homebrew\-cask/Caskroom/<Cask>\fR
+Removes all staged versions of the Cask distribution found under \fB/opt/homebrew\-cask/Caskroom/<token>\fR
 .
 .IP
 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\.
@@ -120,7 +123,7 @@ Display all Casks available for install\.
 .
 .TP
 \fBsearch\fR or \fB\-S\fR \fItext\fR | /\fIregexp\fR/
-Perform a substring search of Cask names for \fItext\fR\. If the text is delimited by slashes, it is interpreted as a Ruby regular expression\.
+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\.
 .
 .TP
 \fBupdate\fR
@@ -203,18 +206,18 @@ Homebrew\-cask is implemented as a external command for Homebrew\. That means th
 And updates to individual Cask definitions are received whenever you issue the Homebrew command: brew update
 .
 .SH "OTHER WAYS TO SPECIFY A CASK"
-Most homebrew\-cask commands can accept a Cask name as an argument\. As described above, a Cask name on the command line can take the form of:
+Most homebrew\-cask commands can accept a Cask token as an argument\. As described above, the argument can take the form of:
 .
 .IP "\(bu" 4
-A Cask name as returned by \fBbrew cask search\fR, \fIeg\fR \fBgoogle\-chrome\fR
+A token as returned by \fBbrew cask search\fR, \fIeg\fR \fBgoogle\-chrome\fR
 .
 .IP "" 0
 .
 .P
-Homebrew\-cask also accepts three other forms for Cask names:
+Homebrew\-cask also accepts three other forms in place of plain tokens:
 .
 .IP "\(bu" 4
-A fully\-qualified Cask name which includes the Tap name, \fIeg\fR \fBcaskroom/fonts/font\-symbola\fR
+A fully\-qualified token which includes the Tap name, \fIeg\fR \fBcaskroom/fonts/font\-symbola\fR
 .
 .IP "\(bu" 4
 A fully\-qualified pathname to a Cask file, \fIeg\fR \fB/usr/local/Cellar/brew\-cask/0\.25\.0/Casks/google\-chrome\.rb\fR

lib/cask/version.rb

@@ -1 +1 @@
-HOMEBREW_CASK_VERSION = '0.48.0'
+HOMEBREW_CASK_VERSION = '0.49.0'