1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
RUBY-BUILD(1)
=============
:doctype: manpage
NAME
----
ruby-build - utility to compile and install Rubies
SYNOPSIS
--------
*ruby-build* ['OPTIONS'...] 'DEFINITION' 'PREFIX'
*ruby-build --definitions*
*ruby-build --version*
*ruby-build* [*-h*|*--help*]
*rbenv install* ['OPTIONS'...] ['DEFINITION']
*rbenv install* [*-l*|*--list*]
*rbenv uninstall* [*-f*|*--force*] 'DEFINITION'
DESCRIPTION
-----------
*ruby-build* provides a simple way to compile and install different
versions of Ruby on UNIX-like systems.
ruby-build downloads, builds and installs the Ruby version specified
in a 'DEFINITION' into a 'PREFIX' directory. Definitions can be chosen
from the list of installed definitions or by specifying a file path
for a definition.
rbenv(1) users can also use the provided *rbenv install*
command, which installs Rubies into the `rbenv` directory.
OPTIONS
-------
*--definitions*::
List available definitions.
*-f*, *--force*::
When using *rbenv-install*, force installation of Ruby versions that
are already installed. When using *rbenv-uninstall*, uninstall
without prompting for confirmation or displaying an error message
for Rubies that are not currently installed.
*-k*, *--keep*::
Don't delete source code after installation.
*-p*, *--patch*::
Apply a patch from standard input to the Ruby, JRuby or Rubinius
source code before executing the `./configure` step.
*-v*, *--verbose*::
Display compiler messages on standard output.
*--version*::
Show `ruby-build` version and exit.
*-h*, *--help*::
Show usage information and exit.
EXAMPLES
--------
Install Ruby 2.0.0 (MRI, patch level 0) to `~/rubies/mri-2.0.0`:
ruby-build 2.0.0-p0 ~/rubies/mri-2.0.0
Install Ruby Enterprise Edition 1.8.7 (patch level 2011.03) for rbenv(1):
rbenv install ree-1.8.7-2011.03
Install local app-specific Ruby version:
rbenv install
Install Ruby from a custom definition into `~/your-ruby`:
rbenv install /path/to/your/own/ruby/definition ~/your-ruby
Install Ruby 2.0.0-p0, applying the patch in `/path/to/some.patch`:
rbenv install --patch 2.0.0-p0 < /path/to/some.patch
ENVIRONMENT
-----------
*CC*::
Sets the path to the C compiler.
*CONFIGURE_OPTS*::
Options that are passed to `./configure` when building a Ruby.
*MAKE*::
Sets the command used for `make`.
*MAKE_OPTS*::
Options that are passed to `make` when building a Ruby.
*MAKEOPTS*::
Used instead of *MAKE_OPTS* when *MAKE_OPTS* is not defined.
*RUBY_BUILD_BUILD_PATH*::
Sets the location in which sources are downloaded and built.
*RUBY_BUILD_CACHE_PATH*::
Sets the location where downloaded package files are cached.
*RUBY_BUILD_DEFINITIONS*::
Adds a colon-separated list of directories to the build definition
path.
*RUBY_BUILD_MIRROR_URL*::
Sets the root URL of the mirror from which package files are
downloaded.
*RUBY_BUILD_ROOT*::
If set, overrides the default location from where build definitions
in `share/ruby-build/` are looked up.
*RUBY_BUILD_SKIP_MIRROR*::
If set, forces `ruby-build` to download packages from their
original source URLs instead of using a mirror.
*RUBY_CFLAGS*::
Options that are added to the default `CFLAGS` when building a Ruby.
*RUBY_CONFIGURE_OPTS*::
Options that are passed to `./configure` when building a Ruby. In
contrast to *CONFIGURE_OPTS*, these are only passed to Ruby and not
to any dependent packages (such as `libyaml`).
*RUBY_MAKE_OPTS*::
Options that are passed to `make` when building a Ruby. In contrast
to *MAKE_OPTS*, these are only passed to Ruby and not to any
dependent packages (such as `libyaml`).
*TMPDIR*::
Sets the location where `ruby-build` stores temporary files.
AUTHORS
-------
ruby-build is developed by Sam Stephenson <\sam@37signals.com>.
This man page was written for the Debian GNU/Linux distribution by
Sebastian Boehm <\sebastian@sometimesfood.org> but may be used by
others.
SEE ALSO
--------
rbenv(1)
|
