From eb0afa821c728e10cfcd9d59f4ba48561928c8a6 Mon Sep 17 00:00:00 2001
From: Francois-Rene Rideau <tunes@google.com>
Date: Thu, 26 Dec 2013 15:07:38 -0500
Subject: [PATCH] Documentation tweak.

---
 TODO             | 23 ++++++++++++++++++++++-
 doc/asdf.texinfo | 12 +++++++++++-
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/TODO b/TODO
index 0eb0b41f..6d600c05 100644
--- a/TODO
+++ b/TODO
@@ -33,7 +33,28 @@
    :name nil :type nil) fails to handle the logical-pathname-ness of ASDFTEST.
 
 * GCL is almost working again; but implementation bugs remain.
-  See November 2013 discussion on gcl-devel
+  See November 2013 discussion on gcl-devel.
+   * Another GCL compiler bug:
+   when I changed the definition of getcwd from
+   (let ((*default-pathname-defaults* #p"")) (truename #p"")) to
+   (let ((*default-pathname-defaults* *nil-pathname*)) (truename *nil-pathname*))
+   to guard against e.g. a logical-pathname context while loading asdf
+   and parsing #p"", calls to getcwd result in a segfault.
+   * An another bug: gcl refuses dynamic-extent declaration on functions.
+    uiop/stream.lisp:         #-gcl (declare (dynamic-extent ,@(when
+    before `(#',beforef)) ,@(when after `(#',afterf))))
+   * (typep p 'logical-pathname) should be T if p has a logical-pathname host.
+   * apropos is case-sensitive and returns a same symbol many times
+   * compile-file fails to return proper secondary values in case of non-style WARNING.
+   * (pathname-directory #p"foo/") is incorrectly ("foo") instead of (:RELATIVE "foo")
+   * Missing: chdir, combine-fasls, and plenty more UIOP functions.
+   * Do whatever it takes to pass the asdf tests, add the above?
+   * Have (require "asdf") and (require "ASDF") both work.
+   * Trying to uiop:slurp-stream-forms from a stream with #+(or) :foo
+     (or read-file-forms from an file with same) results in an error,
+     rather than nil. This is probably a bug in #+ processing.
+     Unhappily, debian creates such a file in
+     /etc/common-lisp/asdf-output-translations.conf.d/01-common-lisp-controller.conf
 
 * Some out-of-line configuration mechanism for various options?
   i.e. let configuration files override some variables around compilation of some systems.
diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo
index 3aef9a78..b954fb4d 100644
--- a/doc/asdf.texinfo
+++ b/doc/asdf.texinfo
@@ -4296,7 +4296,10 @@ Since ASDF 2,
 it should always be a good time to upgrade to a recent version of ASDF.
 You may consult with the maintainer for which specific version they recommend,
 but the latest @code{release} should be correct.
-We trust you to thoroughly test it with your implementation
+Though we do try to test ASDF releases against all implementations that we can,
+we may not be testing against all variants of your implementation,
+and we may not be running enough tetst;
+we trust you to thoroughly test it with your own implementation
 before you release it.
 If there are any issues with the current release,
 it's a bug that you should report upstream and that we will fix ASAP.
@@ -4351,6 +4354,13 @@ and you are welcome to include @file{asdf.asd} amongst them.
 Non-magic systems should be at the back of the @code{wrapping-source-registry}
 while magic systems are at the front.
 
+@item
+Since ASDF 3, the library UIOP comes transcluded in ASDF.
+But for extra brownies, you may package UIOP separately,
+so that one may @code{(require "uiop")} and not pull ASDF,
+or one may @code{(require "asdf")}
+and that would implicitly require the former.
+
 @item
 Please send us upstream any patches you make to ASDF itself,
 so we can merge them back in for the benefit of your users
-- 
GitLab