From 5c102243b68da0887ced579dd3d6c29722c2ef97 Mon Sep 17 00:00:00 2001 From: Francois-Rene Rideau <fare@tunes.org> Date: Wed, 28 Jul 2010 14:05:21 -0400 Subject: [PATCH] Documentation tweaks --- doc/asdf.texinfo | 16 ++++++++++------ doc/index.html | 2 +- 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo index d33c21c4..9f5a3bd0 100644 --- a/doc/asdf.texinfo +++ b/doc/asdf.texinfo @@ -206,7 +206,10 @@ Consult your Lisp implementation's documentation for details. Hopefully, ASDF 2 will soon be bundled with every Common Lisp implementation, and you can load it that way. - +If it is not, see @pxref{Loading ASDF,,Loading an otherwise installed ASDF} below. +if you are using the latest version of your Lisp vendor's software, +you may also send a bug report to your Lisp vendor and complain about +their failing to provide ASDF. @section Checking whether ASDF is loaded @@ -239,7 +242,7 @@ If it returns the keyword @code{:OLD}, then you're using an old version of ASDF (from before 1.635). If it returns @code{NIL} then ASDF is not installed. -If you are running a version older than 2.000, +If you are running a version older than 2.004, we recommend that you load a newer ASDF using the method below. @@ -2871,7 +2874,7 @@ In the meantime, you can load @file{asdf.lisp} directly. @subsection ``I'm a Common Lisp implementation vendor. When and how should I upgrade ASDF?'' Starting with current candidate releases of ASDF 2, -it should always be a good time to upgrade to a recent version of ASDF. +it should always be a good time to upgrade to a recent ASDF. You may consult with the maintainer for which specific version they recommend, but the latest RELEASE should be correct. We trust you to thoroughly test it with your implementation before you release it. @@ -2882,7 +2885,7 @@ As to how to include ASDF, we recommend the following: @itemize @item -If ASDF isn't installed yet, then @code{(require :asdf)} +If ASDF isn't loaded yet, then @code{(require :asdf)} should load the version of ASDF that is bundled with your system. You may have it load some other version configured by the user, if you allow such configuration. @@ -2908,8 +2911,9 @@ You should still include the file @file{asdf.lisp} in your source distribution and precompile it in your binary distribution, but @file{asdf.asd} if included at all, should be secluded from the magic systems, -in a separate file hierarchy, -or you may otherwise rename the system and its file to e.g. +in a separate file hierarchy; +alternatively, you may provide the system +after renaming it and its @file{.asd} file to e.g. @code{asdf-ecl} and @file{asdf-ecl.asd}, or @code{sb-asdf} and @file{sb-asdf.asd}. Indeed, if you made @file{asdf.asd} a magic system, diff --git a/doc/index.html b/doc/index.html index e0966116..78b1bca8 100644 --- a/doc/index.html +++ b/doc/index.html @@ -98,7 +98,7 @@ <a id="news"></a> <h3>What is happening</h3> <dl> - <dt>December 2009 to June 2010</dt> + <dt>December 2009 to August 2010</dt> <dd>François-René Rideau is de facto maintainer, with notable contributions from Robert P. Goldman, Juanjo Garcia-Ripoll and James Anderson. -- GitLab