rvm 1.0.0 → 1.0.1

data/README

@@ -17,7 +17,6 @@ Flags
   --docs        - with install, attempt to generate ri after installation.
   --reconfigure - Force ./configure on install even if Makefile already exists.
 
-
 Options
 
   -v|--version    - Emit rvm version loaded for current shell
@@ -41,58 +40,74 @@ Options
                     options then append them comma separated: -C --...,--...,--...
   --nice          - process niceness (for slow computers, default 0)
   --ree-options   - Options passed directly to ree's './installer' on the command line.
+  --with-rubies   - Specifies a string for rvm to attempt to expand for set operations.
 
 Action
 
-  * usage   - show this usage information
-  version   - show the rvm version installed in rvm_path
-  use       - setup current shell to use a specific ruby version
-  reload    - reload rvm source itself (useful after changing rvm source)
-  implode   - (seppuku) removes the rvm installation completely.
-              This means everything in $rvm_path (~/.rvm).
-              This does not touch your profiles, which is why
-              there is an if around the sourcing scripts/rvm.
-  update    - upgrades rvm to the latest version.
-              (If you experience bugs try this first with --head)
-  reset     - remove current and stored default & system settings.
-              (If you experience odd behavior try this second)
-  info      - show the *current* environment information for current ruby
-  debug     - show info plus additional information for common issues
-
-  install   - install one or many ruby versions
-              See also: http://rvm.beginrescueend.com/rubies/installing/
-  uninstall - uninstall one or many ruby versions, leaves their sources
-  remove    - uninstall one or many ruby versions and remove their sources
-
-  wrapper   - generates a set of wrapper executables for a given ruby with the
-              specified ruby and gemset combination. Used under the hood for
-              passenger support and the like.
-
-  cleanup   - Lets you remove stale source folders / archives and other miscellaneous
-              data associated with rvm.
-
-  ruby      - runs a named ruby file against specified and/or all rubies
-  gem       - runs a gem command using selected ruby's 'gem'
-  rake      - runs a rake task against specified and/or all rubies
-  tests     - runs 'rake test' across selected ruby versions
-  specs     - runs 'rake spec' across selected ruby versions
-  monitor   - Monitor cwd for testing, run `rake {spec,test}` on changes.
-
-  gemset    - gemsets: http://rvm.beginrescueend.com/gemsets/
-
-  gemdir    - display the path to the current gem directory (GEM_HOME).
-  srcdir    - display the path to rvm source directory (may be yanked)
-
-  fetch     - Performs an archive / src fetch only of the selected ruby.
-  list      - show currently installed rubies, interactive output.
-              http://rvm.beginrescueend.com/rubies/list/
-  package   - Install a dependency package {readline,iconv,zlib,openssl}
-              http://rvm.beginrescueend.com/packages/
-  notes     - Display notes, with operating system specifics.
-
-  snapshot  - Let's your backup / restore an rvm installation in a lightweight manner.
+  (Note that for most actions, 'rvm help action-name' may provide more information.)
+
+  * usage    - show this usage information
+  version    - show the rvm version installed in rvm_path
+  use        - setup current shell to use a specific ruby version
+  reload     - reload rvm source itself (useful after changing rvm source)
+  implode    - (seppuku) removes the rvm installation completely.
+               This means everything in $rvm_path (~/.rvm).
+               This does not touch your profiles, which is why
+               there is an if around the sourcing scripts/rvm.
+  update     - upgrades rvm to the latest version.
+               (If you experience bugs try this first with --head)
+  reset      - remove current and stored default & system settings.
+               (If you experience odd behavior try this second)
+  info       - show the *current* environment information for current ruby
+  debug      - show info plus additional information for common issues
+
+  install    - install one or many ruby versions
+               See also: http://rvm.beginrescueend.com/rubies/installing/
+  uninstall  - uninstall one or many ruby versions, leaves their sources
+  remove     - uninstall one or many ruby versions and remove their sources
+
+  migrate    - Lets you migrate all gemsets from one ruby to another.
+  upgrade    - Lets you upgrade from one version of a ruby to another, including
+               migrating your gemsets semi-automatically.
+
+  wrapper    - generates a set of wrapper executables for a given ruby with the
+               specified ruby and gemset combination. Used under the hood for
+               passenger support and the like.
+
+  cleanup    - Lets you remove stale source folders / archives and other miscellaneous 
+               data associated with rvm.
+  repair     - Lets you repair parts of your environment e.g. wrappers, env files and
+               and similar files (e.g. general maintenance).
+  snapshot   - Lets your backup / restore an rvm installation in a lightweight manner.
   
