This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 29664 - [SER31] 9.1.17 JSON Output Method: the json-node-output-method Parameter
Summary: [SER31] 9.1.17 JSON Output Method: the json-node-output-method Parameter
Status: RESOLVED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: Serialization 3.1 (show other bugs)
Version: Candidate Recommendation
Hardware: PC Windows NT
: P2 normal
Target Milestone: ---
Assignee: C. M. Sperberg-McQueen
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL: https://www.w3.org/XML/Group/qtspecs/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-05-26 09:30 UTC by Tim Mills
Modified: 2016-07-21 18:54 UTC (History)
1 user (show)

See Also:


Attachments

Description Tim Mills 2016-05-26 09:30:48 UTC
In this section we read

"A node in the data model instance is serialized to a JSON string by outputting the result of serializing the node using the method specified by the json-node-output-method parameter. If the json-node-output-method parameter is set to xml or xhtml then the node is serialized with the additional serialization parameter omit-xml-declaration set to yes."

It's not clear whether the serialization settings for the chosen json-node-output-method are inherited from those of the (active) JSON output method, or take default values for the selected node output method.

Is there a reason for not always requiring that omit-xml-declaration is always set to "yes", since it has no effect on the "html" or "text"?   It seems unlikely that implementation-defined serialization methods would wish to include an XML declaration.
Comment 1 C. M. Sperberg-McQueen 2016-07-07 15:42:45 UTC
The editors propose the following changes:

1 The third bullet item in the list at the beginning of section 9 should change from:

  A node in the data model instance is serialized to a JSON string 
  by outputting the result of serializing the node using the method 
  specified by the json-node-output-method parameter. If the 
  json-node-output-method parameter is set to xml or xhtml then the 
  node is serialized with the additional serialization parameter 
  omit-xml-declaration set to yes.

to:

  A node in the data model instance is serialized to a JSON string by
  outputting the result of serializing the node using the method
  specified by the json-node-output-method parameter.  The node is
  serialized with the serialization parameter omit-xml-declaration set
  to yes and with no other serialization parameters set.

2 The following sentence should be inserted into section 9.1, before the heading for section 9.1.1:

  9.1:  When nodes are serialized using the JSON output method, 
  serialization is delegated to the output method specified by the 
  json-node-output-method serialization parameter.  The 
  omit-xml-declaration parameter is set to 'yes', and no other 
  serialization parameters are passed down to the serialization 
  method responsible for serializing the node.
Comment 2 Andrew Coleman 2016-07-21 18:54:24 UTC
At the meeting on 2016-07-19, the WG agreed to adopt the proposal in comment #1.
The changes have now been applied