X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/runlisp/blobdiff_plain/bc040e8027e121781f7f6a8ac1da2c3156a861bf..13cc23c5d624a4a61a5b378a998fc62ac293a5a7:/README.org

diff --git a/README.org b/README.org
index fe14cd7..c4aad72 100644
--- a/README.org
+++ b/README.org
@@ -25,7 +25,8 @@ configuration file.  Of course, there's a benefit to having a collection
 of high-quality configuration runes curated centrally, so I'm happy to
 accept submissions in support of any free[fn:free] Lisp implementations.
 
-[fn:free] Here I mean free as in freedom.
+[fn:free] Here I mean `free' as in freedom: see
+https://www.fsf.org/about/what-is-free-software.
 
 
 * Writing scripts in Common Lisp
@@ -69,6 +70,13 @@ in the ~-L~ option, separated by commas:
 :                          #-(or sbcl ccl) "an unexpected"
 :                          " Common Lisp!~%"))
 
+It is not an error to include the name of an unrecognized Lisp system in
+the ~-L~ option: such names are simply ignored.  This allows a script to
+declare support for unusual or locally installed Lisp systems without
+compromising its portability to sites where such systems are unknown, or
+which are still running older versions of ~runlisp~ which haven't been
+updated with the necessary configuration for those systems.
+
 ** Embedded options
 
 If your script requires features of particular Lisp implementations
@@ -243,7 +251,7 @@ are assignments, which look like
 and assignments are split into sections by section headers in square
 brackets:
 #+BEGIN_QUOTE
-~[~​/section/​~]~
+~[~\relax{}/section/\relax{}~]~
 #+END_QUOTE
 The details of the configuration syntax are complicated, and explained
 in the *runlisp.conf* manpage.
@@ -321,7 +329,9 @@ Lisp.  (SBCL's command-line interface is well thought-out, so this is an
 ideal opportunity to explain how ~runlisp~ configuration works, without
 getting bogged down in the details of fighting less amenable Lisps.)
 
-The provided ~0base.conf~ file defines SBCL as follows.
+The provided ~0base.conf~ file used to define SBCL as follows.  (The
+real version now contains a kludge for old versions, which needn't
+concern us here.)
 
 : [sbcl]
 :