rvm.1 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390
  1. '\" t
  2. .\" Title: rvm
  3. .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
  4. .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
  5. .\" Date: 07/16/2010
  6. .\" Manual: [FIXME: manual]
  7. .\" Source: [FIXME: source]
  8. .\" Language: English
  9. .\"
  10. .TH "RVM" "1" "07/16/2010" "[FIXME: source]" "[FIXME: manual]"
  11. .\" -----------------------------------------------------------------
  12. .\" * set default formatting
  13. .\" -----------------------------------------------------------------
  14. .\" disable hyphenation
  15. .nh
  16. .\" disable justification (adjust text to left margin only)
  17. .ad l
  18. .\" -----------------------------------------------------------------
  19. .\" * MAIN CONTENT STARTS HERE *
  20. .\" -----------------------------------------------------------------
  21. .SH "NAME"
  22. rvm \- The Ruby Version Manager
  23. .SH "SYNOPSIS"
  24. .sp
  25. \fBrvm\fR [\fIFLAGS\fR] [\fIOPTIONS\fR] \fIACTION\fR [\fIIMPLEMENTATION\fR[,\fIIMPLEMENTATION\fR[,\fI\&...\fR]]
  26. .SH "DESCRIPTION"
  27. .sp
  28. RVM is a command line tool which allows us to easily install, manage and work with multiple ruby environments from interpreters to sets of gems\&.
  29. .SH "FLAGS"
  30. .PP
  31. \fB\-\-head\fR
  32. .RS 4
  33. with update, updates rvm to git head version\&.
  34. .RE
  35. .PP
  36. \fB\-\-rubygems\fR
  37. .RS 4
  38. with update, updates rubygems for selected ruby
  39. .RE
  40. .PP
  41. \fB\-\-default\fR
  42. .RS 4
  43. with ruby select, sets a default ruby for new shells\&.
  44. .RE
  45. .PP
  46. \fB\-\-debug\fR
  47. .RS 4
  48. Toggle debug mode on for very verbose output\&.
  49. .RE
  50. .PP
  51. \fB\-\-trace\fR
  52. .RS 4
  53. Toggle trace mode on to see EVERYTHING rvm is doing\&.
  54. .RE
  55. .PP
  56. \fB\-\-force\fR
  57. .RS 4
  58. Force install, removes old install & source before install\&.
  59. .RE
  60. .PP
  61. \fB\-\-summary\fR
  62. .RS 4
  63. Used with rubydo to print out a summary of the commands run\&.
  64. .RE
  65. .PP
  66. \fB\-\-latest\fR
  67. .RS 4
  68. with gemset \-\-dump skips version strings for latest gem\&.
  69. .RE
  70. .PP
  71. \fB\-\-gems\fR
  72. .RS 4
  73. with uninstall/remove removes gems with the interpreter\&.
  74. .RE
  75. .PP
  76. \fB\-\-docs\fR
  77. .RS 4
  78. with install, attempt to generate ri after installation\&.
  79. .RE
  80. .PP
  81. \fB\-\-reconfigure\fR
  82. .RS 4
  83. Force \&./configure on install even if Makefile already exists\&.
  84. .RE
  85. .SH "OPTIONS"
  86. .PP
  87. \fB\-v, \-\-version\fR
  88. .RS 4
  89. Emit rvm version loaded for current shell\&.
  90. .RE
  91. .PP
  92. \fB\-l, \-\-level\fR
  93. .RS 4
  94. patch level to use with rvm use / install
  95. .RE
  96. .PP
  97. \fB\-\-bin\fR
  98. .RS 4
  99. path for binaries to be placed (\fI~/\&.rvm/bin/\fR)
  100. .RE
  101. .PP
  102. \fB\-\-source\fR
  103. .RS 4
  104. src directory to use (\fI~/\&.rvm/src/\fR)
  105. .RE
  106. .PP
  107. \fB\-\-archives\fR
  108. .RS 4
  109. directory for downloaded files (\fI~/\&.rvm/archives/\fR)
  110. .RE
  111. .PP
  112. \fB\-S\fR
  113. .RS 4
  114. Specify a script file to attempt to load and run (rubydo)\&.
  115. .RE
  116. .PP
  117. \fB\-e\fR
  118. .RS 4
  119. Execute code from the command line\&.
  120. .RE
  121. .PP
  122. \fB\-G\fR
  123. .RS 4
  124. root gem path to use
  125. .RE
  126. .PP
  127. \fB\-\-gems\fR
  128. .RS 4
  129. Used to set the
  130. \fIgems_flag\fR, use with
  131. \fIremove\fR
  132. to remove gems\&.
  133. .RE
  134. .PP
  135. \fB\-\-archive\fR
  136. .RS 4
  137. Used to set the
  138. \fIarchive_flag\fR, use with
  139. \fIremove\fR
  140. to remove archive\&.
  141. .RE
  142. .PP
  143. \fB\-\-patch\fR, \fB\-\-patches\fR
  144. .RS 4
  145. With any ruby build from source, allows you to specify patch paths and patch names to be applied prior to building\&. Values should be a relative / absolute path to a patch or the name of known patch / patchset\&. Optionally, paths or names may be followed by
  146. \fI%someinteger\fR
  147. \- e\&.g\&.
  148. \fI\-\-patches mypatch%2\fR
  149. \- where the number following the % specifies the value of the \-p argument to patch, defaulting to two\&.
  150. .RE
  151. .PP
  152. \fB\-C, \-\-configure\fR
  153. .RS 4
  154. custom configure options\&. If you need to pass several configure options then append them comma separated:
  155. \fI\-C \-\-\&...,\-\-\&...,\-\-\&...\fR\&.
  156. .RE
  157. .PP
  158. \fB\-\-nice\fR
  159. .RS 4
  160. process niceness (for slow computers, default 0)
  161. .RE
  162. .PP
  163. \fB\-\-ree\-options\fR
  164. .RS 4
  165. Options passed directly to ree\(cqs
  166. \fI\&./installer\fR
  167. on the command line\&.
  168. .RE
  169. .SH "ACTIONS"
  170. .PP
  171. \fBversion\fR
  172. .RS 4
  173. Show the rvm version installed in rvm_path\&.
  174. .RE
  175. .PP
  176. \fBuse\fR
  177. .RS 4
  178. Setup current shell to use a specific ruby version\&.
  179. .RE
  180. .PP
  181. \fBreload\fR
  182. .RS 4
  183. Reload rvm source itself (useful after changing rvm source)\&.
  184. .RE
  185. .PP
  186. \fBdo\fR
  187. .RS 4
  188. Executes the command against either all or a listed subset of rubies. eg. rvm do gem --version ; rvm 1.8.7,1.9.2 do rake --version
  189. .RE
  190. .PP
  191. \fBenv\fR
  192. .RS 4
  193. Displays information about an environment specified but the given ruby string\&. Useful for getting a sourceable path or an evaluatable set of shell variable declarations\&.
  194. .RE
  195. .PP
  196. \fBimplode\fR
  197. .RS 4
  198. (seppuku) removes the rvm installation completely\&. This means everything in $rvm_path (\fI~/\&.rvm\fR)\&. This does not touch your profiles. However, this means that you must manually clean up your profiles and remove the lines which source RVM.
  199. \fIscripts/rvm\fR\&.
  200. .RE
  201. .PP
  202. \fBupdate\fR
  203. .RS 4
  204. Upgrades rvm to the latest version\&. (If you experience bugs try this first with \-\-head)\&.
  205. .RE
  206. .PP
  207. \fBget\fR
  208. .RS 4
  209. RVM get will 'get' the version you specify. This must be one of latest or head\&. With no arguments the rvm get help section will be shown.\&.
  210. .RE
  211. .PP
  212. \fBreset\fR
  213. .RS 4
  214. Remove current and stored default & system settings\&. (If you experience odd behavior try this second)\&.
  215. .RE
  216. .PP
  217. \fBinfo\fR
  218. .RS 4
  219. Show the
  220. \fBcurrent\fR
  221. environment information for current ruby\&.
  222. .RE
  223. .PP
  224. \fBdebug\fR
  225. .RS 4
  226. Show info plus additional information for common issues\&.
  227. .RE
  228. .PP
  229. \fBinstall\fR
  230. .RS 4
  231. Install one or many ruby versions\&.
  232. https://rvm\&.io/rubies/installing/
  233. .RE
  234. .PP
  235. \fBuninstall\fR
  236. .RS 4
  237. Uninstall one or many ruby versions, leaves their sources\&.
  238. .RE
  239. .PP
  240. \fBremove\fR
  241. .RS 4
  242. Uninstall one or many ruby versions and remove their sources\&.
  243. .RE
  244. .PP
  245. \fBwrapper\fR
  246. .RS 4
  247. 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\&.
  248. .RE
  249. .PP
  250. \fBruby\fR
  251. .RS 4
  252. Runs a named ruby file against specified and/or all rubies\&.
  253. .RE
  254. .PP
  255. \fBgem\fR
  256. .RS 4
  257. Runs a gem command using selected ruby\(cqs
  258. \fIgem\fR\&.
  259. .RE
  260. .PP
  261. \fBrake\fR
  262. .RS 4
  263. Runs a rake task against specified and/or all rubies\&.
  264. .RE
  265. .PP
  266. \fBtests\fR
  267. .RS 4
  268. Runs
  269. \fIrake test\fR
  270. across selected ruby versions\&.
  271. .RE
  272. .PP
  273. \fBspecs\fR
  274. .RS 4
  275. Runs
  276. \fIrake spec\fR
  277. across selected ruby versions\&.
  278. .RE
  279. .PP
  280. \fBmonitor\fR
  281. .RS 4
  282. Monitor cwd for testing, run
  283. \fIrake {spec,test}\fR
  284. on changes\&.
  285. .RE
  286. .PP
  287. \fBgemset\fR
  288. .RS 4
  289. gemsets:
  290. https://rvm\&.io/gemsets/
  291. .RE
  292. .PP
  293. \fBgemdir\fR
  294. .RS 4
  295. Display the path to the current gem directory (\fI$GEM_HOME\fR)\&.
  296. .RE
  297. .PP
  298. \fBsrcdir\fR
  299. .RS 4
  300. Display the path to rvm source directory (may be yanked)\&.
  301. .RE
  302. .PP
  303. \fBfetch\fR
  304. .RS 4
  305. Performs an archive / src fetch only of the selected ruby\&.
  306. .RE
  307. .PP
  308. \fBlist\fR
  309. .RS 4
  310. Show currently installed rubies, interactive output\&.
  311. https://rvm\&.io/rubies/list/
  312. .RE
  313. .PP
  314. \fBpackage\fR
  315. .RS 4
  316. Install a dependency package {readline,iconv,zlib,openssl}\&.
  317. https://rvm\&.io/packages/
  318. .RE
  319. .PP
  320. \fBrequirements\fR
  321. .RS 4
  322. Show additional OS specific dependencies/requirements for building various rubies.
  323. .RE
  324. .PP
  325. \fBnotes\fR
  326. .RS 4
  327. Display notes. Operating system specifics are now under 'requirements'\&.
  328. .RE
  329. .SH "IMPLEMENTATION"
  330. .PP
  331. \fBruby\fR
  332. .RS 4
  333. MRI/YARV Ruby (The Gold Standard) {1\&.8\&.x, 1\&.9\&.x, 2\&.0\&.x, 2\&.1\&.x, 2\&.2\&.x}
  334. .RE
  335. .PP
  336. \fBjruby\fR
  337. .RS 4
  338. JRuby, Ruby interpreter on the Java Virtual Machine\&.
  339. .RE
  340. .PP
  341. \fBrbx\fR
  342. .RS 4
  343. Rubinius
  344. .RE
  345. .PP
  346. \fBtruffleruby\fR
  347. .RS 4
  348. TruffleRuby, a high performance implementation of Ruby built on GraalVM\&.
  349. .RE
  350. .PP
  351. \fBree\fR
  352. .RS 4
  353. Ruby Enterprise Edition, MRI Ruby with several custom patches for performance, stability, and memory\&.
  354. .RE
  355. .PP
  356. \fBmacruby\fR
  357. .RS 4
  358. MacRuby, insanely fast, can make real apps (Mac OS X Only)\&.
  359. .RE
  360. .PP
  361. \fBmaglev\fR
  362. .RS 4
  363. GemStone Ruby, awesome persistent ruby object store\&.
  364. .RE
  365. .PP
  366. \fBironruby\fR
  367. .RS 4
  368. IronRuby, NOT supported yet\&. Looking for volunteers to help\&.
  369. .RE
  370. .PP
  371. \fBsystem\fR
  372. .RS 4
  373. Use the system ruby (eg\&. pre\-rvm state)\&.
  374. .RE
  375. .PP
  376. \fBdefault\fR
  377. .RS 4
  378. Use the default ruby (or the system ruby if a default hasn\(cqt been set)\&.
  379. https://rvm\&.io/rubies/default/
  380. .RE
  381. .SH "RESOURCES"
  382. .sp
  383. Main web site
  384. .sp
  385. Online issue\-tracker
  386. .SH "COPYING"
  387. .sp
  388. Copyright (c) 2009 Wayne E\&. Seguin
  389. .sp
  390. See LICENSE file for details\&.