patch for ASDF documentation regarding dependencies and versions

Gary King <[email protected]> Tue, 5 Feb 2008 09:14:56 -0500
Newsgroups gmane.lisp.cclan.general
Message-ID <[email protected]>
Robert Goldman pointed out that the current ASDF manual doesn't  
correctly describe how to include version dependency in an ASDF system  
definition. In particular, the grammar specifies that the  depends-on  
option should take a list of simple-component-names (which aren't,  
BTW, defined). This provides no means to specify versions at all and  
guessing at something like

   :depends-on ((:system "foo" :version "1.2.0"))

looks reasonable but won't work. Robert did the spelunking to figure  
out that the correct syntax is:

   :depends-on ((:version "foo" "1.2.0"))

The patch below attempts to rectify the documentation. I'll commit  
this unless there is much gnashing of teeth.

Index: asdf.texinfo
===================================================================
RCS file: /cvsroot/cclan/asdf/asdf.texinfo,v
retrieving revision 1.8
diff -u -w -u -r1.8 asdf.texinfo
--- asdf.texinfo	2 Jun 2007 02:44:59 -0000	1.8
+++ asdf.texinfo	5 Feb 2008 14:07:56 -0000
@@ -337,7 +337,7 @@
          | :explain method-form
  	| :output-files  method-form
          | :operation-done-p method-form
-        | :depends-on ( {simple-component-name}* )
+        | :depends-on ( {dependency-def}* )
  	| :serial [ t | nil ]
          | :in-order-to ( {dependency}+ )

@@ -348,11 +348,18 @@

  component-type := :module | :file | :system | other-component-type

+dependency-def := simple-component-name
+               | ( :feature name )
+               | ( :version simple-component-name version-specifier)
+
  dependency := (dependent-op {requirement}+)
  requirement := (required-op {required-component}+)
               | (feature feature-name)
  dependent-op := operation-name
  required-op := operation-name | feature
+
+simple-component-name := string
+                      |  symbol
  @end verbatim

  @subsection Serial dependencies

--
Gary Warren King, metabang.com
Cell: (413) 559 8738
Fax: (206) 338-4052
gwkkwg on Skype * garethsan on AIM





-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/