From 7b629476520250725777878272297f2946bde598 Mon Sep 17 00:00:00 2001 From: Francois-Rene Rideau <fare@tunes.org> Date: Fri, 1 Oct 2010 16:05:38 -0400 Subject: [PATCH] Add note about downcasing of symbols used as system names, from Dan Barlow's recent email citing his original README. --- doc/asdf.texinfo | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo index 8ee342b6..e05aad22 100644 --- a/doc/asdf.texinfo +++ b/doc/asdf.texinfo @@ -242,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.004, +If you are running a version older than 2.008, we recommend that you load a newer ASDF using the method below. @@ -569,6 +569,19 @@ If your ASDF is too old to provide @code{asdf:load-system} though we recommend that you upgrade to ASDF 2. @xref{Loading ASDF,,Loading an otherwise installed ASDF}. +Note the name of a system is specified as a string or a symbol, +typically a keyword. +If a symbol (including a keyword), its name is taken and lowercased. +The name must be a suitable value for the @code{:name} initarg +to @code{make-pathname} in whatever filesystem the system is to be found. +The lower-casing-symbols behaviour is unconventional, +but was selected after some consideration. +Observations suggest that the type of systems we want to support +either have lowercase as customary case (unix, mac, windows) +or silently convert lowercase to uppercase (lpns), +so this makes more sense than attempting to use @code{:case :common}, +which is reported not to work on some implementations + @section Other Operations -- GitLab