summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndre Arko <andre@arko.net>2010-02-16 01:36:05 -0800
committerAndre Arko <andre@arko.net>2010-02-16 01:36:05 -0800
commit4d27d8392180d4fa3d255d393e92e4aa30821ae0 (patch)
tree258bd1ea0f7f7a38fce07db2a9adee031804780a
parent849e4e6d6c513a1d77b67f08d0395d3dc671e6c1 (diff)
downloadbundler-4d27d8392180d4fa3d255d393e92e4aa30821ae0.tar.gz
More obvious Rails 2.3 instructions
-rw-r--r--README.markdown19
1 files changed, 11 insertions, 8 deletions
diff --git a/README.markdown b/README.markdown
index a9c596f31f..25d3490b89 100644
--- a/README.markdown
+++ b/README.markdown
@@ -184,11 +184,18 @@ so it can detect that all gems *together* require activesupport "2.3.4".
## Upgrading from Bundler 0.8 to 0.9 and above
-Bundler 0.9 changes a number of APIs in the Gemfile.
+Upgrading to Bundler 0.9 from Bundler 0.8 requires upgrading several
+API calls in your Gemfile, and some workarounds if you are using Rails 2.3.
+
+### Rails 2.3
+
+Using Bundler 0.9 with Rails 2.3 requires adding a preinitializer, and
+making a few changes to boot.rb. The exact changes needed can be found at
+[http://gist.github.com/302406](http://gist.github.com/302406).
### Gemfile Removals
-The following Bundler 0.8 APIs are no longer supported:
+Bundler 0.9 removes the following Bundler 0.8 Gemfile APIs:
1. `disable_system_gems`: This is now the default (and only) option
for bundler. Bundler uses the system gems you have specified
@@ -212,6 +219,8 @@ The following Bundler 0.8 APIs are no longer supported:
### Gemfile Changes
+Bundler 0.9 changes the following Bundler 0.8 Gemfile APIs:
+
1. Bundler 0.8 supported :only and :except as APIs for describing
groups of gems. Bundler 0.9 supports a single `group` method,
which you can use to group gems together. See the above "Group"
@@ -245,12 +254,6 @@ The following Bundler 0.8 APIs are no longer supported:
specify any groups, this puts all groups on the load
path. In locked, mode, it becomes `require '.bundle/environment'`
-### Rails 2.3
-
-Using Bundler 0.9 with Rails 2.3 requires adding a preinitializer, and
-making a few changes to boot.rb. The exact changes needed can be found at
-[http://gist.github.com/302406](http://gist.github.com/302406).
-
## More information
Explanations of common Bundler use cases can be found in [Using Bundler in Real Life](http://yehudakatz.com/2010/02/09/using-bundler-in-real-life/). The general philosophy behind Bundler 0.9 is explained at some length in [Bundler 0.9: Heading Toward 1.0](http://yehudakatz.com/2010/02/01/bundler-0-9-heading-toward-1-0/).