Skip to content
Snippets Groups Projects
Commit 25d776fd authored by toy's avatar toy
Browse files

Document the new -lib option, the CMUCLCORE envvar, and the core

search algorithm.
parent aec7af60
No related branches found
No related tags found
No related merge requests found
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
.\" If you want to use this code or any part of CMU Common Lisp, please contact .\" If you want to use this code or any part of CMU Common Lisp, please contact
.\" Scott Fahlman or slisp-group@cs.cmu.edu. .\" Scott Fahlman or slisp-group@cs.cmu.edu.
.\" .\"
.\"$Header: /Volumes/share2/src/cmucl/cvs2git/cvsroot/src/general-info/lisp.1,v 1.8 2002/02/06 22:43:01 pmai Exp $ .\"$Header: /Volumes/share2/src/cmucl/cvs2git/cvsroot/src/general-info/lisp.1,v 1.9 2003/01/30 15:46:42 toy Exp $
.\" .\"
.\" ********************************************************************** .\" **********************************************************************
.\" .\"
...@@ -29,8 +29,10 @@ provide operands for some switches. These switches are defined: ...@@ -29,8 +29,10 @@ provide operands for some switches. These switches are defined:
.TP 10n .TP 10n
.BR \-core " filename" .BR \-core " filename"
Specifies the suspended Lisp image (or `core file') to start up. The default Specifies the suspended Lisp image (or `core file') to start up.
is `lib/lisp.core'. .TP
.BR \-lib " libpath"
A colon-separated list of directories to be used for the library: search-list.
.TP .TP
.BR \-edit .BR \-edit
Causes Lisp to enter the Causes Lisp to enter the
...@@ -92,7 +94,12 @@ is the decimal number of the socket to connect to. ...@@ -92,7 +94,12 @@ is the decimal number of the socket to connect to.
.TP 10n .TP 10n
.BR CMUCLLIB .BR CMUCLLIB
This variable points to the `lib/' directory holding `lisp.core' and other This variable points to the `lib/' directory holding `lisp.core' and other
files used by Lisp at run-time. The default is `/usr/local/lib/cmucl/lib'. files used by Lisp at run-time. This can be overridden by using the
-lib commandline option.
.TP
.BR CMUCLCORE
This variable holds the path to the `lisp.core' that that should be
used. This can be overridden by using the -core commandline option.
.TP .TP
.BR CMUCL_EMPTYFILE .BR CMUCL_EMPTYFILE
[SunOS only] If `df /tmp' shows `swap' as the filesystem for the `/tmp' [SunOS only] If `df /tmp' shows `swap' as the filesystem for the `/tmp'
...@@ -108,6 +115,30 @@ error messages every time a new connection is opened to the CMU CL motifd. ...@@ -108,6 +115,30 @@ error messages every time a new connection is opened to the CMU CL motifd.
This file is read by the X11R5 Xt in order to augment the keysym database with This file is read by the X11R5 Xt in order to augment the keysym database with
certain OSF vendor keysyms that Motif wants to use. certain OSF vendor keysyms that Motif wants to use.
.SH CORE FILE SEARCHING
When no core file is specified (either by the CMUCLCORE environment
variable or by the -core option), CMUCL will search in various places to
find a possible core file.
When the environment variable CMUCLLIB is set or the -lib option is
given, the lisp core file is searched in the places specified
therein. This is a colon-separated list of directories, just like
PATH. This is of directories is searched in order for a file named
`lisp.core'. The first one found will be the core to be used.
When the CMUCLLIB is not set and -lib is not given, a set of default
paths is used. Let the lisp C executable be located at `<bin>/lisp'.
Then the following directories are searched for the core file:
.TP 10n
.BR `<bin>'
.TP
.BR `<bin>/../lib/cmucl/lib'
.TP
.BR `<bin>/../lib'
.TP
.BR `/usr/local/lib/cmucl/lib'
.PP .PP
.SH FILES .SH FILES
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment