Comments on WD-xml-c14n-20000613

Nice job! Some suggestions regarding readability follow.

http://www.w3.org/TR/2000/WD-xml-c14n-20000613
 >   By virtue of the XPath data model, Canonical XML is namespace-aware
 >   [37][Names], but it cannot and therefore does not account for
 >   namespace equivalencies via namespace prefix rewriting (see
 >   [38]below).

"See below" is ambiguous. "See following paragraph" "See Expression X", or
"See section X" with hypertext as appropriate is better.

 >   then evaluating the expression (//. | //@* |
 >   //namespace::*)[not(self::comment())]. This expression generates a
 >   node-set containing every node of the XML document except the
 >   comments.

Given the importance of this expression you may wish to set it apart from
the reset of the text and associate some token (Expression 1) with a name
that is then referenced from the following sections that presently speak of
"the default given in the Canonical XML Data Model."

 >     * An element's namespace and attribute nodes have a document order
 >       position greater than the element but less than any child node of
 >       the element.

Please define "greater" and "lesser."

 >4 Generation of Canonical XML
 >...
 >     * Comment Nodes- the opening comment symbol (<!--), the string value
 >       of the node, and the closing comment symbol (-->). Also, a
 >       trailing #xA is rendered after the closing comment symbol for
 >       comment children of the root node with a lesser document order
 >       than the document element, and a leading #xA is rendered before
 >       the opening comment symbol of comment children of the root node
 >       with a greater document order than the document element.

To what degree is "Canonical XML" the serialized result of The Expression or
the serialization of the complete document's node set? I think the content
is right but the section headings could use a slight tweak or re-org to make
the relationship between these things more clear.

 >  A.1 No Character Model Normalization
 >   form. However, most XML 1.0 processors do not perform the this

/-the-/ this

>Appendix C Acknowledgements (Non-Normative)

Acknowledgements frequently include their affiliation as well.



_________________________________________________________
Joseph Reagle Jr.   
W3C Policy Analyst                mailto:reagle@w3.org
IETF/W3C XML-Signature Co-Chair   http://www.w3.org/People/Reagle/

Received on Wednesday, 14 June 2000 12:07:16 UTC