ros(1) ros(1)
Roswell - Common Lisp environment setup Utility
Synopsis
* ros [options] [command [args...]
* ros [options] [--]script [args...]
* ros [options] < script.ros
Description
Roswell is a command line tool for installing and managing Common Lisp im-
plementations, as well as a scripting infrastructure for templating, writ-
ing, executing, compiling, distributing, downloading and installing
ROSWELL-SCRIPTS written in Common Lisp.
Currently roswell supports sbcl, ccl, clisp and ecl as its supported lisp
implementations. For further details see ros-install(1).
Scripts installed by roswell will be system wide if appropriate directory
is included in PATH.
Subcommands
In an order of utility/frequency.
install
Install a given implementation (e.g. sbcl, ccl) or a system
(e.g. alexandria) for roswell environment. See ros-install(1).
init [name[.ros]]
Create a new ros script. .ros is optional, and is added automati-
caly. See ros-init.
dump [executable|output] [script]
Dump an image of the script for the faster startup or to make an ex-
ecutable. See ros-dump.
build Make an executable from the script. See ros-build.
run Initiate REPL. See ros-run.
use Change the default implementation used by roswell. See ros-use.
list List the various informations. See ros-list.
config
Get and set the options. See ros-config.
setup Run the initial setup. See ros-setup.
emacs Launch emacs with slime. See ros-emacs.
wait Wait forever, used for daemonizing the script. See ros-wait.
delete
Delete an installed implementation. See ros-delete.
version
Show the roswell version information. See ros-version.
help Show the subcommand help.
Options
Options are processed in left-to-right order.
-w CODE -wrap CODE
Run the script with a shell wrapper CODE, e.g. rlwrap
-m IMAGE -image IMAGE
Continue from Lisp image IMAGE
-L NAME -lisp NAME
Run the script with a lisp impl NAME[/VERSION] if present,
e.g. sbcl-bin, sbcl/1.2.16. Fails otherwise.
-l FILE -load FILE
Load a lisp file FILE while building
-S X -source-registry X
Override the source registry of asdf systems.
-s SYSTEM -system SYSTEM
Load the asdf SYSTEM while building.
-load-system SYSTEM
Same as above (buildapp compatibility)
-p PACKAGE -package PACKAGE
Change the current package to PACKAGE
-sp SP -system-package SP
Combination of -s SP and -p SP
-e FORM -eval FORM
Evaluate FORM while building
-require MODULE
require MODULE while building
-q -quit
quit lisp here
-r FUNC -restart FUNC
the build image restarts from calling FUNC
-E FUNC -entry FUNC
the build image restarts from calling (FUNC argv).
-i FORM -init FORM
evaluate FORM after the restart.
-ip FORM -print FORM
evaluate and princ FORM after the restart
-iw FORM -write FORM
evaluate and write FORM after the restart
-F FORM -final FORM
evaluate FORM before dumping the IMAGE
-R -rc
try to read /etc/rosrc, ~/.roswell/init.lisp
+R -no-rc
skip /etc/rosrc, ~/.roswell/init.lisp
-Q -quicklisp
load quicklisp (default)
+Q -no-quicklisp
do not load quicklisp
-v -verbose
be quite verbose while building
-quiet
suppress output while building (default)
-test for test purpose
dynamic-space-size=[size in MB]
SBCL specific. The argument is passed to SBCL by --dy-
namic-space-size
Environmental Variables
ROSWELL_HOME
Specifies the home directory of roswell, defaulted to $HOME on Unix
platform .
Bugs
Check out issues list (https://github.com/roswell/roswell/issues)
SEE ALSO
sbcl(1) ros-dump(1) ros-init(1) ros-install(1) ros-list(1) ros-setup(1)
AUTHORS
Roswell Project Team.
ros(1)
Synopsis | Description | Subcommands | Options | Environmental Variables | Bugs | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ros&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>