W3C home > Mailing lists > Public > public-qt-comments@w3.org > November 2015

[Bug 29270] [SER31] Adaptive Serialization: omit-xml-declaration

From: <bugzilla@jessica.w3.org>
Date: Tue, 17 Nov 2015 02:58:36 +0000
To: public-qt-comments@w3.org
Message-ID: <bug-29270-523-kqB6xuj4cm@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=29270

--- Comment #1 from C. M. Sperberg-McQueen <cmsmcq@blackmesatech.com> ---
At tomorrow's joint call the editors will propose a clarification 
consisting of a note to be added to section 10.1.6:

  Note:

  If these parameters call for an XML declaration to be serialized, then an 
  XML declaration is to be output each time the Adaptive output method
delegates 
  the serialization of a node to the XML output method. If several node items 
  appear in the sequence to be serialized or as values in maps or arrays to be 
  serialized, then the output will contain several XML declarations.

The rationale is simple:  a later process may split the output of the adaptive
method into multiple files or resources; it may be convenient in such a case to
have an XML declaration in each XML fragment.  If multiple declarations are not
desired, the user need only set omit-xml-declaration="yes".  (The most obvious
reason for not wanting an XML declaration before each XML fragment would be
that the result will not be well-formed XML. But the output of the adaptive
method is not expected to be well-formed XML in any case.)

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
Received on Tuesday, 17 November 2015 02:58:39 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 17 November 2015 02:58:39 UTC