--- rvm version 19 Tue Aug 23 06:09:02 -0700 2011
+++ rvm version 25 Fri May 11 06:38:15 -0700 2012
@@ -1,152 +1,121 @@
-RVM home page: http://rvm.beginrescueend.com
+RVM home page: https://rvm.io
Install RVM
------------
-See http://rvm.beginrescueend.com/rvm/install/
+See https://rvm.io/rvm/install/
- bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )
+ curl -L get.rvm.io | bash -s stable
-Install rvm for all users
---------------------------
+Update RVM
+----------
-Fairly complicated; make sure to read
-http://rvm.beginrescueend.com/deployment/system-wide/
+ rvm get latest
-Show all rubies and gemsets
----------------------------
+In case of problems try first with development version
+(maybe it's already fixed):
- rvm list gemsets
+ rvm get head
-Upgrade to the latest version of rvm from github
--------------------------------------------------
+Very old installations might not support those update methods, just run the
+installer and reopen your terminal.
- rvm update --head
+List known rubies
+-----------------
-Ruby on Rails 3 Tutorial says to follow this with
+ rvm list known
- rvm reload
- rvm install 1.8.7
- rvm install 1.9.2
-and, if you need a patchlevel, do something like
+Install Ruby dependencies
+-------------------------
- rvm install 1.8.7-p174
+Follow instructions from:
-Install a given version of ruby
---------------------------------
+ rvm requirements
- rvm install 1.9.2
+Install Ruby
+------------
-If this fails with compiler errors, you may need to install some packages.
+ rvm install 1.9.3 # Latest known patch level
+ rvm install 1.9.3 -j 3 # Parallel compile, set to # of CPU cores
+ rvm install 1.9.3 --patch falcon # Use a patch (falcon for performance)
+ rvm install 1.9.2-p318 # Patchlevel 318
+ rvm install rbx --1.9 # Rubinius with 1.9 mode set as default
- rvm package install openssl
- rvm package install readline
- rvm package install iconv
- rvm install 1.9.2 --with-openssl-dir=$HOME/.rvm/usr \
- --with-readline-dir=$HOME/.rvm/usr \
- --with-iconv-dir=$HOME/.rvm/usr
+List all rubies and gemsets
+---------------------------
-On Mac, you may need to install some libraries via MacPorts.
+ rvm list # List rubies only
+ rvm list gemsets # List rubies and gemsets
+ rvm gemset list # List gemsets for current ruby
- sudo port install ncurses
- sudo port install libyaml
- sudo port install zlib
- rvm install 1.9.2 --with-libyaml-dir=/opt/local \
- --with-openssl-dir=$HOME/.rvm/usr \
- --with-readline-dir=$HOME/.rvm/usr \
- --with-iconv-dir=$HOME/.rvm/usr
+Selecting Ruby for work
+-----------------------
-On Linux
+ rvm system # For system ruby, with fallback to default
+ rvm use jruby # For current session only
+ rvm use --default 1.9.3 # For current and new sessions
+ rvm use --ruby-version rbx # For current session and this project
- sudo apt-get install git-core git curl file \
- gcc make automake autoconf automake1.9 \
- binutils g++ g++-multilib checkinstall
- sudo apt-get install libssl-dev libxslt-dev libxml2-dev
- sudo apt-get install libcurl4-openssl-dev libmysql++-dev
- sudo apt-get install libpcre3 libpcre3-dev
+RVM will automatically use a ruby and gemset when you `cd` to a project
+directory.
-More at http://rvm.beginrescueend.com/rubies/installing/
+Read more on project files:
-Open a new shell and rvm!
--------------------------
+- https://rvm.io/workflow/projects/#ruby-versions
- rvm use 1.9.1
- >> Switching to ruby 1.9.1 ...
+Using ruby and gems
+-------------------
- ruby -v
- >> ruby 1.9.1p243 (2009-07-16 revision 24175) [x86_64-linux]
+After selecting Ruby work as usual:
- which ruby
- >> /home/wayne/.rvm/ruby-1.9.1-p243/bin/ruby
+ ruby -v
+ gem install haml
+ haml
-Make 1.9.2 default for all new shells
---------------------------------------
+Temporarily selecting another Ruby or gemset
+--------------------------------------------
- rvm --default 1.9.2
+ rvm 1.8.7 do gem install rspec # in the given ruby
+ rvm 1.8.7,1.9.2 do gem install haml # in this two rubies
+ rvm @global do gem install gist # in @global gemset of current ruby
-Reverting to system default
-----------------------------
+Gemsets
+-------
- rvm system
- ruby -v
- >> ruby 1.8.7 (2008-08-11 patchlevel 72) [universal-darwin10.0]
- which ruby
- >> /usr/bin/ruby
+RVM by default allows creating multiple environments for one ruby - called
+*gemsets*.
-Installing gems in multiple ruby versions
-------------------------------------------
+Gemsets can be specified together with ruby name using gemsets separator(@):
- rvm 1.8.6,1.9.1 gem install rspec json --no-rdoc --no-ri
+- ruby-1.9.3-p125@my-project
-Starting a new project? Create a Gemset and rvmrc at the same time:
--------------------------------------------------------------------
- rvm --create --rvmrc ree@project_name
+During installation of Ruby, RVM creates two gemsets:
-Working with gemsets
---------------------
+- default - automatically selected when no @gemset specified: rvm use 1.9.3
+- global - super gemset, inherited by all other gemsets for the given ruby
- rvm 1.8.7 # use the ruby to manage gemsets for
- rvm gemset create project_name # create a gemset
- rvm gemset use project_name # use a gemset in this ruby
- rvm gemset list # list gemsets in this ruby
- rvm gemset delete project_name # delete a gemset
- rvm 1.9.1@other_project_name # use another ruby and gemset
+Working with gemsets:
-The global gemset
------------------
+ rvm use 1.8.7 # use the ruby to manage gemsets for
+ rvm gemset create project_name # create a gemset
+ rvm gemset use project_name # use a gemset in this ruby
+ rvm gemset list # list gemsets in this ruby
+ rvm gemset delete project_name # delete a gemset
+ rvm 1.9.1@other_project_name # use another ruby and gemset
+ rvm 1.9.3@_project --create # use and create gemset if not existing
- With every ruby, rvm creates the global gemset. Gems installed into this
- gemset are available to all gemsets in the ruby.
+Install RVM for all users
+--------------------------
- rvm 1.8.7
- rvm gemset create project_name
- gem list # no gems :(
+Discouraged; make sure to read http://rvm.io/rvm/installation/
- rvm gemset use global
- gem install rake
- rvm gemset use project_name
- gem list # rake :)
+More help ?
+-----------
- Install a gem directly into the global gemset:
+A lot of resources is available:
- rvm 1.8.7@global gem install shoulda
-
- Install cheat in the global gemset when you install a new ruby:
-
- echo "cheat" >> ~/.rvm/gemsets/global.gems
-
-.rvmrc
-------
-
- rvm can automatically use a ruby and gemset when you cd to a project
- directory.
-
- echo "rvm 1.8.7@project_name" > ~/projects/project_name/.rvmrc
-
-Lots more help
----------------
-
- rvm help
- http://rvm.beginrescueend.com/
+- in your terminal: `rvm help`
+- https://rvm.io/
+- IRC #rvm @ freenode - http://webchat.freenode.net/?channels=#rvm
