[cxml-devel] documentation string on `sax:start-element'

[Sean Champ]

Hello,

I was trying to make some documentation about CXML, then in  regards to the
SAX API made avaialable with CXML. I noticed the following, in the
documentation string for the generic function SAX:START-ELEMENT :

   The attributes parameter is a list (in arbitrary order) of instances of
   the `attribute' structure class. The for their namespace-uri and local-name
   properties, the same rules as for the element name apply. Additionally,
   namespace-declaring attributes (those whose name is "xmlns" or starts with
   "xmlns:") are only included if *namespace-prefixes* is non-nil.

Having CXML loaded, but I was not able to find a variable named
*NAMESPACE-PREFIXES*, in any package.

I have noticed that there is the variable SAX:*NAMESPACE-PROCESSING*. My
looking briefly at the CXML source text of a method to SAX:START-ELEMENT, it
appeared that that would be the name of the variable to which the
documentation string would now refer.

I've made a diff for the matter. The name of the variable in that
documentation string is revised, in the diff, and any end-of-line whitespace
is removed from the file. XEmacs automaticaly pruned the whitespace, when I
wrote the file -- using the 'nuke-trailing-whitespace' lib, here.


Danke


--
Sean Champ
-------------- next part --------------
Index: sax-handler.lisp
===================================================================
RCS file: /project/cxml/cvsroot/cxml/xml/sax-handler.lisp,v
retrieving revision 1.5
diff -p -u -r1.5 sax-handler.lisp
--- sax-handler.lisp	28 Aug 2006 13:41:41 -0000	1.5
+++ sax-handler.lisp	9 Sep 2006 09:12:27 -0000
@@ -11,15 +11,15 @@
 
 ;;; Redistribution and use  in source and binary   forms, with or  without
 ;;; modification, are permitted provided that the following conditions are
-;;; met:                                                                  
-;;; 								      
+;;; met:
+;;;
 ;;; 1. Redistributions  of  source  code  must retain  the above copyright
-;;;    notice, this list of conditions and the following disclaimer.      
-;;; 								      
+;;;    notice, this list of conditions and the following disclaimer.
+;;;
 ;;; 2. Redistributions in  binary form must reproduce  the above copyright
 ;;;    notice, this list of conditions and the following disclaimer in the
 ;;;    documentation and/or other materials provided with the distribution
-;;; 								      
+;;;
 ;;; THIS  SOFTWARE   IS PROVIDED ``AS  IS''   AND ANY  EXPRESS  OR IMPLIED
 ;;; WARRANTIES, INCLUDING, BUT NOT LIMITED  TO, THE IMPLIED WARRANTIES  OF
 ;;; MERCHANTABILITY  AND FITNESS FOR A  PARTICULAR PURPOSE ARE DISCLAIMED.
@@ -60,7 +60,7 @@
            #:attribute-qname
            #:attribute-value
            #:attribute-specified-p
-	   
+
 	   #:start-document
 	   #:start-prefix-mapping
 	   #:start-element
@@ -181,7 +181,7 @@ of the `attribute' structure class. The 
 local-name properties, the same rules as for the element name
 apply. Additionally, namespace-declaring attributes (those whose name
 is \"xmlns\" or starts with \"xmlns:\") are only included if
-*namespace-prefixes* is non-nil.")
+sax:*namespace-processing* is non-nil.")
   (:method ((handler t) namespace-uri local-name qname attributes)
     (declare (ignore namespace-uri local-name qname attributes))
     nil))