Installation

Add the following line to /etc/apt/sources.list, then run
aptitude update.

deb http://common-lisp.net/project/steeldump unstable main

Packages are all named steeldump-foo. E.g., to
install climacs, type aptitude install
steeldump-climacs. All packages install exclusively to
/opt/steeldump and do not interact with the
Lisp packages included in Debian at all.

There are no source code packages, but full source code is
included in each binary package. (Except for SBCL itself, which
is packaged as steeldump-sbcl with source code only
for the contribs, as usual.)

Usage

Binaries (for the applications) can be found in
/opt/steeldump/bin.

SBCL can be started manually using /opt/steeldump/bin/sbcl.
(Make sure that $SBCL_HOME is not set incorrectly when
doing so. A correct setting for this variable would be
/opt/steeldump/lib/sbcl, but that value is already compiled into
the SBCL binary, so it is not necessary to override it.)

To load heapdumped systems at the Lisp REPL manually, use
(require :foo).

It is possible to use ASDF's load-op instead, although
that just ends up calling require through a trampoline
system. Once the heap file has been loaded, however, a real
asdf system object takes charge.

Implementation detail: To save a little space, source code is
installed without fasls. Instead, the fasls are replaced with
(essentially) empty files that just have the correct timestamp
to make ASDF come to the conclusion that it has nothing to do.

How to report problems

If you encounter something you think is a bug, please try to find
out whether the problem lies with steeldump or with the
upstream application/library.

If you believe steeldump is to blame, please send bug reports to
steeldump-devel@common-lisp.net
to avoid pestering upstream maintainers with problems they cannot
know anything about. If possible, please include a patch. See
below for instructions on the steeldump scripts.

If, however, the bug is also present is the upstream source code,
please send your report directly to the upstream project. Thanks.