Commit 80096b73 authored by Francois-Rene Rideau's avatar Francois-Rene Rideau
Browse files

Rename install-asdf-as-module to install-asdf.lisp;

update it and its documentation.
parent 8f09d861
......@@ -496,25 +496,19 @@ as explained below.
If all fails, we recommend you load ASDF from source
@pxref{Loading ASDF,,Loading ASDF from source}.
The ASDF source repository contains a script
@file{bin/install-asdf-as-module} that can help you upgrade your implementation's ASDF.
The ASDF source repository contains a tool to help you upgrade your implementation's ASDF.
You can invoke it from the shell command-line as
@code{tools/asdf-tools install-asdf lispworks}
(where you can replace @tt{lispworks} by the name of the relevant implementation),
or you can @code{(load "tools/install-asdf.lisp")} from your Lisp REPL.
It works on
Allegro CL, Clozure CL, CMU CL, ECL, GNU CLISP, LispWorks, MKCL, SBCL, SCL, XCL.
That's all known implementations except ABCL, Corman CL, GCL, Genera, MCL, MOCL.
Happily, ABCL is usually pretty up to date and shouldn't need that script.
Allegro CL, Clozure CL, CMU CL, GNU CLISP, LispWorks, SBCL, SCL, XCL.
It doesn't work on ABCL, Corman CL, ECL, GCL, Genera, MCL, MKCL, MOCL.
Happily, ABCL, ECL and MKCL are usually pretty up to date and shouldn't need that script.
GCL would be supported, except that so far is still lacking usable support for @code{require}.
Corman CL, Genera, MCL are obsolete anyway.
MOCL is under development.
On an old version of an implementation that does not provide ASDF,
you may have to load ASDF 3 from source before you load that script.
The script relies on @code{cl-launch} 4 for command-line invocation,
which may depend on ASDF being checked out in @file{~/common-lisp/asdf/}
(which we recommend anyway)
if your implementation doesn't even have an ASDF 2.
If you don't have @code{cl-launch},
you can instead @code{(load "bin/install-asdf-as-module")}
from your implementation's REPL after loading ASDF from source.
Finally, if your implementation only provides ASDF 2,
and you can't or won't upgrade it or override its ASDF module,
......
......@@ -199,7 +199,7 @@
</table>
<p>
To deal with an implementation that doesn't yet provide 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
we provide <a href="http://common-lisp.net/gitweb?p=projects/asdf/asdf.git;a=blob;f=tools/install-asdf.lisp">a script</a> that can install ASDF 3
where your implementation goes looking for it
when you <tt>require</tt> it.
Alternatively, if the implementation provides ASDF 2 or an older ASDF 3,
......@@ -484,7 +484,7 @@ XCL (Peter Graves) <gnooth@gmail.com>
<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-2014 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 2014-05-09</div>
<div id="timestamp">Last updated 2014-05-19</div>
</div>
</body>
</html>
......@@ -51,12 +51,12 @@ This is great to quickly locate compilation errors and interactively debug ASDF.
(return nil))))))
;;; BONUS: install asdf as module for your favorite Lisp implementation.
(deftestcmd install-asdf-as-module (lisp)
(deftestcmd install-asdf (lisp)
(flet ((doit ()
(with-asdf-dir ()
(run-test-lisp
(format nil "Installing ASDF to be provided as a module on ~(~A~)" lisp)
'((load "tools/install-asdf-as-module")(uiop:quit))
(format nil "installing ASDF to be provided as a module on ~(~A~)" lisp)
'((load "tools/install-asdf.lisp")(uiop:quit))
:lisp lisp))))
(case lisp
((:allegro :allegromodern :ccl :clisp :cmucl :lispworks :sbcl :scl :xcl)
......
......@@ -114,7 +114,8 @@
;; XCL support starts with ASDF 2.014.2
;; — It also dies during upgrade trying to show the backtrace.
;; We recommend you replace XCL's asdf using the install-asdf-as-module script.
;; We recommend you replace XCL's asdf using:
;; ./tools/asdf-tools install-asdf xcl
((:xcl) (version<= "2.15" tag))
;; all clear on these implementations
......
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