W3C home > Mailing lists > Public > public-diselect-editors@w3.org > January to March 2007

Content Selection Primer sec. 4.1.1 XML syntax and terminology, and editorial errors

From: Daniel Barclay <daniel@fgm.com>
Date: Tue, 30 Jan 2007 18:04:10 -0500
Message-ID: <45BFCEEA.2060406@fgm.com>
To: public-diselect-editors@w3.org

Regarding the Content Selection Primer draft at
http://www.w3.org/TR/2007/WD-cselection-primer-20070109/ :

Section 4.1.1 says:

    ... The characters &gt; represent the way that the >symbol
    must be written to be syntactically valid within an XML
    document.  The symbol > is reserved in XML to identify the
    start of an element.

Note the effective syntax error (a ">" character identifies
an _end_; "<" is what identifies the start).

And it's the end of a _tag_, not the end of an _element_.

Also, note the missing space in ">symbol" in the first quoted
sentence.

Additionally, the string "&gt;" should be quoted.

(I think the greater-than character should be quoted instead
of being set off only by being in bold type, but I can't make
that argument as strongly.  The base argument is that that's
standard English style.  An additional argument is that a
quoted form would survive a text-only cut and paste.  A
stronger version of that is that a quoted form would still
be visible when regular and bold text isn't rendered
differently, e.g., at small font sizes, or in a text-only
browser.)



Daniel
Received on Tuesday, 30 January 2007 23:04:25 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:11:10 GMT