CLISP
Section: User Commands (1)
Updated: 1 January 1995
Index
Return to Main Contents
NAME
clisp - Common Lisp language interpreter and compiler
SYNOPSIS
clisp
[
-h
]
[
-m
memsize
]
#ifndef NO_SP_MALLOC
[
-s
stacksize
]
#endif
#ifdef MULTIMAP_MEMORY_VIA_FILE
[
-t
tempdir
]
#endif
[
-M
memfile
]
[
-L
language
]
[
-q
]
[
-I
]
[
-i
initfile ...
]
[
-c
[
-l
]
lispfile
[
-o
outputfile
] ...
]
[
-x
expression
]
DESCRIPTION
Invokes the common lisp interpreter and compiler.
Invoked without arguments, executes a read-eval-print loop,
in which expressions are in turn read from standard input, evaluated
by the lisp interpreter, and their results output to standard output.
Invoked with
-c,
the specified lisp files are compiled to a bytecode that can be
executed more efficiently.
OPTIONS
- -h
-
Displays a help message on how to use
clisp.
- -m memsize
-
Sets the amount of memory
clisp
tries to grab on startup.
The amount may be given as
nnnnnnn
(measured in bytes),
nnnnK
or
nnnnKB
(measured in kilobytes) or
nM
or
nMB
(measured in megabytes).
#ifdef WIDE
Default is 4 megabytes.
#else
Default is 2 megabytes.
#endif
#if (oint_addr_len+addr_shift==24)
The argument is constrained between 100 KB and 16 MB.
#elif (oint_addr_len+addr_shift==26)
The argument is constrained between 100 KB and 64 MB.
#elif (oint_addr_len+addr_shift==28)
The argument is constrained between 100 KB and 256 MB.
#else
The argument is constrained above 100 KB.
#endif
#ifndef SPVW_MIXED_BLOCKS
-- This version of
clisp
allocates memory dynamically.
memsize
is essentially ignored.
#endif
#ifndef NO_SP_MALLOC
- -s stacksize
-
Sets the size of the stack
clisp
allocates for itself. The syntax is the same as for
memsize.
Default is one eighth of
memsize.
The argument is constrained between 40 KB and 8 MB.
#endif
#ifdef MULTIMAP_MEMORY_VIA_FILE
- -t tempdir
-
Specifies the directory where the temporary core file is to be held.
This option takes precedence over the environment variable
TMPDIR.
#endif
- -M memfile
-
Specifies the initial memory image.
This must be a memory dump produced by the
saveinitmem
function.
#ifdef UNIX
It may have been compressed using GNU gzip.
This option is normally already set by the shell script
/usr/local/bin/clisp.
#endif
- -L language
-
Specifies the language
clisp
uses to communicate with the user. This may be
english, deutsch, francais.
- -q
-
Quiet:
clisp
displays no banner at startup and no good-bye message when quitting.
- -I
-
ILISP friendly:
clisp
interacts in a way that ILISP (a popular Emacs LISP interface) can deal with.
Currently the only effect of this is that unnecessary prompts are not
suppressed.
- -i initfile ...
-
Specifies initialization files to be
loaded
at startup. These should be lisp files (source or compiled).
- -c lispfile ...
-
Compiles the specified
lispfiles
to bytecode. The compiled files
can then be
loaded
instead of the sources to gain efficiency.
- -o outputfile
-
Specifies the output file or directory for the compilation of the last
specified
lispfile.
- -l
-
A bytecode listing of the files being compiled will be produced.
Useful only for debugging purposes.
- -x expressions
-
Executes a series of arbitrary expressions instead of a read-eval-print loop.
The values of the expressions will be output to standard output.
Due to the argument processing done by the shell, the
expressions
must be enclosed in single quotes, and double quotes and backslashes must
be preceded by backslashes.
#ifdef EMUNIX
- @optionfile
-
substitutes the contents of
optionfile
as arguments. Each line of
optionfile
is treated as a separate argument to
clisp.
#endif
#ifdef AMIGAOS
WORKBENCH
Two kinds of tooltypes are supported:
- WINDOW= windowspec
-
clisp
will communicate with the console window or pipe specified by
windowspec.
- ARGS= arguments
-
Specifies the command line arguments for
clisp.
Within
arguments
the token `*' may be used to denote the project's filename.
arguments
defaults to `-i *' which means that the file will be
loaded
(see above).
#endif
REFERENCE
The language implemented conforms to
-
Guy L. Steele Jr.: Common Lisp - The Language.
Digital Press. 1st edition 1984, 465 pages.
("CLtL1" for short)
and to the older parts of
-
Guy L. Steele Jr.: Common Lisp - The Language.
Digital Press. 2nd edition 1990, 1032 pages.
("CLtL2" for short)
USE
- help
-
to get some on-line help.
- (apropos name)
-
lists the symbols relating to
name.
- (exit) or (quit) or (bye)
-
to quit
clisp.
#if defined(UNIX) || defined(MSDOS) || defined(AMIGAOS)
- #ifdef UNIX
-
EOF (Ctrl-D)
#endif
#ifdef MSDOS
EOF (Ctrl-Z)
#endif
#ifdef AMIGAOS
EOF (Ctrl-\)
#endif
to leave the current read-eval-print loop.
#endif
#ifdef GNU_READLINE
- arrow keys
-
for editing and viewing the input history.
- Tab key
-
to complete the symbol's name you are just typing.
#endif
FILES
#ifdef UNIX
- clisp
-
startup script
#endif
- #if defined(UNIX)
-
lisp.run
#endif
#if defined(MSDOS)
lisp.exe
#endif
#if defined(ATARI)
lisp.prg
#endif
#if defined(AMIGAOS)
lisp.run
#endif
main executable
- lispinit.mem
-
initial memory image
- config.lsp
-
site-dependent configuration
- *.lsp
-
lisp source
- *.fas
-
lisp code, compiled by
clisp
- *.lib
-
lisp source library information, generated and used by the
clisp
compiler
#ifdef HAVE_ENVIRONMENT
ENVIRONMENT
- CLISP_LANGUAGE
-
specifies the language
clisp
uses to communicate with the user. The value may be
english, deutsch, francais
and defaults to
english.
The
-L
option can be used to override this environment variable.
#ifdef UNIX
- HOME and USER
-
are used for determining the value of the function
user-homedir-pathname.
(Unix implementation only.)
#endif
#if defined(UNIX) || defined(MSDOS)
- #ifdef UNIX
-
SHELL (Unix implementation only)
is used to find the interactive command interpreter called by
(shell).
#endif
#ifdef MSDOS
COMSPEC (DOS, OS/2 implementations only)
is used to find the command interpreter called by the function
shell.
#endif
#endif
#ifdef UNIX
- TERM
-
determines the screen size recognized by the pretty printer.
This environment variable is also mandatory for the built-in screen editor.
#endif
#ifdef EMUNIX_PORTABEL
- TERM
-
specifies the terminal emulation
clisp
relies on. If you have ANSI.SYS loaded, possible values are
ansi,
ansi-color-2,
ansi-color-3
and
mono.
- TERMCAP
-
should be set to the slashified file name of the terminal capabilities database
termcap.dat.
#endif
#ifdef MULTIMAP_MEMORY_VIA_FILE
- TMPDIR (Sparc implementation only)
-
specifies the directory where the temporary core file is to be held.
#endif
#endif
SEE ALSO
cmulisp(1),
emacs(1).
BUGS
The function
inspect
is not implemented.
#ifdef SPVW_MIXED_BLOCKS
The memory management scheme is not very flexible.
#endif
Only very few extensions from CLtL2 are supported.
No on-line documentation beyond
apropos
and
describe
is available.
#ifdef EMUNIX
Stack overflow aborts the program ungracefully, with a register dump.
Pressing Control-C may not interrupt
clisp
in every situation.
Calling the function
execute
on batch files crashes the machine.
#endif
#ifdef UNIX_COHERENT
*keyboard-input*
does not recognize Ctrl-S and Ctrl-Q.
#endif
PROJECTS
Writing on-line documentation.
Building a foreign function interface (ability to call C code directly).
Write
inspect.
Enhance the compiler such that it can inline local functions.
Specify a portable set of window and graphics operations.
AUTHORS
Bruno Haible
<haible@ma2s2.mathematik.uni-karlsruhe.de>
and Michael Stoll.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- WORKBENCH
-
- REFERENCE
-
- USE
-
- FILES
-
- ENVIRONMENT
-
- SEE ALSO
-
- BUGS
-
- PROJECTS
-
- AUTHORS
-
This document was created by
man2html,
using the manual pages.
Time: 22:21:36 GMT, May 18, 2025