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: +

@@ -232,9 +262,10 @@ - +
CormanLisp, - GCL + GCL, + MCL MCL, XCL
XCL
Proprietary Allegro, @@ -606,7 +637,7 @@ Corman Common Lisp Common-Lisp.net button

ASDF has an MIT style license

-
Last updated 2016-09-19
+
Last updated 2016-10-02
-- GitLab