Bug 6376 - [Ser] non-normative notes
: [Ser] non-normative notes
Status: CLOSED FIXED
Product: XPath / XQuery / XSLT
Serialization 1.0
: Recommendation
: PC Windows XP
: P2 minor
: ---
Assigned To: Henry Zongaro
: Mailing list for public feedback on specs from XSL and XML Query WGs
:
:
:
:
:
  Show dependency treegraph
 
Reported: 2009-01-06 21:08 UTC by Andrew Eisenberg
Modified: 2009-06-16 15:26 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Eisenberg 2009-01-06 21:08:54 UTC
XQuery 1.0, in its Introduction, states:

"In this document, examples and material labeled as "Note" are provided for
explanatory purposes and are not normative."

Serialization is missing this statement.
Comment 1 Henry Zongaro 2009-01-06 21:55:41 UTC
It looks like the Serialization recommendation is inconsistent about its
presentation of examples.  In most cases they are not marked as "Notes."  They
are usually contained in boxes - see [1], which at least begins "For example,"
or [2], which just asks us to "Consider...."

But some examples are just contained within the normative prose without
anything to set them apart typographically - see the "media-type" parameter in
[3] or the second paragraph following the table in [3].

Obviously this should all be cleaned up for 1.1, but I doubt we'd want to issue
a 1.0 erratum.  Should it be cleaned up for the 1.0 2nd edition though?

[1]
http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#XML_VERSION
[2]
http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#xml-undeclare-NS
[3] http://www.w3.org/TR/2007/REC-xslt-xquery-serialization-20070123/#serparam
Comment 2 Jim Melton 2009-01-29 00:07:05 UTC
Even though there was not a Bugzilla entry making the corresponding comment
about the anticipated XDM 1.1, I've made the change there.  I have NOT made the
change for XDM 1.0, but will leave that to the responsible editor. 

W.R.T. the question about issuing a 1.0 erratum: We do not anticipate actually
publishing another set of 1.0 errata documents, but will shortly initiate
processing of the 2ed documents to PER status. However, some participants have
requested that the Erratum entry be created anyway for technical reasons. 
Comment 3 Michael Kay 2009-01-29 09:10:24 UTC
>W.R.T. the question about issuing a 1.0 erratum: We do not anticipate actually publishing another set of 1.0 errata documents, but will shortly initiate processing of the 2ed documents to PER status. However, some participants have requested that the Erratum entry be created anyway for technical reasons. 

I think we want traceability from the second edition documents back to the
Bugzilla entries, and by far the easiest way of doing that is to publish an
Errata document for the first edition that is synchronized with the second
edition. That's what the system was set up to achieve, after all.
Comment 4 Henry Zongaro 2009-01-29 15:44:34 UTC
Hmmm.  Taking a closer look, I see that I misread the statement that "examples
and material labeled as 'Note' are provided for explanatory purposes and are
not normative."  I took "labeled as 'Note'" to apply to both examples and
material - i.e., "examples labeled as 'Note' and material labeled as
'Note'...."  So I thought for the sake of consistency I would have to change
all examples to be labeled with "Note," but I see that XQuery 1.0 does not in
fact label its examples with Note.

With apologies for my confusion, I propose to add this sentence to the end of
the second paragraph of section 1.1 of Serialization:[1]

. In this document, material labeled as "Note" and examples are provided for
explanatory purposes and are not normative.

[1] http://www.w3.org/TR/xslt-xquery-serialization/#terminology
Comment 5 Henry Zongaro 2009-02-05 17:59:32 UTC
At its teleconference of 2009-02-05, the XSL WG considered the editorial
changes proposed in comment 4 and had no objections to making the change.
Comment 6 Henry Zongaro 2009-02-10 18:42:48 UTC
This will be erratum SE.E11.
Comment 7 Henry Zongaro 2009-06-16 15:26:42 UTC
Published in "Errata for XSLT 2.0 and XQuery 1.0 Serialization"[1] and PER
draft of "XSLT 2.0 and XQuery 1.0 Serialization (Second Edition)."[2]

[1] http://www.w3.org/XML/2007/qt-errata/xslt-xquery-serialization-errata.html
[2] http://www.w3.org/TR/2009/PER-xslt-xquery-serialization-20090421/


  翻译: