1 '\" t |
|
2 .\"RubyGems is copyrighted free software by Chad Fowler, Rich Kilmer, Jim Weirich and others. |
|
3 .\" |
|
4 .\" CDDL HEADER START |
|
5 .\" |
|
6 .\" The contents of this file are subject to the terms of the |
|
7 .\" Common Development and Distribution License (the "License"). |
|
8 .\" You may not use this file except in compliance with the License. |
|
9 .\" |
|
10 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE |
|
11 .\" or http://www.opensolaris.org/os/licensing. |
|
12 .\" See the License for the specific language governing permissions |
|
13 .\" and limitations under the License. |
|
14 .\" |
|
15 .\" When distributing Covered Code, include this CDDL HEADER in each |
|
16 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. |
|
17 .\" If applicable, add the following below this CDDL HEADER, with the |
|
18 .\" fields enclosed by brackets "[]" replaced with your own identifying |
|
19 .\" information: Portions Copyright [yyyy] [name of copyright owner] |
|
20 .\" |
|
21 .\" CDDL HEADER END |
|
22 .\" |
|
23 .\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved. |
|
24 .\" |
|
25 .\" gem.1 |
|
26 .\" |
|
27 .TH gem 1 "16 December 2008" "" "" |
|
28 .SH NAME |
|
29 gem \-\- Command-line interface to RubyGems |
|
30 .SH SYNOPSIS |
|
31 .B gem |
|
32 .RB \-h | \-\-help |
|
33 .PP |
|
34 .B gem |
|
35 .RB \-v | \-\-version |
|
36 .PP |
|
37 .B gem |
|
38 .I command |
|
39 [ arguments\.\.\. ] |
|
40 [ options\.\.\. ] |
|
41 .SH DESCRIPTION |
|
42 A gem is a packaged Ruby application or library, while RubyGems is the premier ruby packaging system which is used to manage gems. |
|
43 |
|
44 Gems are managed on your computer using the |
|
45 .I gem |
|
46 command. You can install, remove, and query gem packages using the |
|
47 .I gem |
|
48 command. |
|
49 |
|
50 .SH FEATURES |
|
51 |
|
52 * Easy Installation and removal of RubyGems packages and their dependencies |
|
53 |
|
54 * Management and control of local packages |
|
55 |
|
56 * Package dependency management |
|
57 |
|
58 * Query, search and list local and remote packages |
|
59 |
|
60 * Multiple version support for installed packages |
|
61 |
|
62 * Web-based interface to view the documentation for your installed gems |
|
63 |
|
64 * Easy to use interface for building gem packages |
|
65 |
|
66 * Simple server for distributing your own gem packages |
|
67 |
|
68 .SH OPTIONS |
|
69 .TP |
|
70 \fB\-h | \-\-help\fP |
|
71 Get the basic help message for |
|
72 .I gem |
|
73 command. |
|
74 |
|
75 .TP |
|
76 \fB\-v | \-\-version\fP |
|
77 Get the version of |
|
78 .I gem |
|
79 command. |
|
80 |
|
81 .TP |
|
82 .I command |
|
83 .sp |
|
84 .ne 2 |
|
85 .mk |
|
86 \fBbuild\fP |
|
87 .in +16n |
|
88 .rt |
|
89 Build a gem from a gemspec |
|
90 .sp |
|
91 .sp 1 |
|
92 .in -16n |
|
93 .sp |
|
94 .ne 2 |
|
95 .mk |
|
96 \fBcert\fP |
|
97 .in +16n |
|
98 .rt |
|
99 Manage RubyGems certificates and signing settings |
|
100 .sp |
|
101 .sp 1 |
|
102 .in -16n |
|
103 .sp |
|
104 .ne 2 |
|
105 .mk |
|
106 \fBcheck\fP |
|
107 .in +16n |
|
108 .rt |
|
109 Check installed gems |
|
110 .sp |
|
111 .sp 1 |
|
112 .in -16n |
|
113 .sp |
|
114 .ne 2 |
|
115 .mk |
|
116 \fBcleanup\fP |
|
117 .in +16n |
|
118 .rt |
|
119 Clean up old versions of installed gems in the local repository |
|
120 .sp |
|
121 .sp 1 |
|
122 .in -16n |
|
123 .sp |
|
124 .ne 2 |
|
125 .mk |
|
126 \fBcontents\fP |
|
127 .in +16n |
|
128 .rt |
|
129 Display the contents of the installed gems |
|
130 .sp |
|
131 .sp 1 |
|
132 .in -16n |
|
133 .sp |
|
134 .ne 2 |
|
135 .mk |
|
136 \fBdependency\fP |
|
137 .in +16n |
|
138 .rt |
|
139 Show the dependencies of an installed gem |
|
140 .sp |
|
141 .sp 1 |
|
142 .in -16n |
|
143 .sp |
|
144 .ne 2 |
|
145 .mk |
|
146 \fBenvironment\fP |
|
147 .in +16n |
|
148 .rt |
|
149 Display information about the RubyGems environment |
|
150 .sp |
|
151 .sp 1 |
|
152 .in -16n |
|
153 .sp |
|
154 .ne 2 |
|
155 .mk |
|
156 \fBfetch\fP |
|
157 .in +16n |
|
158 .rt |
|
159 Download a gem and place it in the current directory |
|
160 .sp |
|
161 .sp 1 |
|
162 .in -16n |
|
163 .sp |
|
164 .ne 2 |
|
165 .mk |
|
166 \fBgenerate_index\fP |
|
167 .in +16n |
|
168 .rt |
|
169 Generates the index files for a gem server directory |
|
170 .sp |
|
171 .sp 1 |
|
172 .in -16n |
|
173 .sp |
|
174 .ne 2 |
|
175 .mk |
|
176 \fBhelp\fP |
|
177 .in +16n |
|
178 .rt |
|
179 Provide help on the 'gem' command |
|
180 .sp |
|
181 .sp 1 |
|
182 .in -16n |
|
183 .sp |
|
184 .ne 2 |
|
185 .mk |
|
186 \fBinstall\fP |
|
187 .in +16n |
|
188 .rt |
|
189 Install a gem into the local repository |
|
190 .sp |
|
191 .sp 1 |
|
192 .in -16n |
|
193 .sp |
|
194 .ne 2 |
|
195 .mk |
|
196 \fBlist\fP |
|
197 .in +16n |
|
198 .rt |
|
199 Display all gems whose name starts with STRING |
|
200 .sp |
|
201 .sp 1 |
|
202 .in -16n |
|
203 .sp |
|
204 .ne 2 |
|
205 .mk |
|
206 \fBoutdated\fP |
|
207 .in +16n |
|
208 .rt |
|
209 Display all gems that need updates |
|
210 .sp |
|
211 .sp 1 |
|
212 .in -16n |
|
213 .sp |
|
214 .ne 2 |
|
215 .mk |
|
216 \fBpristine\fP |
|
217 .in +16n |
|
218 .rt |
|
219 Restores gem directories to pristine condition from files located in the gem cache |
|
220 .sp |
|
221 .sp 1 |
|
222 .in -16n |
|
223 .sp |
|
224 .ne 2 |
|
225 .mk |
|
226 \fBquery\fP |
|
227 .in +16n |
|
228 .rt |
|
229 Query gem information in local or remote repositories |
|
230 .sp |
|
231 .sp 1 |
|
232 .in -16n |
|
233 .sp |
|
234 .ne 2 |
|
235 .mk |
|
236 \fBrdoc\fP |
|
237 .in +16n |
|
238 .rt |
|
239 Generates RDoc for pre-installed gems |
|
240 .sp |
|
241 .sp 1 |
|
242 .in -16n |
|
243 .sp |
|
244 .ne 2 |
|
245 .mk |
|
246 \fBsearch\fP |
|
247 .in +16n |
|
248 .rt |
|
249 Display all gems whose name contains STRING |
|
250 .sp |
|
251 .sp 1 |
|
252 .in -16n |
|
253 .sp |
|
254 .ne 2 |
|
255 .mk |
|
256 \fBserver\fP |
|
257 .in +16n |
|
258 .rt |
|
259 Documentation and gem repository HTTP server |
|
260 .sp |
|
261 .sp 1 |
|
262 .in -16n |
|
263 .sp |
|
264 .ne 2 |
|
265 .mk |
|
266 \fBsources\fP |
|
267 .in +16n |
|
268 .rt |
|
269 Manage the sources RubyGems will search for gems |
|
270 .sp |
|
271 .sp 1 |
|
272 .in -16n |
|
273 .sp |
|
274 .ne 2 |
|
275 .mk |
|
276 \fBspecification\fP |
|
277 .in +16n |
|
278 .rt |
|
279 Display gem specification (in yaml) |
|
280 .sp |
|
281 .sp 1 |
|
282 .in -16n |
|
283 .sp |
|
284 .ne 2 |
|
285 .mk |
|
286 \fBstale\fP |
|
287 .in +16n |
|
288 .rt |
|
289 List gems along with access times |
|
290 .sp |
|
291 .sp 1 |
|
292 .in -16n |
|
293 .sp |
|
294 .ne 2 |
|
295 .mk |
|
296 \fBuninstall\fP |
|
297 .in +16n |
|
298 .rt |
|
299 Uninstall gems from the local repository |
|
300 .sp |
|
301 .sp 1 |
|
302 .in -16n |
|
303 .sp |
|
304 .ne 2 |
|
305 .mk |
|
306 \fBunpack\fP |
|
307 .in +16n |
|
308 .rt |
|
309 Unpack an installed gem to the current directory |
|
310 .sp |
|
311 .sp 1 |
|
312 .in -16n |
|
313 .sp |
|
314 .ne 2 |
|
315 .mk |
|
316 \fBupdate\fP |
|
317 .in +16n |
|
318 .rt |
|
319 Update the named gem (or all installed gems) in the local repository |
|
320 .sp |
|
321 .sp 1 |
|
322 .in -16n |
|
323 .sp |
|
324 .ne 2 |
|
325 .mk |
|
326 \fBwhich\fP |
|
327 .in +16n |
|
328 .rt |
|
329 Find the location of a library file you can require |
|
330 .sp |
|
331 .sp 1 |
|
332 .in -16n |
|
333 .sp |
|
334 .ne 2 |
|
335 .mk |
|
336 For more detail help on a particular command with its arguments and options, |
|
337 using 'gem help |
|
338 .I command |
|
339 \'. |
|
340 |
|
341 For example: |
|
342 |
|
343 # gem help install |
|
344 |
|
345 .SH ENVIRONMENT |
|
346 .TP |
|
347 .B GEM_HOME |
|
348 Directory containing the master gem repository. |
|
349 |
|
350 .TP |
|
351 .B GEM_PATH |
|
352 Path list of directories containing gem repositories to be searched in addition to the GEM_HOME directory. The list should be delimited by the appropriate path separator ':' |
|
353 |
|
354 .TP |
|
355 .B GEM_SKIP |
|
356 List of gems should should not be loaded (normally used for development). The list should be delimited by the appropriate path separator ':' |
|
357 |
|
358 .TP |
|
359 .B http_proxy / HTTP_PROXY |
|
360 URL of the HTTP protocol proxy to be used to get out of the firewall. The lower case version will be used first. |
|
361 |
|
362 .TP |
|
363 .B make |
|
364 Name of the make program that should be used to build extensions. |
|
365 |
|
366 .TP |
|
367 .B HOME |
|
368 Home directory of the user (see below). |
|
369 |
|
370 .TP |
|
371 .B USERPROFILE |
|
372 Home directory of the user (used if HOME is not defined) |
|
373 |
|
374 .TP |
|
375 .B HOMEDRIVE |
|
376 Drive containing the user's home directory. |
|
377 |
|
378 .TP |
|
379 .B HOMEPATH |
|
380 Path to the user's home directory. |
|
381 |
|
382 .SH EXAMPLES |
|
383 .PP |
|
384 \fBExample 1: Install 'rake', either from local directory or remote server |
|
385 .PP |
|
386 .nf |
|
387 # gem install rake |
|
388 .fi |
|
389 .PP |
|
390 \fBExample 2: Install 'rake', only from remote server |
|
391 .PP |
|
392 .nf |
|
393 # gem install rake --remote |
|
394 .fi |
|
395 .PP |
|
396 \fBExample 3: Install 'rake' from remote server, and run unit tests, and generate RDocs |
|
397 .PP |
|
398 .nf |
|
399 # gem install --remote rake --test --rdoc --ri |
|
400 .fi |
|
401 .PP |
|
402 \fBExample 4: Install 'rake', but only version 0.3.1, even if dependencies are not met, and into a specific directory |
|
403 .PP |
|
404 .nf |
|
405 # gem install rake --version 0.3.1 --force --install-dir $HOME/.gems |
|
406 .fi |
|
407 .PP |
|
408 \fBExample 5: List local gems whose name begins with 'D' |
|
409 .PP |
|
410 .nf |
|
411 # gem list D |
|
412 .fi |
|
413 .PP |
|
414 \fBExample 6: List local and remote gems whose name contains 'log' |
|
415 .PP |
|
416 .nf |
|
417 # gem search log --both |
|
418 .fi |
|
419 .PP |
|
420 \fBExample 7: List only remote gems whose name contains 'log' |
|
421 .PP |
|
422 .nf |
|
423 # gem search log --remote |
|
424 .fi |
|
425 .PP |
|
426 \fBExample 8: Uninstall 'rake' |
|
427 .PP |
|
428 .nf |
|
429 # gem uninstall rake |
|
430 .fi |
|
431 .PP |
|
432 \fBExample 9: See information about RubyGems |
|
433 .PP |
|
434 .nf |
|
435 # gem environment |
|
436 .TE |
|
437 .sp |
|
438 .SH SEE ALSO |
|
439 \fBruby\fR(1) |
|
440 .sp |
|
441 .SH FILES |
|
442 The following files specify the installation locations for Ruby: |
|
443 .PP |
|
444 .TP |
|
445 /var/ruby/1.8/gem_home |
|
446 Contains the Rubygems repository. Configure the GEM_HOME environment variable to point to /var/ruby/1.8/gem_home as the installation of Rubygems repository. |
|
447 .PP |
|
448 .TP |
|
449 /var/ruby/1.8/gem_home/bin |
|
450 Contains executables for any installed gems that supply them (i.e.: thin, rake, rails, etc). Only exists after a gem with an executable has been installed. |
|
451 .PP |
|
452 .TP |
|
453 ~/.gem/ruby/1.8 |
|
454 Location that gems will be installed to if /var/ruby/1.8/gem_home is not writable by the user. This is automatically added to GEM_PATH. |
|
455 .PP |
|
456 .TP |
|
457 ~/.gem/ruby/1.8/bin |
|
458 Location that executables for gems will be installed to if /var/ruby/1.8/gem_home/bin is not writable by the user. |
|
459 .PP |
|
460 .TP |
|
461 /usr/ruby/1.8/bin |
|
462 Contains the Rubygems programs with all other Ruby related programs. These programs are linked from /usr/bin. |
|
463 For example: /usr/ruby/1.8/bin/gem is linked from /usr/bin/gem18, and may be linked from /usr/bin/gem if 1.8 is the latest version of Ruby installed on this system. |
|
464 .PP |
|
465 .\" Begin Oracle update |
|
466 .SH NOTES |
|
467 Source code for RubyGems is available on http://opensolaris.org |
|
468 |
|
469 Detailed documentation for RubyGems is available at http://docs.rubygems.org/ |
|