Update InstallingCmucl authored by Raymond Toy's avatar Raymond Toy
......@@ -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
......
......