W3C home > Mailing lists > Public > public-qt-comments@w3.org > October 2004

Re: ORA-SE-307-E: "An xml output method" is better than "the xml output method" (qt-2004Feb1038-01)

From: Henry Zongaro <zongaro@ca.ibm.com>
Date: Fri, 15 Oct 2004 16:14:34 -0400
To: Stephen.Buxton@oracle.com
Cc: public-qt-comments@w3.org
Message-ID: <OF30BF162D.140B3249-ON85256F2E.00619C18-85256F2E.006F30A3@ca.ibm.com>

Steve,

     In [1], you submitted the following comment on the Last Call Working 
Draft of XSLT 2.0 and XQuery 1.0 Serialization.

<<
SECTION 4: XML output method

The first four words of this section are "The xml output method".
The specification is non-constructive and non-deterministic. 
This is a good thing, but it means that there is more than one
acceptable algorithm for an xml output method.  Consequently
calling it "the xml output method" is misleading.  It would be
better to say explicitly that the specification is non-constructive
and non-deterministic, and talk about the requirements on 
"an xml output method" rather than "the xml output method".
Similarly, the title might be "XML output methods" rather than
the singular.
>>

     Thank you for your comment, which I am handling editorially.

     You make a good point.  I have added a paragraph to the end of the 
section entitled "Serialization Parameters" indicating that some 
unspecified details of the output methods are implementation-dependent, in 
an attempt to make it clear that the specifications of the output methods 
are non-constructive.

     However, I've decided not to accept your suggestion to refer to "an 
xml output method" rather than "the xml output method."  I'm inclined to 
regard this as a single method that is parameterized by both serialization 
parameters and implementation-defined and -dependent behaviours.  I think 
using the indefinite article would be confusing for readers.

     I would appreciate it if you could check the next draft of 
serialization to verify whether this resolution is acceptable to you.

Thanks,

Henry
[1] 
http://lists.w3.org/Archives/Public/public-qt-comments/2004Feb/1038.html
------------------------------------------------------------------
Henry Zongaro      Xalan development
IBM SWS Toronto Lab   T/L 969-6044;  Phone +1 905 413-6044
mailto:zongaro@ca.ibm.com
Received on Friday, 15 October 2004 20:15:07 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 5 February 2014 23:39:56 UTC