Commit d944ca34 authored by Francois-Rene Rideau's avatar Francois-Rene Rideau

index: mkcl now ships with asdf3.

manual: document that ~/common-lisp/ is now in the default source-registry;
  mention dump-image hooks when discussing clear-configuration.
improve install-asdf-as-module and its coverage in the manual.
parent 0001d86f
...@@ -16,7 +16,12 @@ It notably doesn't work on: ...@@ -16,7 +16,12 @@ It notably doesn't work on:
* mocl, that doesn't support ASDF 3 yet. * mocl, that doesn't support ASDF 3 yet.
* Corman Lisp, RMCL, Genera, that are obsolete anyway. * Corman Lisp, RMCL, Genera, that are obsolete anyway.
|# |#
(require :asdf) (ignore-errors (funcall 'require "asdf")) ;; Load the implementation-provided ASDF
#-asdf2 (load (merge-pathnames ;; Fall back to loading ASDF manually
(make-pathname :name "asdf" :type "lisp" :version nil
:directory '(:relative :back "build") :defaults *load-pathname*)
*load-pathname*))
(asdf:load-system :asdf) ;; Upgrade to the latest ASDF3 (assumes you have it configured properly)
(in-package :asdf) (in-package :asdf)
......
...@@ -246,8 +246,9 @@ we recommend you upgrade to ASDF 3 ...@@ -246,8 +246,9 @@ we recommend you upgrade to ASDF 3
--- and we explain how to do that. @xref{Loading ASDF}. --- and we explain how to do that. @xref{Loading ASDF}.
(In the context of compatibility requirements, (In the context of compatibility requirements,
ASDF 2.27, released on Feb 1st 2013, and further 2.x releases up to 2.33, ASDF 2.27, released on Feb 1st 2013, and further 2.x releases up to 2.33,
count as pre-releases of ASDF 3, and define the :asdf3 feature; count as pre-releases of ASDF 3, and define the @code{:asdf3} feature;
still, please use the latest release). still, please use the latest release).
Release ASDF 3.1.1 and later also define the @code{:asdf3.1} feature.
Also note that ASDF is not to be confused with ASDF-Install. Also note that ASDF is not to be confused with ASDF-Install.
ASDF-Install is not part of ASDF, but a separate piece of software. ASDF-Install is not part of ASDF, but a separate piece of software.
...@@ -256,6 +257,9 @@ We recommend you use Quicklisp instead, ...@@ -256,6 +257,9 @@ We recommend you use Quicklisp instead,
which works great and is being actively maintained. which works great and is being actively maintained.
If you want to download software from version control instead of tarballs, If you want to download software from version control instead of tarballs,
so you may more easily modify it, we recommend clbuild. so you may more easily modify it, we recommend clbuild.
We recommend @file{~/common-lisp/}
as a place into which to install Common Lisp software;
starting with ASDF 3.1.1, it is included in the default source-registry configuration.
@node Quick start summary, Loading ASDF, Introduction, Top @node Quick start summary, Loading ASDF, Introduction, Top
@chapter Quick start summary @chapter Quick start summary
...@@ -276,7 +280,9 @@ Make sure ASDF can find system definitions ...@@ -276,7 +280,9 @@ Make sure ASDF can find system definitions
through proper source-registry configuration. through proper source-registry configuration.
For more details, @xref{Configuring ASDF to find your systems}. For more details, @xref{Configuring ASDF to find your systems}.
The simplest way is simply to put all your lisp code in subdirectories of The simplest way is simply to put all your lisp code in subdirectories of
@file{~/.local/share/common-lisp/source/}. @file{~/common-lisp/} (starting with ASDF 3.1.1),
or @file{~/.local/share/common-lisp/source/}
(for ASDF 2 and later, or if you want to keep source in a hidden directory).
Such code will automatically be found. Such code will automatically be found.
@item @item
...@@ -433,10 +439,12 @@ we assume you're an expert deliberately using a legacy implementation, ...@@ -433,10 +439,12 @@ we assume you're an expert deliberately using a legacy implementation,
and are proficient enough to install this fasl. and are proficient enough to install this fasl.
Still, the ASDF source repository contains a script Still, the ASDF source repository contains a script
@file{bin/install-asdf-as-module} that can help you do that. @file{bin/install-asdf-as-module} that can help you do that.
It relies on cl-launch 4 for command-line invocation, It relies on @file{cl-launch} 4 for command-line invocation,
which may depend on ASDF being checked out in @file{~/cl/asdf/} which may depend on ASDF being checked out in @file{~/cl/asdf/}
if your implementation doesn't even have an ASDF 2; if your implementation doesn't even have an ASDF 2;
but you can run the code it manually if needs be. but if you don't have @file{cl-launch},
you can instead @code{(load "bin/install-asdf-as-module")}
from your implementation's REPL.
Finally, if your implementation only provides ASDF 2, Finally, if your implementation only provides ASDF 2,
and you can't or won't upgrade it or override its ASDF module, and you can't or won't upgrade it or override its ASDF module,
...@@ -566,9 +574,11 @@ ASDF, starting from easiest to the most complex: ...@@ -566,9 +574,11 @@ ASDF, starting from easiest to the most complex:
@item @item
Put all of your systems in subdirectories of Put all of your systems in subdirectories of
@file{~/common-lisp/} or
@file{~/.local/share/common-lisp/source/}. @file{~/.local/share/common-lisp/source/}.
If you install software there (it can be a symlink), If you install software there, you don't need further configuration.
you don't need further configuration. (NB: @file{~/common-lisp/} is only included in the default configuration
starting with ASDF 3.1.1 or later)
@item @item
If you're using some tool to install software (e.g. Quicklisp), If you're using some tool to install software (e.g. Quicklisp),
...@@ -615,16 +625,6 @@ If necessary, you can reset the source-registry configuration with: ...@@ -615,16 +625,6 @@ If necessary, you can reset the source-registry configuration with:
(asdf:clear-source-registry) (asdf:clear-source-registry)
@end lisp @end lisp
@c FIXME: too specific. Push this down to discussion of dumping an
@c image?
@c And you probably should do so before you dump your Lisp image,
@c if the configuration may change
@c between the machine where you save it at the time you save it
@c and the machine you resume it at the time you resume it.
@c Actually, you should use @code{(asdf:clear-configuration)}
@c before you dump your Lisp image, which includes the above.
@item @item
In earlier versions of ASDF, the system source registry was configured In earlier versions of ASDF, the system source registry was configured
using a global variable, @code{asdf:*central-registry*}. using a global variable, @code{asdf:*central-registry*}.
...@@ -828,19 +828,15 @@ For that you may use the following function: ...@@ -828,19 +828,15 @@ For that you may use the following function:
regarding source-registry or output-translations. regarding source-registry or output-translations.
@end defun @end defun
If you use SBCL, CMUCL or SCL, you may use this snippet This function is pushed onto the @code{uiop:*image-dump-hook*} by default,
so that the ASDF configuration be cleared automatically as you dump an image: which means that if you save an image using @code{uiop:dump-image},
or via @code{asdf:image-op} and @code{asdf:program-op},
@example it will be automatically called to clear your configuration.
#+(or cmu sbcl scl) If for some reason you prefer to call your implementation's underlying functionality,
(pushnew 'clear-configuration be sure to call @code{clear-configuration} manually,
#+(or cmu scl) ext:*before-save-initializations* or push it into your implementation's equivalent of @code{uiop:*image-dump-hook*},
#+sbcl sb-ext:*save-hooks*) e.g. @code{sb-ext:*save-hooks*} on SBCL, or @code{ext:*before-save-initializations*}
@end example on CMUCL and SCL, etc.
For compatibility with all Lisp implementations, however,
you might want instead your build script to explicitly call
@code{(asdf:clear-configuration)} at an appropriate moment before dumping.
@node Using ASDF, Defining systems with defsystem, Configuring ASDF, Top @node Using ASDF, Defining systems with defsystem, Configuring ASDF, Top
@chapter Using ASDF @chapter Using ASDF
......
...@@ -184,8 +184,8 @@ ...@@ -184,8 +184,8 @@
<th align="left">Will provide it</th> <th align="left">Will provide it</th>
<th align="left">Obsolete</th></tr> <th align="left">Obsolete</th></tr>
<tr><th align="left">Free</th> <tr><th align="left">Free</th>
<td align="left"><tt>abcl ccl clisp cmucl ecl sbcl</tt></td> <td align="left"><tt>abcl ccl clisp cmucl ecl mkcl sbcl</tt></td>
<td align="left"><tt>mkcl xcl</tt></td> <td align="left"><tt>xcl</tt></td>
<td> </td> <td> </td>
<td align="left"><tt>gcl mcl</tt></td></tr> <td align="left"><tt>gcl mcl</tt></td></tr>
<tr><th align="left">Proprietary</th> <tr><th align="left">Proprietary</th>
...@@ -196,7 +196,7 @@ ...@@ -196,7 +196,7 @@
</table> </table>
<p> <p>
To deal with an implementation that doesn't yet provide ASDF 3, To deal with an implementation that doesn't yet provide ASDF 3,
we provide a script that can install ASDF 3 we provide <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=bin/install-asdf-as-module">a script</a> that can install ASDF 3
where your implementation goes looking for it where your implementation goes looking for it
when you <tt>require</tt> it. when you <tt>require</tt> it.
Alternatively, if the implementation provides ASDF 2 or an older ASDF 3, Alternatively, if the implementation provides ASDF 2 or an older ASDF 3,
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment