= Announce: RubyGems Release 0.9.1

Finally, the much anticipated RubyGems version 0.9.1 is now available.
This release includes a number of new features and bug fixes.

The most important change in RubyGems 0.9.1 is that RubyGems no  
longer allows files to be installed outside of the installation  
directory.  A separate security bulletin with full details will be  
posted shortly.

RubyGems 0.9.1 is a required update.  The RubyForge gem repository  
will soon disallow installation by older versions of RubyGems.   
Manual installation will still be allowed.

== Upgrade note

While require_gem was deprecated in 0.9.0, the bin stubs are still  
using it (oops!).  To get rid of the warnings printed by rake or  
other bin stubs simply run 'gem pristine --all'.

== Changes in RubyGems 0.9.1

Major changes include:

* RubyGems no longer allows installation of files outside the gem  
directory
* #require_gem will now print a warning, use #gem instead
* RubyGems now requires ruby 1.8.2 or greater
* RubyGems is -w clean

Minor changes include:

* gem command changes
   * new gem pristine command
   * new gem outdated command
   * new gem sources command
   * gem uninstall can uninstall multiple gems
   * gem install uses the cache instead of downloading
   * gem install returns non-zero exit code on failure
   * gem install can now set shebang on bin stubs (env or ruby)
   * gem help output now fits in 80 columns
* many proxy installation improvements
* gem cert improvements
* RubyGems is now easier to use as a library
   * Easier programatic installs
   * Easier inspection of local and remote gems
* extension building enhancements
* error reporting enhancements (less odd exceptions)
* require now loads .jar files

Bug fixes:

* installing from scratch fixed
* gem install --force forces
* installing from read-only location works
* gem uninstall requires full name
* gem install obeys GEM_HOME for bin scripts
* RubyGems now installs on ruby 1.9
* fixed issue with Gem::Specification#hash for JRuby
* RubyGems now installs RDoc and ri for itself
* RubyGems is now tab-free

== What is RubyGems?

RubyGems is a package management system for Ruby applications and
libraries. RubyGems' one command download makes installing Ruby software
fun and enjoyable again.

Many gems are available for download from the RubyForge site. Browse
the list of gems with a "gem list --remote" command and download what
you need with a simple "gem install <name-of-gem>". RubyGems takes care
of the details of installing, not only the gem you requested, but also
any gems needed by the software you selected.

== RubyGems Statistics

* About 1250 different gems are available from RubyForge
* Over 540 thousand downloads of the RubyGems software
* Over 8 million gem downloads

If you are interested in finding out when new gems are released, I
maintain an RSS feed at http://onestepback.org/gemwatch.rss.

== How can I get RubyGems?

If you have a recent version of RubyGems (0.8.5 or later), then all
you need to do is:

$ gem update --system # you might need to be admin/root
$ gem pristine --all # ... here too

(Note: You may have to run the command twice if you have any previosly
installed rubygems-update gems).

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
$ gem pristine --all # and here

If you don't have any gems 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 all (you may need admin/root privilege)

== What's Next

For RubyGems 0.9.2 the RubyGems team is looking to add:

* Integration of local and remote installation
* Automatic installation of platform-specific gems

== Thanks

Contributors to this release include:

Anatol Pomozov, Gavin Sinclair, David Lee, Ryan Davis, Robert James,  
Chris Morris, Sylvain Joyeux, Sava Chankov, Tom Pollard, Kevin Clark,  
Andy Shen.

Keep those gems coming!

-- Eric Hodel (for the RubyGems team)