The official documentation on the web http://docs.rubygems.org/read/book/2 should really be updated.