Merge pull request #4925 from rolandwalker/doc_ruby_interpreter_vsn

doc latest Ruby interpreter situation in HACKING.md
This commit is contained in:
Roland Walker 2014-06-16 18:05:15 -04:00
commit 93617b1286
1 changed files with 11 additions and 4 deletions

View File

@ -156,10 +156,17 @@ homebrew-cask, it's a great idea to hang out with us there. Here's why:
## What Version of Ruby Should I Target?
We target the vendor-supplied Ruby interpreter. Apple provided Ruby 1.8.7
as recently as OS X 10.8 (Mountain Lion). Therefore, even though OS X 10.9
(Mavericks) has Ruby 2.0.0-p247, this project targets Ruby 1.8.7 for
backwards compatibility.
Homebrew-cask is `require`d from within the Ruby environment of the parent
Homebrew command (`brew`).
Therefore, Homebrew-cask uses whichever Ruby interpreter chosen by Homebrew.
This is generally an Apple-supplied Ruby, though it may change according to
OS version. At the time of writing, Homebrew targets Ruby 2.0 on OS X
Mavericks (10.9) and Yosemite (10.10), and Ruby 1.8.7 on older OS revisions.
So, our code must currently maintain compatibility across Ruby 1.8.7 and
2.0. The automated testing provided by Travis-CI will ensure that any pull
request will be tested under both versions.
## Mind the test suite!