Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Add documentation built into rvm for wrapper

  • Loading branch information...
commit ac985e162be1c9657f1690e0626ca55339f9eeb3 1 parent d2982a8
@Sutto Sutto authored
Showing with 47 additions and 1 deletion.
  1. +4 −0 README
  2. +41 −0 help/wrapper
  3. +2 −1  scripts/wrapper
View
4 README
@@ -59,6 +59,10 @@ Action
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.
+
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
View
41 help/wrapper
@@ -0,0 +1,41 @@
+
+∴ rvm wrapper [ruby_string] [wrapper_prefix] [binary[ binary[ ...]]]
+
+Where ruby_string is the ruby version and gemset combination to wrap,
+wrapper prefix is what to prepend to the name of the generated wrapper
+binaries and binaries is the names of the binaries you wish to provide
+a wrapper for (e.g. gem).
+
+When no binaries are provided, rvm will by default generate wrappers for
+ruby, gem, rake, irb, rdoc, ri, and testrb.
+
+Examples:
+
+If you wish to provide an environment-specific wrapper for rspec with a
+rails 3 gemset, you could do:
+
+ ∴ rvm --create ree@rails3
+ ∴ rvm wrapper ree@rails3 r3 spec
+
+Which would add r3_spec with the specified environment to your the bin
+directory where you installed rvm.
+
+Alternatively, if you do:
+
+ ∴ rvm wrapper ruby-1.9.2-head
+
+It will create binaries named ruby,gem, rake, irb, rdoc, ri and tesrb
+in the rvm bin directory.
+
+Finally, to show another real and common use, you can use wrapper
+to generate ruby executables and gems for passenger to use. Namely:
+
+ ∴ rvm use ree@rails3 --passenger
+
+is equivelant to:
+
+ ∴ rvm use ree@rails3
+ ∴ rvm wrapper ree@rails3 passenger
+
+Which creates passenger_* binaries in the rvm bin directory using
+ree and the rails3 gemset.
View
3  scripts/wrapper
@@ -20,7 +20,8 @@ wrap() {
usage() {
printf "Usage: 'rvm wrapper [ruby_string] [wrapper_prefix] [binary[ binary[ ...]]]'\n"
- printf " Where binary is in {ruby,gem,rake,irb,rdoc,ri,testrb}\n"
+ printf " Where binary defaults to ruby, gem, rake, irb, rdoc, ri, testrb\n"
+ printf " For more information, see 'rvm help wrapper'\n"
}
args="$*"
Please sign in to comment.
Something went wrong with that request. Please try again.