-  migrate   - Let's you migrate all gemsets from one ruby to another.
+  disk-usage - Tells you how much disk space rvm install is using.
+  tools      - Provides general information about the ruby environment,
+               primarily useful when scripting rvm.
+  docs       - Tools to make installing ri and rdoc documentation easier.
+  rvmrc      - Tools related to managing rvmrc trust and loading.
+
+  exec       - runs an arbitrary command as a set operation.
+  ruby       - runs a named ruby file against specified and/or all rubies
+  gem        - runs a gem command using selected ruby's 'gem'
+  rake       - runs a rake task against specified and/or all rubies
+  tests      - runs 'rake test' across selected ruby versions
+  specs      - runs 'rake spec' across selected ruby versions
+  monitor    - Monitor cwd for testing, run `rake {spec,test}` on changes.
+
+  gemset     - gemsets: http://rvm.beginrescueend.com/gemsets/
+
+  rubygems   - Lets you switch the installed version of rubygems for a given
+               1.8-compatible ruby.
+
+  gemdir     - display the path to the current gem directory (GEM_HOME).
+  srcdir     - display the path to rvm source directory (may be yanked)
+
+  fetch      - Performs an archive / src fetch only of the selected ruby.
+  list       - show currently installed rubies, interactive output.
+               http://rvm.beginrescueend.com/rubies/list/
+  package    - Install a dependency package {readline,iconv,zlib,openssl}
+               http://rvm.beginrescueend.com/packages/
+  notes      - Display notes, with operating system specifics.
 
 Implementation
 
@@ -109,9 +124,7 @@ Implementation
   default   - use rvm set default ruby and system if it hasn't been set.
               http://rvm.beginrescueend.com/rubies/default/
 
-
 Resources:
 
   http://rvm.beginrescueend.com/
   https://www.pivotaltracker.com/projects/26822
-

data/binscripts/rvm-auto-ruby

@@ -14,6 +14,6 @@ else
 fi
 
 [[ -s "$rvm_environments_path/default" ]] && source "$rvm_environments_path/default"
-rvm load-rvmrc > /dev/null 2>&1
+rvm rvmrc load > /dev/null 2>&1
 
 exec ruby "$@"

data/binscripts/rvm-shell

@@ -27,7 +27,7 @@ if [[ -n "$rvm_shell_rvm_path" ]]; then
         exit 1
       fi
   else
-    rvm load-rvmrc >/dev/null 2>&1
+    rvm rvmrc load >/dev/null 2>&1
   fi
 fi
 

data/contrib/install-system-wide

@@ -4,7 +4,7 @@ __rvm_system_wide_permissions() {
   [[ -z "$1" ]] && return 1
   chown -R root:"$rvm_group_name" "$1"
   chmod -R g+w "$1"
-  [[ -d "$1" ]] && find "$1" -type d | xargs -n1 chmod g+s
+  [[ -d "$1" ]] && find "$1" -type d -print0 | xargs -n1 -0 chmod g+s
 }
 
 # Require root to install it.
@@ -30,8 +30,8 @@ rvm_path="${rvm_path:-"/usr/local/rvm"}"
 export rvm_selfcontained=0
 
 rvm_group_name="${rvm_group_name:-"rvm"}"
-if cat /etc/group | cut -d: -f1 | \grep -q "^${rvm_group_name}$"; then
-  echo "Group exists, proceeding with installation."
+if \grep -q "${rvm_group_name}$" /etc/group ; then
+  echo "Group '$rvm_group_name' exists, proceeding with installation."
 else
   echo "Creating the group '$rvm_group_name'"
   groupadd -f "$rvm_group_name"

