85 lines
2.0 KiB
Groff
85 lines
2.0 KiB
Groff
.TH LSCSH 1
|
|
.\" File scsh.man: Manual page template for scsh.
|
|
.\" Replace LSCSH with the name of your default image and LLIB with the
|
|
.\" directory containing scshvm and default image.
|
|
.SH NAME
|
|
LSCSH \- a Scheme shell
|
|
|
|
.SH SYNOPSIS
|
|
.B LSCSH
|
|
[switch arg1 ... argn]
|
|
|
|
.SH DESCRIPTION
|
|
.B LSCSH
|
|
is an implementation of the Scheme shell.
|
|
It is implemented as
|
|
a heap image which is interpreted by a modified version of
|
|
the Scheme 48 virtual machine.
|
|
.B LSCSH
|
|
is a stub program that starts the virtual machine on the scsh heap image.
|
|
.PP
|
|
The
|
|
.B LSCSH
|
|
command loop reads Scheme expressions,
|
|
evaluates them, and prints their results.
|
|
The Scheme 48 system is an R5RS system.
|
|
It also executes commands, which are identified by an initial comma character.
|
|
Type the command
|
|
.I ,help
|
|
to receive a list of available commands, or see the documentation for
|
|
Scheme 48.
|
|
.PP
|
|
Scsh's
|
|
.I switch
|
|
argument can be one of
|
|
.LP
|
|
.B \-s
|
|
.BI script
|
|
.LP
|
|
.B \-\-
|
|
.LP
|
|
Either of these switches terminates argument parsing; following arguments
|
|
are available from scsh as the string list produced by
|
|
.nf
|
|
(command-line)
|
|
.fi
|
|
The
|
|
.B \-s
|
|
.BI script
|
|
switch causes scsh to run in batch mode,
|
|
first loading the script and then exiting.
|
|
The default error exception handler terminates the process.
|
|
|
|
If the
|
|
.B \-s
|
|
switch is not specified, scsh operates in interactive mode.
|
|
It invokes the Scheme 48 top-level read-eval-print loop,
|
|
from which the user can enter forms to be evaluated.
|
|
In interactive mode, the default error handler invokes an interactive
|
|
debugging breakpoint.
|
|
|
|
The
|
|
.B \-\-
|
|
switch is used to pass arguments to an interactive scsh.
|
|
It simply terminates argument parsing, causing following
|
|
arguments to be made available by
|
|
.nf
|
|
(command-line)
|
|
|
|
There are other command-line switches. For detailed documentation,
|
|
see the manual, which comes with the distribution.
|
|
|
|
.SH FILES
|
|
.TP
|
|
.B LLIB/doc/
|
|
The detailed documentation for scsh.
|
|
|
|
.TP
|
|
.B LLIB/scshvm
|
|
the virtual machine.
|
|
.TP
|
|
.B LLIB/LSCSH.image
|
|
the default image.
|
|
.SH BUGS
|
|
Too big; starts up too slowly.
|