roswell.roswell/documents/html/ros-install.html

80 lines
3.7 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="generator" content="pandoc">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>ros-install(1)</title>
<style type="text/css">code{white-space: pre;}</style>
<link rel="stylesheet" href="ros.css">
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
</head>
<body>
<header>
<h1 class="title">ros-install(1)</h1>
<ul>
<li class="author">Roswell Project Team</li>
</ul>
</header>
<p>ros-install - Install lisp implementations or quicklisp system</p>
<h1>Synopsis</h1>
<p><strong>ros install</strong> [name]</p>
<!-- # subcommands -->
<dl>
<dt>name</dt>
<dd>a name specifying a lisp implementation/version, or a quicklisp system.
</dd>
</dl>
<h1>Installing a Lisp Implementation</h1>
<p>When the <code>name</code> matches to one of the supported implementations of roswell, it fetch and download the implementation. It is not automatically set as the default implementation to use. For setting the default lisp implementation, use <em>ros-use(1)</em>.</p>
<p>For example, the following command download the latest sbcl binary from sbcl.com. Note that this may be different freom the default binary installed by roswell, called <code>sbcl-bin</code>. <code>sbcl-bin</code> is a stable and well-tested version of the sbcl binary which is supposed to be a little older than the latest sbcl.</p>
<pre><code>$ ros install sbcl</code></pre>
<p>When invoked without a name, it prints the list of installable implementations. (Not to be confused with <code>ros list installed</code>, which shows the implementations already installed.)</p>
<pre><code>Usage: ros install impl [OPTIONS]
For more details on impl specific options, type:
ros help install impl
Candidates impls for installation are:
ecl
sbcl
clisp
ccl-bin
sbcl-bin</code></pre>
<p>The name can be a name of the implementation, or a version of the implementation prepended with the name separated by a slash (/). The ones ending with <code>-bin</code> ususally do not have these variants.</p>
<pre><code>$ ros install sbcl/1.2.14</code></pre>
<p>There might be some <em>hidden</em> implementation that are not listed here --- they are in the alpha quality, but try the one you like or watch the website (https://github.com/roswell/roswell).</p>
<pre><code>$ ros install ccl
$ ros install abcl
$ ...</code></pre>
<!-- # options -->
<!-- -->
<!-- # Environmental Variables -->
<h1>Installing a quicklisp system and the bundled roswell scripts</h1>
<p>If the specified name does not match any of the implementations, roswell tries to find a quicklisp system of the given name.</p>
<pre><code>$ ros install alexandria</code></pre>
<p>After compiling and loading the system, it funcalls <code>ros:*build-hook*</code> special variable with no argument, if some function is set during the compilation/load.</p>
<p>When the system comes with a <strong>roswell script</strong> created by <em><a href="ros-init.html">ros-init</a></em>(1) in the subdirectory <code>roswell</code>, the scripts are installed into <strong>ROSWELL_INSTALL_DIR/bin</strong>. Setting the path to this directory makes those scripts available from the shell command line.</p>
<pre><code>$ ros install qlot
System &#39;qlot&#39; found. Loading the system..
Processing build-hook..
Found 1 scripts: qlot
Attempting to install the scripts in roswell/ subdirectory of the system...
/home/user/.roswell/bin/qlot
$ qlot
Usage: qlot [install | update | bundle | exec shell-args..]</code></pre>
<h1>SEE ALSO</h1>
<p><em>sbcl</em>(1), <em><a href="ros.html">ros</a></em>(1), <em><a href="ros-list.html">ros-list</a></em>(1), <em><a href="ros-init.html">ros-init</a></em>(1)</p>
<p>_</p>
</body>
</html>