Document .ruby-version

This commit is contained in:
Sam Stephenson 2012-12-31 09:58:28 -06:00
parent d2a8ca7d89
commit 377b176260

View file

@ -235,7 +235,7 @@ first argument. The most common subcommands are:
Sets the global version of Ruby to be used in all shells by writing Sets the global version of Ruby to be used in all shells by writing
the version name to the `~/.rbenv/version` file. This version can be the version name to the `~/.rbenv/version` file. This version can be
overridden by a per-project `.rbenv-version` file, or by setting the overridden by a per-project `.ruby-version` file, or by setting the
`RBENV_VERSION` environment variable. `RBENV_VERSION` environment variable.
$ rbenv global 1.9.3-p327 $ rbenv global 1.9.3-p327
@ -249,7 +249,7 @@ currently configured global version.
### rbenv local ### ### rbenv local ###
Sets a local per-project Ruby version by writing the version name to Sets a local per-project Ruby version by writing the version name to
an `.rbenv-version` file in the current directory. This version a `.ruby-version` file in the current directory. This version
overrides the global, and can be overridden itself by setting the overrides the global, and can be overridden itself by setting the
`RBENV_VERSION` environment variable or with the `rbenv shell` `RBENV_VERSION` environment variable or with the `rbenv shell`
command. command.
@ -261,6 +261,11 @@ configured local version. You can also unset the local version:
$ rbenv local --unset $ rbenv local --unset
Previous versions of rbenv stored local version specifications in a
file named `.rbenv-version`. For backwards compatibility, rbenv will
read a local version specified in an `.rbenv-version` file, but a
`.ruby-version` file in the same directory will take precedence.
### rbenv shell ### ### rbenv shell ###
Sets a shell-specific Ruby version by setting the `RBENV_VERSION` Sets a shell-specific Ruby version by setting the `RBENV_VERSION`
@ -289,7 +294,7 @@ the currently active version.
$ rbenv versions $ rbenv versions
1.8.7-p352 1.8.7-p352
1.9.2-p290 1.9.2-p290
* 1.9.3-p327 (set by /Users/sam/.rbenv/global) * 1.9.3-p327 (set by /Users/sam/.rbenv/version)
jruby-1.7.1 jruby-1.7.1
rbx-1.2.4 rbx-1.2.4
ree-1.8.7-2011.03 ree-1.8.7-2011.03
@ -300,7 +305,7 @@ Displays the currently active Ruby version, along with information on
how it was set. how it was set.
$ rbenv version $ rbenv version
1.8.7-p352 (set by /Volumes/37signals/basecamp/.rbenv-version) 1.8.7-p352 (set by /Volumes/37signals/basecamp/.ruby-version)
### rbenv rehash ### ### rbenv rehash ###