data/help/cleanup

@@ -0,0 +1,23 @@
+
+∴ rvm cleanup {all,archives,repos,sources,logs}
+
+Performs general cleanup for the specific set of rvm directories.
+
+Useful for reclaiming needlessly used disk space from rvm compiles
+and the like.
+
+Examples:
+
+To reclaim all of the space used by archives, repository clones,
+source files (and associated temporary compile file) and logs, you'd
+run:
+
+  ∴ rvm cleanup all
+
+If instead you only wanted to clean up source files, you'd run:
+
+  ∴ rvm cleanup sources
+
+Please note that sometimes have archives and sources around are desirable.
+Namely, you need the sources to install something such as ruby-debug under
+1.9.

data/help/disk-usage

@@ -0,0 +1,15 @@
+
+∴ rvm disk-usage {all,archives,repos,sources,logs,packages,rubies,gemsets}
+
+Returns the amount of disk space used by a specific set of data associated
+with rvm. All returns all of them individually plus the total space used.
+
+Examples:
+
+To find out how much space your rvm install is using, simply run:
+
+  ∴ rvm disk-usage all
+
+To find out how much space only your gemsets use, run:
+
+  ∴ rvm disk-usage gemsets

data/help/docs

@@ -0,0 +1,22 @@
+
+∴ rvm docs {generate,generate-ri,generate-rdoc}
+
+Generates ri and / or rdoc documentation for the current ruby.
+
+If you have the hanna gem installed, rdoc generation should automatically use it.
+Alternatively, you can pass the --docs flag to automatically call 'rvm docs generate'
+as part of the install process.
+
+Examples:
+
+  ∴ rvm docs generate
+
+Generates both ri and rdoc documentation for the current ruby.
+
+  ∴ rvm docs generate-ri
+
+Generates only ri documentation for the current ruby.
+
+  ∴ rvm docs generate-rdoc
+
+Generates only rdoc documentation for the current ruby.

data/help/exec

@@ -0,0 +1,33 @@
+
+∴ rvm exec some-command
+
+Executes arbitrary commands against rvm set operations. If given a set that
+matches a single ruby command, it will exec the command directly without printing
+out extra rvm information.
+
+Examples:
+
+To execute 'ruby -v' against all installed rubies and aliases, you would run:
+
+  ∴ rvm exec ruby -v
+
+If you instead want to execute it against a specific ruby (without extra logging
+/ data printed by rvm as is done with normal set operations), you can instead do:
+
+  ∴ rvm ree exec ruby -v
+
+Since it is a set operation, normal ruby specifiers will work. As an example, to run
+it against 1.9.2 and 1.8.7, you would run:
+
+  ∴ rvm 1.9.2,1.8.7 exec ruby -v
+
+Or, to execute 'gem env' against all gemsets:
+
+  ∴ rvm --with-rubies all-gemsets exec gem env
+
+To execute 'which ruby' in the current directory, loading a .rvmrc and falling back
+to the default ruby:
+
+  ∴ rvm --with-rubies default-with-rvmrc exec which ruby
+
+For more information, look up the rvm set operations.

data/help/migrate

@@ -0,0 +1,15 @@
+
+∴ rvm migrate from to
+
+Efficiently moves the gems from one ruby to another.
+Like 'rvm gemset copy' but removes the gems from the source
+ruby afterwards and runs it against all gemsets for a given
+ruby.
+
+Examples:
+
+To migrate all gemsets from rc2 of 1.9.2 to the first release, p0,
+you'd run:
+
+  ∴ rvm migrate 1.9.2-rc2 1.9.2-p0
+

data/help/repair

