Deprecate `--caskroom` flag.

6 files changed, 15 insertions, 17 deletions

diff --git a/Library/Homebrew/cask/lib/hbc/cli.rb b/Library/Homebrew/cask/lib/hbc/cli.rb
index 1c20a2a33..f0cb5806f 100644
--- a/Library/Homebrew/cask/lib/hbc/cli.rb
+++ b/Library/Homebrew/cask/lib/hbc/cli.rb
@@ -49,7 +49,6 @@ module Hbc
 
     include Options
 
-    option "--caskroom=PATH",             ->(value) { Hbc.caskroom             = value }
     option "--appdir=PATH",               ->(value) { Hbc.appdir               = value }
     option "--colorpickerdir=PATH",       ->(value) { Hbc.colorpickerdir       = value }
     option "--prefpanedir=PATH",          ->(value) { Hbc.prefpanedir          = value }
diff --git a/Library/Homebrew/compat/hbc.rb b/Library/Homebrew/compat/hbc.rb
index 353a72488..3ff8fccb7 100644
--- a/Library/Homebrew/compat/hbc.rb
+++ b/Library/Homebrew/compat/hbc.rb
@@ -2,6 +2,7 @@ require "compat/hbc/cask_loader"
 require "compat/hbc/cli/update"
 require "compat/hbc/cache"
 require "compat/hbc/caskroom"
+require "compat/hbc/cli"
 
 module Hbc
   class << self
diff --git a/Library/Homebrew/compat/hbc/cli.rb b/Library/Homebrew/compat/hbc/cli.rb
new file mode 100644
index 000000000..d563e64cb
--- /dev/null
+++ b/Library/Homebrew/compat/hbc/cli.rb
@@ -0,0 +1,12 @@
+require "cask/lib/hbc/cli/options"
+
+module Hbc
+  class CLI
+    include Options
+
+    option "--caskroom=PATH", (lambda do |value|
+      Hbc.caskroom = value
+      odeprecated "`brew cask` with the `--caskroom` flag", disable_on: Time.utc(2017, 10, 31)
+    end)
+  end
+end
diff --git a/Library/Homebrew/manpages/brew-cask.1.md b/Library/Homebrew/manpages/brew-cask.1.md
index 6b4e8bc87..bfb9cd7a5 100644
--- a/Library/Homebrew/manpages/brew-cask.1.md
+++ b/Library/Homebrew/manpages/brew-cask.1.md
@@ -160,9 +160,6 @@ in a future version.
   *  `--require-sha`:
     Abort Cask installation if the Cask does not have a checksum defined.
 
-  * `--caskroom=<path>`:
-    Set location of the Caskroom, where all binaries are stored. The default value is `$(brew --prefix)/Caskroom`.
-
   * `--verbose`:
     Give additional feedback during installation.
 
@@ -255,7 +252,7 @@ Environment variables specific to Homebrew-Cask:
     the command-line. This is particularly useful to make options persistent.
     For example, you might add to your .bash_profile or .zshenv something like:
 
-               export HOMEBREW_CASK_OPTS='--appdir=/Applications --caskroom=/etc/Caskroom'
+               export HOMEBREW_CASK_OPTS='--appdir=~/Applications --fontdir=/Library/Fonts'
 
 Other environment variables:
            
diff --git a/Library/Homebrew/test/cask/cli_spec.rb b/Library/Homebrew/test/cask/cli_spec.rb
index baad160c3..569b831de 100644
--- a/Library/Homebrew/test/cask/cli_spec.rb
+++ b/Library/Homebrew/test/cask/cli_spec.rb
@@ -54,13 +54,6 @@ describe Hbc::CLI, :cask do
       described_class.run("noop")
     end
 
-    it "respects the env variable when choosing a non-default Caskroom location" do
-      allow(ENV).to receive(:[])
-      allow(ENV).to receive(:[]).with("HOMEBREW_CASK_OPTS").and_return("--caskroom=/custom/caskdir")
-      expect(Hbc).to receive(:caskroom=).with(Pathname.new("/custom/caskdir"))
-      described_class.run("noop")
-    end
-
     it "exits with a status of 1 when something goes wrong" do
       allow(described_class).to receive(:lookup_command).and_raise(Hbc::CaskError)
       command = Hbc::CLI.new("noop")
diff --git a/manpages/brew-cask.1 b/manpages/brew-cask.1
index 353de66bf..e6066136e 100644
--- a/manpages/brew-cask.1
+++ b/manpages/brew-cask.1
@@ -161,10 +161,6 @@ Skip Cask dependencies when installing\.
 Abort Cask installation if the Cask does not have a checksum defined\.
 .
 .TP
-\fB\-\-caskroom=<path>\fR
-Set location of the Caskroom, where all binaries are stored\. The default value is \fB$(brew \-\-prefix)/Caskroom\fR\.
-.
-.TP
 \fB\-\-verbose\fR
 Give additional feedback during installation\.
 .
@@ -290,7 +286,7 @@ This variable may contain any arguments normally used as options on the command\
 .
 .nf
 
-       export HOMEBREW_CASK_OPTS=\'\-\-appdir=/Applications \-\-caskroom=/etc/Caskroom\'
+       export HOMEBREW_CASK_OPTS=\'\-\-appdir=~/Applications \-\-fontdir=/Library/Fonts\'
 .
 .fi
 .