Commit 504c9f1b authored by Francois-Rene Rideau's avatar Francois-Rene Rideau

Documentation tweak.

parent 4f1f7e9d
......@@ -5,9 +5,9 @@ clnet_home := "/project/asdf/public_html/"
sourceDirectory := $(shell pwd)
lisps ?= ccl clisp sbcl ecl abcl xcl scl allegro
## not tested by me: allegromodern cmucl lispworks
## occasionally tested by not me: allegromodern cmucl lispworks
## FAIL: gclcvs (condition handling)
## maybe supported by asdf, not supported yet by our tests: cormancl mcl genera
## tentatively supported by asdf, not supported by our tests: cormancl mcl genera
lisp ?= sbcl
......@@ -83,17 +83,19 @@ do-test-all:
test-all: test-forward-references test-upgrade do-test-all
# Note that the debian git at git://git.debian.org/git/pkg-common-lisp/cl-asdf.git is stale,
# as we currently build directly from upstream at git://common-lisp.net/projects/asdf/asdf.git
debian-package: mrproper
: $${RELEASE:="$$(git tag -l '2.0[0-9][0-9]' | tail -n 1)"} ; \
git-buildpackage --git-debian-branch=release --git-upstream-branch=$$RELEASE --git-tag --git-retag --git-ignore-branch
# Replace SBCL's ASDF with the current one.
# not recommended: just use (asdf:load-system :asdf)
# for casual users, just use (asdf:load-system :asdf)
replace-sbcl-asdf:
sbcl --eval '(compile-file "asdf.lisp" :output-file (format nil "~Aasdf/asdf.fasl" (sb-int:sbcl-homedir-pathname)))' --eval '(quit)'
# Replace CCL's ASDF with the current one.
# not recommended: just use (asdf:load-system :asdf)
# for casual users, just use (asdf:load-system :asdf)
replace-ccl-asdf:
ccl --eval '(progn(compile-file "asdf.lisp" :output-file (format nil "~Atools/asdf.lx64fsl" (ccl::ccl-directory)))(quit))'
......
......@@ -9,7 +9,7 @@ Build-Depends: debhelper (>> 7)
Build-Depends-Indep: texinfo, texlive-extra-utils, texlive, texlive-generic-recommended
Standards-Version: 3.9.1.0
Homepage: http://common-lisp.net/project/asdf/
Vcs-Git: git://git.debian.org/git/pkg-common-lisp/cl-asdf.git
Vcs-Git: git://common-lisp.net/projects/asdf/asdf.git
Package: cl-asdf
Architecture: all
......
......@@ -202,14 +202,20 @@ You can usually load this copy using Common Lisp's @code{require} function:
(require :asdf)
@end lisp
Consult your Lisp implementation's documentation for details.
As of the writing of this manual,
the following implementations provide ASDF 2 this way:
abcl allegro ccl clisp cmucl ecl sbcl xcl.
The following implementations don't provide it yet but might in a future release:
lispworks scl.
The following implementations are obsolete and most probably will never bundle it:
cormancl gcl genera mcl.
If the implementation you are using doesn't provide ASDF 2,
see @pxref{Loading ASDF,,Loading an otherwise installed ASDF} below.
If that implementation is still actively maintained,
you may also send a bug report to your Lisp vendor and complain
about their failing to provide ASDF.
Hopefully, ASDF 2 will soon be bundled with every Common Lisp implementation,
and you can load it that way.
If it is not, see @pxref{Loading ASDF,,Loading an otherwise installed ASDF} below.
if you are using the latest version of your Lisp vendor's software,
you may also send a bug report to your Lisp vendor and complain about
their failing to provide ASDF.
@section Checking whether ASDF is loaded
......@@ -242,8 +248,10 @@ If it returns the keyword @code{:OLD},
then you're using an old version of ASDF (from before 1.635).
If it returns @code{NIL} then ASDF is not installed.
If you are running a version older than 2.008,
we recommend that you load a newer ASDF using the method below.
If you are experiencing problems with ASDF,
please try upgrading to the latest released version,
using the method below,
before you contact us and raise an issue.
@section Upgrading ASDF
......@@ -279,11 +287,15 @@ and make sure you're not using it
for multiple mutually incompatible implementations.
At worst, you may have to have multiple copies of the new ASDF,
e.g. one per implementation installation, to avoid clashes.
Note that to our knowledge all implementations that provide ASDF
provide ASDF 2 in their latest release, so
you may want to upgrade your implementation rather than go through that hoop.
Finally, note that there are some limitations to upgrading ASDF:
@itemize
@item
Any ASDF extension is invalidated, and will need to be reloaded.
This applies to e.g. CFFI-Grovel, or to hacks used by ironclad, etc.
@item
It is safer if you upgrade ASDF and its extensions as a special step
at the very beginning of whatever script you are running,
......
......@@ -29,8 +29,17 @@
<a id="ASDF 2"></a>
<h3>ASDF 2</h3>
<p>We released ASDF 2 on May 31st 2010.
It will hopefully be bundled will all official releases
of Common Lisp implementations made after that date.
It has now been widely adopted by the CL community.
</p><p>
These implementations provide ASDF 2 in their latest release
so you can just <tt>(require :asdf)</tt>:
(free) abcl ccl clisp cmucl ecl sbcl xcl; (proprietary) allegro.
</p><p>
These implementations work with ASDF 2 but don't bundle ASDF 2 yet:
(proprietary) lispworks scl.
</p><p>
These implementations are obsolete, yet are somewhat supported by ASDF 2:
(free) gcl mcl; (proprietary) cormancl genera.
</p>
<a id="what_it_is"></a>
<h3>What it is</h3>
......@@ -155,7 +164,7 @@
<a class="nav" href="http://common-lisp.net/" title="Common-Lisp.net"> <img src="http://common-lisp.net/project/cl-containers/shared/buttons/lisp-lizard.png" width="80" height="15" title="Common-Lisp.net" alt="Common-Lisp.net button" /></a>
<p><span class="copyright"Copyright &copy; 2001-2010 Daniel Barlow and contributors</span></p>
<p>ASDF has an <a href="http://www.opensource.org/licenses/mit-license.php">MIT style</a> license</p>
<div id="timestamp">Last updated 2011-03-19</div>
<div id="timestamp">Last updated 2011-04-06</div>
</div>
</body>
</html>
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