Skip to content
Browse files

Fixed missing item in history. Added UPGRADING.rdoc

  • Loading branch information...
1 parent ec2b2de commit 9efae6034a7115d2a88a9392073dfedbd5fe8e78 @zenspider zenspider committed Dec 31, 2010
Showing with 90 additions and 10 deletions.
  1. +2 −0 History.txt
  2. +1 −0 Manifest.txt
  3. +20 −10 README.rdoc
  4. +67 −0 UPGRADING.rdoc
View
2 History.txt
@@ -15,6 +15,8 @@ New features:
* Allow searching w/ file extensions: gem which fileutils.rb
* Progress indicator during download (Ryan Melton)
* Speed up Gem::Version#<=> by 2-3x in common cases. (raggi)
+* --source is now additive with your current sources.
+ Use --clear-sources first to maintain previous behavior.
Bug fixes:
View
1 Manifest.txt
@@ -7,6 +7,7 @@ LICENSE.txt
Manifest.txt
README.rdoc
Rakefile
+UPGRADING.rdoc
bin/gem
bin/update_rubygems
cruise_config.rb
View
30 README.rdoc
@@ -18,22 +18,32 @@ To upgrade to the latest RubyGems, run:
$ gem update --system # you might need to be an administrator or root
-NOTE: RubyGems 1.1 and 1.2 have problems upgrading when there is no
-rubygems-update installed. You will need to use the following instructions
-if you see "Nothing to update".
+See UPGRADING.rdoc for more details and alternative instructions.
-If you have an older version of RubyGems installed, then you can still
-do it in two steps:
+-----
- $ gem install rubygems-update # again, might need to be admin/root
- $ update_rubygems # ... here too
+NOTE: Ruby 1.9 ships with rubygems and contains a very buggy
+"gem-prelude". It is a gem loading system that can interfere with
+updating rubygems itself. We do NOT recommend you update to rubygems
+1.4 if you're running ruby 1.9.x until we get that sorted out in a
+future ruby release.
+
+If you absolutely hate kittens and you _must_ upgrade, you're going to
+have to do something really hokey like:
+
+% alias ruby19="ruby19 --disable-gems"
+% alias gem19="ruby19 --disable-gems -S gem"
+
+Even deleting the stock rubygems in 1.9 doesn't fix this situation.
+
+-----
If you don't have any RubyGems install, there is still the pre-gem approach to
getting software, doing it manually:
-1. Download from: http://rubyforge.org/frs/?group_id=126
-2. Unpack into a directory and cd there
-3. Install with: ruby setup.rb # you may need admin/root privilege
+* Download from: https://rubygems.org/pages/download
+* Unpack into a directory and cd there
+* Install with: ruby setup.rb # you may need admin/root privilege
For more details and other options, see:
View
67 UPGRADING.rdoc
@@ -0,0 +1,67 @@
+= How to upgrade Rubygems:
+
+== On Ruby 1.9.x:
+
+tl;dr: Just don't... for now.
+
+Ruby 1.9 ships with rubygems and contains a very buggy
+"gem-prelude". It is a gem loading system that can interfere with
+updating rubygems itself. We do NOT recommend you update to rubygems
+1.4 if you're running ruby 1.9.x until we get that sorted out in a
+future ruby release.
+
+If you absolutely hate kittens and you _must_ upgrade, you're going to
+have to do something really hokey like:
+
+ % alias ruby19="ruby19 --disable-gems"
+ % alias gem19="ruby19 --disable-gems -S gem"
+
+Even deleting the stock rubygems in 1.9 doesn't fix this situation.
+
+== On Ruby 1.8.x:
+
+=== From rubygems 1.3.x:
+
+Use the Normal Upgrade Recipe below.
+
+=== From rubygems 1-1.x to 1.2.x:
+
+RubyGems 1.1 and 1.2 have problems upgrading when there is no
+rubygems-update installed. You will need to use the following
+instructions if you see "Nothing to update".
+
+Use the Manual Upgrade Recipe below.
+
+=== From rubygems < 1.1.x:
+
+Use the Normal Upgrade Recipe below.
+
+== Upgrade Recipes
+
+=== Normal Upgrade
+
+Use sudo/su as appropriate:
+
+ $ gem update --system
+
+=== Manual Upgrade
+
+If you have an older version of RubyGems installed, then you can still
+do it in two steps:
+
+Use sudo/su as appropriate:
+
+ $ gem install rubygems-update
+ $ update_rubygems
+
+=== Manual Install
+
+If you don't have any RubyGems install, there is still the pre-gem
+approach to getting software, doing it manually:
+
+Use sudo/su as appropriate:
+
+* Download from: https://rubygems.org/pages/download
+* Unpack into a directory and cd there
+* Install with: ruby setup.rb
+

0 comments on commit 9efae60

Please sign in to comment.
Something went wrong with that request. Please try again.