Commit 078b09e0 authored by Francois-Rene Rideau's avatar Francois-Rene Rideau

Some documentation tweaks

parent 72bcaa20
...@@ -225,9 +225,10 @@ How do I navigate this source tree? ...@@ -225,9 +225,10 @@ How do I navigate this source tree?
* [build/](build/) * [build/](build/)
* where the `Makefile` and `asdf-tools` store their output files, including * where the `Makefile` and `asdf-tools` store their output files, including
* `asdf.lisp` -- the current one-file deliverable of ASDF * `asdf.lisp` -- the current one-file deliverable of ASDF
* `asdf-XXX.lisp` -- for upgrade test purposes, old versions * `asdf-*.lisp` -- for upgrade test purposes, old versions
* `asdf-tools` -- the executable for asdf-tools (.exe on Windows)
* `results/` -- logs of tests that have been run * `results/` -- logs of tests that have been run
* `fasls/` -- output files while running tests. * `fasls/` -- output files while running tests
* [ext/](ext/) * [ext/](ext/)
* external dependencies, that can be populated with `make ext` * external dependencies, that can be populated with `make ext`
...@@ -242,4 +243,4 @@ How do I navigate this source tree? ...@@ -242,4 +243,4 @@ How do I navigate this source tree?
* plenty of ideas for how to further improve ASDF. * plenty of ideas for how to further improve ASDF.
Last updated Monday, September 12th, 2016. Last updated Sunday, October 2nd, 2016.
...@@ -25,13 +25,16 @@ ...@@ -25,13 +25,16 @@
** Need to further split asdf:perform in two parts: ** Need to further split asdf:perform in two parts:
A part that runs on the host and specifies (as SEXP or string to read) A part that runs on the host and specifies (as SEXP or string to read)
forms that must be evaluated on the target machine, not the host: forms that must be evaluated on the target machine, not the host:
(asdf:perform-forms target operation component) (asdf:perform-forms target operation component &key input-files output-files)
The default implementation can fallback to running the The default implementation can fallback to running the
(asdf:perform operation component) on the target, (asdf:perform operation component) on the target.
which if it is on specially crafted operation and component objects To ensure isolation, it would run in an isolated process in which
that do not require recreating the component hierarchy and plan, just the specially crafted operation and component objects are defined,
but still require loading the defsystem-depends-on dependencies: though the defsystem-depends-on dependencies are also loaded;
on the target: the action would be run in a temporary directory, that would contain
only a read-only copy of the declared input-files, and some writable
output directory for the output files, that would afterwards be
copied to their actual destination.
;; null means the target is the current host. ;; null means the target is the current host.
;; Or should the base class be plan-traversal or such? ;; Or should the base class be plan-traversal or such?
......
...@@ -208,11 +208,41 @@ ...@@ -208,11 +208,41 @@
<tt>:asdf</tt>, <tt>"ASDF"</tt> or <tt>'asdf</tt> as an argument.) <tt>:asdf</tt>, <tt>"ASDF"</tt> or <tt>'asdf</tt> as an argument.)
All these implementations provide ASDF 3.1 in their latest version, All these implementations provide ASDF 3.1 in their latest version,
but your software distribution might have an older version. but your software distribution might have an older version.
</p><p>
As for remaining implementations, As for remaining implementations,
they are obsolete and/or mostly unmaintained; they are obsolete and/or mostly unmaintained;
GCL is maintained but its maintainer doesn't seem to care about ASDF. ASDF was made to run with each of them at some point,
CormanLisp was recently open-sourced, but its bundled ASDF has but some hacking is probably required to make the latest ASDF work well
not yet been updated from 1.x. with the latest release of these implementations:
<ul><li>
GCL is somewhat maintained but its maintainer doesn't seem to care about ASDF,
and hasn't replied for years to requests for bug fixes and
for providing ASDF via <tt>(require "asdf")</tt>
</li><li>
CormanLisp was recently open-sourced;
its bundled ASDF has not yet been updated from 1.x;
ASDF 3.1 should work fine with it, but a few features were disabled
because CormanLisp is insufficiently compliant with the CLHS,
and requires some work in this regard.
</li><li>
MCL similarly was open-sourced, but never bundled ASDF;
ASDF 3.1 should work just fine with it,
but Rosetta is not supported in the latest versions of MacOS X,
so a lot of work is required to make something out of it
— at which point, you might just use CCL.
</li><li>
XCL is now an abandoned experiment. It provides some old ASDF 2;
but you can replace it with ASDF 3.1, which works well with it,
inasmuch as anything works at all with XCL.
</li><li>
Genera and SCL were never open-source and never bundled ASDF,
but should otherwise just work with a recent ASDF 3.1,
if you somehow have a license and a working version.
</li><li>
Mocl has its own heavily modified variant of ASDF2, and
to make it work with unmodified ASDF 3.x would require
ASDF to be taught about natively supporting cross-compilation.
</li></ul>
</p> </p>
<table border="1"> <table border="1">
<tr><th></th> <tr><th></th>
...@@ -232,9 +262,10 @@ ...@@ -232,9 +262,10 @@
</td> </td>
<td align="left"> <td align="left">
<a href="https://github.com/sharplispers/cormanlisp">CormanLisp</a>, <a href="https://github.com/sharplispers/cormanlisp">CormanLisp</a>,
<a title="GNU Common Lisp" href="https://www.gnu.org/software/gcl/">GCL</a> <a title="GNU Common Lisp" href="https://www.gnu.org/software/gcl/">GCL</a>,
<a title="Macintosh Common Lisp" href="https://en.wikipedia.org/wiki/Macintosh_Common_Lisp">MCL</a>
</td> </td>
<td align="left">MCL, XCL</td></tr> <td align="left">XCL</td></tr>
<tr><th align="left">Proprietary</th> <tr><th align="left">Proprietary</th>
<td align="left"> <td align="left">
<a href="http://franz.com/products/allegro-common-lisp/">Allegro</a>, <a href="http://franz.com/products/allegro-common-lisp/">Allegro</a>,
...@@ -606,7 +637,7 @@ Corman Common Lisp <admin@cormanlisp.com> ...@@ -606,7 +637,7 @@ Corman Common Lisp <admin@cormanlisp.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> <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-2016 Daniel Barlow and contributors</span></p> <p><span class="copyright"Copyright &copy; 2001-2016 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> <p>ASDF has an <a href="http://www.opensource.org/licenses/mit-license.php">MIT style</a> license</p>
<div id="timestamp">Last updated 2016-09-19</div> <div id="timestamp">Last updated 2016-10-02</div>
</div> </div>
</body> </body>
</html> </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