From 078b09e05123c850228fa8ee8de0fcb75362a463 Mon Sep 17 00:00:00 2001
From: Francois-Rene Rideau
Date: Sun, 2 Oct 2016 16:09:06 -0400
Subject: [PATCH] Some documentation tweaks
---
README.md | 7 ++++---
TODO | 15 +++++++++------
doc/index.html | 43 +++++++++++++++++++++++++++++++++++++------
3 files changed, 50 insertions(+), 15 deletions(-)
diff --git a/README.md b/README.md
index 9b8898ec..e88925ef 100644
--- a/README.md
+++ b/README.md
@@ -225,9 +225,10 @@ How do I navigate this source tree?
* [build/](build/)
* where the `Makefile` and `asdf-tools` store their output files, including
* `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
- * `fasls/` -- output files while running tests.
+ * `fasls/` -- output files while running tests
* [ext/](ext/)
* external dependencies, that can be populated with `make ext`
@@ -242,4 +243,4 @@ How do I navigate this source tree?
* plenty of ideas for how to further improve ASDF.
-Last updated Monday, September 12th, 2016.
+Last updated Sunday, October 2nd, 2016.
diff --git a/TODO b/TODO
index a41a9445..28dc717e 100644
--- a/TODO
+++ b/TODO
@@ -25,13 +25,16 @@
** Need to further split asdf:perform in two parts:
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:
- (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
- (asdf:perform operation component) on the target,
- which if it is on specially crafted operation and component objects
- that do not require recreating the component hierarchy and plan,
- but still require loading the defsystem-depends-on dependencies:
- on the target:
+ (asdf:perform operation component) on the target.
+ To ensure isolation, it would run in an isolated process in which
+ just the specially crafted operation and component objects are defined,
+ though the defsystem-depends-on dependencies are also loaded;
+ 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.
;; Or should the base class be plan-traversal or such?
diff --git a/doc/index.html b/doc/index.html
index da1a6073..e809e456 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -208,11 +208,41 @@
:asdf, "ASDF" or 'asdf as an argument.)
All these implementations provide ASDF 3.1 in their latest version,
but your software distribution might have an older version.
+
As for remaining implementations,
they are obsolete and/or mostly unmaintained;
- GCL is maintained but its maintainer doesn't seem to care about ASDF.
- CormanLisp was recently open-sourced, but its bundled ASDF has
- not yet been updated from 1.x.
+ ASDF was made to run with each of them at some point,
+ but some hacking is probably required to make the latest ASDF work well
+ with the latest release of these implementations:
+
-
+ 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 (require "asdf")
+
-
+ 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.
+
-
+ 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.
+
-
+ 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.
+
-
+ 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.
+
-
+ 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.
+
|
@@ -232,9 +262,10 @@
CormanLisp,
- GCL
+ GCL,
+ MCL
|
- MCL, XCL |
+ XCL |
Proprietary |
Allegro,
@@ -606,7 +637,7 @@ Corman Common Lisp
ASDF has an MIT style license
- Last updated 2016-09-19
+ Last updated 2016-10-02
|
---|