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/