![[CLISP home]](clisp.png){kind=small}
CLISP -
ANSI Common Lisp compiler, interpreter and debugger.
clisp
[ -h |
--help ]
[ --version ]
[ --license ]
[ -B lisplibdir ]
#if defined(UNIX) || defined(WIN32_NATIVE)
[ -K linking-set ]
#endif
[ -M memfile ]
[ -m memsize ]
#ifndef NO_SP_MALLOC
[ -s stacksize ]
#endif
#ifdef MULTIMAP_MEMORY_VIA_FILE
[ -t tempdir ]
#endif
[ -L language ]
[ -N localedir ]
[ -Edomain
encoding ]
[ -q |
--quiet |
--silent |
-v |
--verbose ]
[ -interactive-debug ]
[ -repl ]
[ -w ]
[ -I ]
[ -ansi ]
[ -traditional ]
[ -p packagename ]
[ -C ]
[ -norc ]
[ -i initfile ... ]
[ -c
[ -l ]
lispfile
[ -o outputfile ] ... ]
[ -x expressions ]
[ lispfile
[ argument ... ] ]
Invokes the Common Lisp interpreter and compiler.
Invoked without arguments, executes the 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, compiles
the specified lisp files to a bytecode that can be executed
more efficiently.
-h,
--helpclisp.--versionclisp version number,
as given by the function call
(lisp-implementation-version)
and the values of the variable
*features*.--license-B
lisplibdirclisp executable.
#endif
Directory lisplibdir can be changed dynamically using the
symbol-macro *lib-directory*.
-K
linking-setbase, full.
The default is base.
-M
memfilesaveinitmem function by
this clisp runtime.
#ifdef UNIX
It may have been compressed using GNU
gzip.
#endif
-m
memsizeclisp tries to grab on startup.
The amount may be given as
K or
nnnn KB (measured in kilobytes) orM or
n MB (measured in megabytes).clisp
#if defined(SPVW_MIXED) && defined(SPVW_BLOCKS)
#ifdef GENERATIONAL_GC
is not likely to actually use the entire memsize
since garbage collection will periodically reduce the amount of used memory.
It is therefore common to specify 10 MB even if only 2 MB are going to be used.
#else
eventually uses the entire memsize.
#endif
#else
allocates memory dynamically.
memsize is essentially ignored.
#endif
-s
stacksizeclisp 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.
-t
tempdirTMPDIR.
-L
languageclisp
uses to communicate with the user.
This may be
#ifndef GNU_GETTEXT
english.
#endif
#ifdef GNU_GETTEXT
english, german, french,
spanish, dutch, russian.
Other languages may be specified through the environment variable
LANG,
provided the corresponding message catalog is installed.
#endif
The language may be changed dynamically using the symbol macro
*current-language*,
-N
localedirclisp
will search its message catalogs in
localedir/language/LC_MESSAGES/clisp.mo.
This directory may be changed dynamically using the symbol macro
*current-language*,
-Edomain
encodingLC_ALL,
LC_CTYPE, LANG. domain can be
file,*default-file-encoding*, orpathname,*pathname-encoding*, orterminal,*terminal-encoding*, orforeign,*foreign-encoding*, ormisc,*misc-encoding*.-q,
--quiet,
--silent,
-v,
--verboseclisp
displays a banner at startup and a good-bye message when quitting,
and initializes
*load-verbose* and
*compile-verbose*
to t, and
*load-print* and
*compile-print*
to nil, as per the ANSI CL standard.
The first -q removes the banner and the good-bye message,
the second sets variables *load-verbose*
and *compile-verbose* to nil.
-v sets variables *load-print*
and *compile-print* to t.
Repeated -q and -v cancel each other, i.e.,
-q -q -v -v -v is equivalent to -v.
Note that these settings persists into the read-eval-print loop.-interactive-debug-c,
-x, and
lispfile
and allow interactive handling of ASSERT and friends.-repl-c,
-x, and
lispfile
options.-w-Iclisp
interacts in a way that ILISP can deal with.
Currently the only effect of this is that unnecessary prompts are not
suppressed.
#ifdef GNU_READLINE
Furthermore, the
GNU
readline library treats
Tab as a normal self-inserting character,
so you should always use this option when you invoke CLISP from Emacs.
#endif
-ansiclisp has been traditionally different.
It sets the symbol macro *ansi* to t.
See "Maximum ANSI CL compliance"
for details.-traditional-ansi
in the saved image.-p
packagename*package* will
be set to the package named packagename.
The default is the package which was active when the image was
saved, normally
COMMON-LISP-USER.-C*load-compiling*
will be set to t.
Code being loaded will then be compiled on the fly.
This results in slower loading, but faster execution.-norcclisp loads a user run control (RC) file on
startup (this happens after the -C
option is processed).
The file loaded is
#if defined(PATHNAME_OS2) || defined(PATHNAME_WIN32) || defined(PATHNAME_RISCOS)
_clisprc.lisp or _clisprc.fas in the home directory
(user-homedir-pathname),
#endif
#if defined(PATHNAME_AMIGAOS)
.clisprc.lisp or .clisprc.fas in the home directory
(user-homedir-pathname),
#endif
#if defined(PATHNAME_UNIX)
${HOME}/.clisprc.lisp or ${HOME}/.clisprc.fas,
#endif
whichever is newest. This option, -norc, prevents loading of
the RC file.-i
initfile ...loaded
at startup. These should be lisp files (source or compiled).
Several -i options can be given; all the specified
files will be loaded in order.-c
lispfile ...loaded instead of the sources to
gain efficiency.-o
outputfile-lcompile-file
for details.-x
expressions*args*
will be bound to a list of strings, representing the arguments.
#ifdef UNIX
The first line of lispfile may start with #!,
thus permitting clisp to be used as a script interpreter.
#endif
If lispfile is -,
the standard input is used instead of a file.
If lispfile is the empty string "" or "--"
the rest of the arguments is still available in *args*,
for parsing by the init-function
of the current image.
This option must be the last one.
No RC file will be executed.@optionfileclisp.Two kinds of tooltypes are supported:
WINDOW=windowspecclisp
will communicate with the console window or pipe specified by
windowspec.ARGS=argumentsclisp.
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).The language implemented mostly conforms to
ANSI Common Lisp standard X3.226-1994
available online as the
Common Lisp HyperSpec ("CLHS" for short)
which supersedes the earlier specifications
Guy L. Steele Jr.: Common Lisp - The Language. Digital Press. 2nd edition 1990, 1032 pages. ("CLtL2" for short)
and
Guy L. Steele Jr.: Common Lisp - The Language. Digital Press. 1st edition 1984, 465 pages. ("CLtL1" for short)
help(apropos name)(exit) or (quit) or (bye)clisp.#'), the completion is limited to the symbols that
name functions.#P), the completion is done across file names,
bash-style.Help
command.clisplisp.run
#endif
#if defined(MSDOS)
lisp.exe
#endif
#if defined(AMIGAOS)
lisp.run
#endif
#if defined(RISCOS)
lisp
#endif
lispinit.memconfig.lispclisp was built).config.lispclisp).*.lisp*.fasclisp*.libcompile-file and
used by require.*.cclisp
(for the FFI)All environment variables that clisp uses are read
at most once.
CLISP_LANGUAGEclisp
uses to communicate with the user.
The value may be english, german,
french, spanish, dutch,
russian, and defaults to english.
The -L option can be used to
override this environment variable.Languageclisp
uses to communicate with the user, unless it is already specified
through the environment variable CLISP_LANGUAGE or the
-L option.
The value may be as above.LC_CTYPElanguage or
language_country or
language_country.charset,
where language is a two-letter ISO 639 language code
(lower case), country is a two-letter ISO 3166 country
code (upper case). charset is an optional character set
specification, and needs normally not be given because the character
set can be inferred from the language and country.
This environment variable can be overridden with the
-E option.LANGclisp
uses to communicate with the user, unless it is already specified
through the environment variable CLISP_LANGUAGE or the
-L option.
#ifdef UNICODE
It also specifies the locale determining the character set in use, unless
already specified through the environment variable LC_CTYPE.
#endif
The value may begin with a two-letter ISO 639 language code, for example
en, de, fr.HOME and USER (Unix implementation only)user-homedir-pathnameSHELL (Unix implementation only)(shell).COMSPEC (OS/2 implementation only)(shell).TERMTERMclisp
relies on. If you have ANSI.SYS loaded, possible values are
ansi, ansi-color-2, ansi-color-3
and mono.TERMCAPtermcap.dat.TMPDIR (Sparc implementation only)ORGANIZATIONshort-site-name and
long-site-name in config.lisp.CLHSROOTclhs-root in config.lisp.EDITOReditor-name in config.lisp.LOGICAL_HOST_host_FROMLOGICAL_HOST_host_TOLOGICAL_HOST_hostload-logical-pathname-translationsimpnotes.html,
cmucl(1),
emacs(1),
xemacs(1).
When you encounter a bug in clisp, please report it to the
CLISP
mailing list or the
SourceForge bug tracker.
When submitting a bug report, please specify the following information:
"uname -a" on a Unix system)?
Compiler version? LIBC version (on Linux)?clisp? (What command, options &c.)
Please do a clean build (remove your build directory and build
clisp with "./configure --build build" or at
least do a "make distclean" before "make").
If you are reporting a crash (segmentation fault, bus error, core
dump etc), please do
"./configure --with-debug --build build-g"
and report the backtrace."clisp --version"?Known bugs, some of which may be platform-dependent, include
apropos
and describe is available.clisp
in every situation.execute on batch files
crashes the machine.*keyboard-input* does not recognize Ctrl-S and Ctrl-Q.Bruno Haible and Michael Stoll.
See COPYRIGHT for the list of other contributors and the license.
|
|
|