[Bug 1386] New: [XQuery] some editorial comments on A.2.2.2 Explicit Whitespace Handling

http://www.w3.org/Bugs/Public/show_bug.cgi?id=1386

           Summary: [XQuery] some editorial comments on A.2.2.2 Explicit
                    Whitespace Handling
           Product: XPath / XQuery / XSLT
           Version: Last Call drafts
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XQuery
        AssignedTo: chamberl@almaden.ibm.com
        ReportedBy: jmdyck@ibiblio.org
         QAContact: public-qt-comments@w3.org


A.2.2.2 Explicit Whitespace Handling

[See a later comment for suggested alternate wording.]

(whole section)
    Given that there's only one 'ws:' notation now, you could reduce some of the
    repetition.

"if EBNF rule"
    Insert "an"

"do not inherit"
    Do not inherit what? You mean "are not inherited".

"the rule does not automatically apply"
    Change "rule" to "notation" or "marking".

"ws:explicit"
    insert space after colon

"S explicitly notates where whitespace is allowed"
    'S' isn't the only such symbol. There's also Char and [^abc].

"Whitespace is not freely allowed in the direct Constructor productions, but is
specified explicitly in the grammar, in order to be more consistent with XML."
    Start the sentence with "For example,". (Before "ws" annotations were
    introduced, the sentence was normative, but now it's just rephrasing the
    effect of some of the "ws" markings.)

    Change "allowed in" to "allowed by".

    Change "Constructor" to use lower case 'c'.

Received on Wednesday, 11 May 2005 07:40:23 UTC