Changes
Page history
Update InstallingCmucl
authored
Jun 30, 2025
by
Raymond Toy
Show whitespace changes
Inline
Side-by-side
InstallingCmucl.md
View page @
05c39ad2
...
...
@@ -48,12 +48,19 @@ trusted signature.
The release tarballs extract to the following directory structure:
```
bin/lisp
lib/cmucl/lib/lisp.core
doc/cmucl/README (this file)
man/man1/cmucl.1
bin/lisp -> lisp-$version
lib/cmucl/$version/lib/
share/cmucl/$version/doc/
share/cmucl/$version/src/
share/cmucl/$version/tests/
share/man/man1/cmucl.1 -> share/man/man1/cmucl-$version.1
share/man/man1/lisp.1 -> share/man/man1/lisp-$version.1
...
```
The
`$version`
above is will be something like "21f" for the 21f
release or "2025-07" for snapshot-2025-07 release. This differs from
the layout of previous versions. (The
`$version`
is set when cmucl is
built from sources.)
This allows you to install CMUCL directly under /usr/local, for example using
```
...
...
@@ -136,7 +143,7 @@ this case, you may want to replace your motifd with this
CMUCL reads two initialization files: a per-user file named
`~/.cmucl-init.lisp`
, and a site-wide file named
`$ROOT/lib/cmucl/lib/site-init.lisp`
(where
`$ROOT`
is the
`$ROOT/lib/cmucl/
$version/
lib/site-init.lisp`
(where
`$ROOT`
is the
base directory in which you installed CMUCL, for example
`/usr/local/`
). It is customary to initialize the
`SHORT-SITE-NAME`
and
`LONG-SITE-NAME`
in the site-init
...
...
@@ -146,11 +153,16 @@ CMUCL is distributed with a file called
`$ROOT/lib/cmucl/lib/generic-site.lisp`
that you can use as a template
for your site-init file:
```
# cd $ROOT/lib/cmucl/lib
# cd $ROOT/lib/cmucl/
$version/
lib
# cp generic-site.lisp site-init.lisp
# emacs site-init.lisp
```
However, if
`$ROOT/lib/cmucl/lib/site-init.lisp`
does not exist, CMUCL
will load
`$ROOT/lib/cmucl/$version/lib/default-site-init.lisp`
if it
exists. This default will set the search-list "target:" to a path in
the install tree containing the sources.
If you have the CMUCL source code installed on your system, you can
set the target: search-list to point to them, so that the debugger
provides more information when a CMUCL function signals an error. See
...
...
...
...