@@ -0,0 +1,23 @@
+
+∴ rvm repair {symlinks,environments,archives,all}
+
+Runs generate repair processes against given parts of rvm.
+
+Examples:
+
+To regenerate all of the environment files inside your rvm/environments
+directory, you'd run:
+
+  ∴ rvm repair environments
+
+To check for stale symlinks caused by rvm in your rvm_bin_path, you'd run:
+
+  ∴ rvm repair symlinks
+
+To verify all downloaded archives have the correct md5, you'd run:
+
+  ∴ rvm repair archives
+
+Or, to do all of the above, you'd run:
+
+  ∴ rvm repair all

data/help/rubygems

@@ -0,0 +1,11 @@
+
+∴ rvm rubygems [version]
+
+Installs a specific rubygems version in the current ruby. If
+current is specified, will install the most current rubygems
+as known by rvm.
+
+Please note that currently this is only compatible with ruby
+1.8.* and ruby enterprise edition. If your system isn't supported,
+running the command will generate an error message.
+

data/help/rvmrc

@@ -0,0 +1,34 @@
+
+∴ rvm rvmrc {trust,untrust,trusted,load,reset} [optional-path]
+
+Tools for dealing with and loading the rvmrc trust for a given directory.
+All actions take an optional path to a directory to check.
+
+Examples:
+
+To check the status of ~/My/project, you'd run:
+
+  ∴ rvm rvmrc trusted ~/My/project
+
+Or, more conventionally,
+
+  ∴ cd ~/My/project && rvm rvmrc trusted
+
+To manually set it as trusted:
+
+  ∴ rvm rvmrc trust ~/My/project
+
+Or, to reset the trust and force a prompt:
+
+  ∴ rvm rvmrc reset ~/My/project
+  
+Finally, to load the rvmrc in a directory, you'd run:
+
+  ∴ rvm rvmrc load ~/My/project
+
+Or,
+
+  ∴ cd ~/My/project && rvm rvmrc load
+  
+Note that this replaces 'rvm load-rvmrc'. Note that load implicity trusts the
+rvmrc, even if it is set to untrusted.

data/help/snapshot

@@ -0,0 +1,15 @@
+
+∴ rvm snapshot {load,save} filename
+
+Saves or creates a snapshot of the given rvm install. This includes:
+
+* Settings
+* Aliases
+* Rubies
+* Gemsets
+* Packages
+* Your Default
+
+Ideally to make it easy to have a consistent environment among machines
+/ to back up your environment. Please note that this is still considered
+experimental to a large degree.

data/help/tools

@@ -0,0 +1,22 @@
+
+∴ rvm tools {identifier,path-identifier,strings}
+
+Provides generic tools related to rvm environments for getting information
+about your current environment. Primarily used for scripting rvm.
+
+Examples:
+
+To get the expanded ruby string of the current environment, we'd run:
+
+  ∴ rvm tools identifier
+
+To get the identifier for a folder (taking into account rvmrc files and the like),
+we're instead run:
+
+  ∴ rvm tools path-identifier ~/path/to/directory
+
+Lastly, we can example ruby strings. E.g., to get the current ree version, we'd
+run:
+
+  ∴ rvm tools strings ree
+

data/help/upgrade

@@ -0,0 +1,18 @@
+
+∴ rvm upgrade ruby-prefix [optional-source]
+
+Attempts to install the latest version of a given ruby (still experimental).
+
+Given a ruby prefix (e.g. 1.9.2), it attempts to upgrade your last installed
+version, migrating gemsets.
+
+The process will prompt you at each stage - if the versions look incorrect,
+please cancel and perform it manually.
+
+Examples:
+
+If you have 1.9.2-rc2 installed and want to switch it to 1.9.2-p0,
+
+  ∴ rvm upgrade 1.9.2
+  
+Will install 1.9.2-p0 and migrate the gemsets.

data/install

@@ -1,5 +1,7 @@
 #!/usr/bin/env bash
 
+#set -u # Error on uninitialized variables.
+
 if [[ -z "$rvm_selfcontained" ]]; then
   if [[ "root" = "$(whoami)" ]] || [[ -n "$rvm_prefix" && "$rvm_prefix" != "$HOME"/* ]]; then
     export rvm_selfcontained=0
@@ -15,6 +17,8 @@ if [[ -d "$install_source_path/scripts" ]] && [[ -s "$install_source_path/script
   builtin cd "$install_source_path"
 fi
 
+sleep=0.010
+
 source scripts/version
 source scripts/utility
 
@@ -44,7 +48,7 @@ spinner() {
   index=$((($spinner_counter % 8)))
   printf "\r${array[$index]}"
   let "spinner_counter=spinner_counter+1"
-  command -v perl > /dev/null 2>&1 && perl -e 'sleep 0.5'
+  sleep $sleep
 }
 
 if echo "$*" | \grep -q 'trace' ; then echo "$*" ; env | \grep '^rvm_' ; set -x ; fi
@@ -54,7 +58,7 @@ while [[ $# -gt 0 ]] ; do
   case "$token" in
     --auto)    rvm_auto_flag=1 ;;
     --prefix)  rvm_prefix="$1" ; shift ;;
-    --version) rvm_path="$(pwd)" ; __rvm_version ; unset rvm_path ; exit ;;
+    --version) rvm_path="$PWD" ; __rvm_version ; unset rvm_path ; exit ;;
     --help|*)  usage ;;
   esac
 done
@@ -89,7 +93,7 @@ __rvm_initialize
 #
 item="$(tput setaf 2)* $(tput sgr0)"
 question="\n$(tput setaf 2)<?>$(tput sgr0)"
-cwd=$(pwd)
+cwd=$PWD
 source_path="${source_path:-$cwd}"
 rvm_archives_path="${rvm_archives_path:-"$rvm_path/archives"}"
 rvm_src_path="${rvm_src_path:-"$rvm_path/src"}"
@@ -161,7 +165,7 @@ done
 #
 # Cleanse and purge...
 for file in rvm-prompt rvm rvmsudo rvm-shell rvm-auto-ruby ; do
-  spinner && perl -e 'sleep 0.2'
+  spinner && sleep $sleep
   \rm -f "$rvm_bin_path/$file"
   \cp -f "$source_path/binscripts/$file" $rvm_bin_path/
 done
@@ -197,7 +201,7 @@ fi
 spinner
 if [[ -d gemsets/ ]] ; then
   \mkdir -p "$rvm_gemsets_path"
-  for gemset_file in $(cd gemsets ; find . -iname '*.gems' | sed 's/^\.\///') ; do
+  for gemset_file in $(cd gemsets ; find \. -iname '*.gems' | sed 's/^\.\///') ; do
     destination="$rvm_gemsets_path/$gemset_file"
     destination_path="$(dirname "$destination")"
     if [[ ! -s "$destination" ]] ; then
@@ -210,7 +214,7 @@ fi
 spinner
 if [[ -d patchsets/ ]] ; then
   \mkdir -p "$rvm_patchsets_path"
-  for patchset_file in $(cd patchsets ; find . -iname '*' | sed 's/^\.\///') ; do
+  for patchset_file in $(cd patchsets ; find \. -iname '*' | sed 's/^\.\///') ; do
     destination="$rvm_patchsets_path/$patchset_file"
     destination_path="$(dirname "$destination")"
     if [[ ! -s "$destination" ]] ; then
@@ -306,7 +310,7 @@ printf "\nThank you for using rvm. I hope that it makes your work easier and mor
 printf "\nIf you have any questions, issues and/or ideas for improvement please hop in #rvm on irc.freenode.net and let me know."
 printf "\nMy irc nickname is 'wayneeseguin' and I hang out from ~09:00-17:00EST and again from ~21:00EST-~00:00EST."
 printf "\nIf I do not respond right away, please hang around after asking your question, I will respond as soon as I am back."
-printf "\nBe sure to get head often as rvm development happens fast, you can do this by typing 'rvm update --head'."
+printf "\nBe sure to get head often as rvm development happens fast, you can do this by running 'rvm update --head'."
 printf "\n  w$(tput setaf 2)⦿‿⦿$(tput sgr0)t!"
 printf "\n    ~ Wayne\n"