mirror of
https://github.com/roswell/roswell.git
synced 2026-09-10 07:16:17 -04:00
122 lines
3 KiB
Groff
122 lines
3 KiB
Groff
.\" Automatically generated by Pandoc 2.5
|
|
.\"
|
|
.TH "ros-install" "1" "" "" ""
|
|
.hy
|
|
.PP
|
|
ros\-install \- Install lisp implementations or quicklisp system
|
|
.SH Synopsis
|
|
.IP \[bu] 2
|
|
\f[B]ros install\f[R] system [system \&...]
|
|
.IP \[bu] 2
|
|
\f[B]ros install\f[R] impl[/version] [param \&...]
|
|
.SH Description
|
|
.TP
|
|
.B system
|
|
a name specifying a system.
|
|
.TP
|
|
.B impl
|
|
a name specifying a lisp implementation.
|
|
.SH Installing a Lisp Implementation
|
|
.PP
|
|
When the \f[C]impl\f[R] or \f[C]system\f[R] matches to one of the
|
|
supported implementations, it fetches, downloads and installs it to one
|
|
of the internal directory managed by roswell (\[ti]/.roswell, or
|
|
\f[C]ROSWELL_INSTALL_DIR\f[R]).
|
|
In order to use the installed implementation, you have to run
|
|
\f[I]ros\-use(1)\f[R].
|
|
.PP
|
|
For example, the following command downloads the latest sbcl binary from
|
|
sbcl.org.
|
|
Note that this may be different from the default binary installed by
|
|
roswell, called \f[C]sbcl\-bin\f[R].
|
|
\f[C]sbcl\-bin\f[R] is a stable and well\-tested version of the sbcl
|
|
binary which is supposed to be a little older than the latest sbcl.
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
$ ros install sbcl
|
|
\f[R]
|
|
.fi
|
|
.PP
|
|
When invoked without a name, it prints the list of installable
|
|
implementations.
|
|
(Not to be confused with \f[C]ros list installed\f[R], which shows the
|
|
implementations already installed.)
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
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
|
|
\f[R]
|
|
.fi
|
|
.PP
|
|
The name can be optionally followed by a slash \f[C]/\f[R] and a version
|
|
of the implementation.
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
$ ros install sbcl/1.2.14
|
|
\f[R]
|
|
.fi
|
|
.PP
|
|
There might be some \f[I]hidden\f[R] implementation that are not listed
|
|
here \[em] they are in the alpha quality, but try the one you like or
|
|
watch the website (https://github.com/roswell/roswell).
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
$ ros install ccl
|
|
$ ros install abcl
|
|
$ ...
|
|
\f[R]
|
|
.fi
|
|
.SH Installing a quicklisp system and the bundled roswell scripts
|
|
.PP
|
|
If the specified name does not match any of the implementations, roswell
|
|
tries to find a quicklisp system of the given name.
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
$ ros install alexandria
|
|
\f[R]
|
|
.fi
|
|
.PP
|
|
After compiling and loading the system, it funcalls
|
|
\f[C]ros:*build\-hook*\f[R] special variable with no argument, if some
|
|
function is set during the compilation/load.
|
|
.PP
|
|
When the system comes with a \f[B]roswell script\f[R] created by
|
|
\f[I]ros\-init\f[R](1) in the subdirectory \f[C]roswell\f[R], they are
|
|
installed into \f[B]ROSWELL_INSTALL_DIR/bin\f[R].
|
|
Setting the path to this directory makes those scripts available from
|
|
the shell command line.
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
$ ros install qlot
|
|
System \[aq]qlot\[aq] 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..]
|
|
\f[R]
|
|
.fi
|
|
.SH SEE ALSO
|
|
.PP
|
|
\f[I]sbcl\f[R](1), \f[I]ros\f[R](1), \f[I]ros\-list\f[R](1),
|
|
\f[I]ros\-init\f[R](1)
|
|
.SH AUTHORS
|
|
Roswell Project Team.
|