- From: Henry Zongaro <zongaro@ca.ibm.com>
- Date: Sun, 28 Mar 2004 18:18:19 -0500
- To: holstege@mathling.com
- Cc: public-qt-comments@w3.org
Mary,
In [1], you submitted the following comment on the Serialization last
call draft on behalf of the XML Schema WG.
Mary Holstege wrote on 2004-02-12 04:11:28 PM:
> [A] [Section 3: Serialization Parameters] This section outlines 15
> serialization parameters. These parameters have informal descriptions -
such
> as 'The value must be yes or no', etc. It is possible to describe all
the
> parameters, except 'use-character-maps', using XML Schema data types.
> Suggested descriptions are,
>
> encoding: a new datatype derived from 'xs:string'
> cdata-section-element: a list of 'xs:QName'
> doctype-system: a new datatype derived from 'xs:string'
> doctype-public: a new datatype derived from 'xs:string'
> escape-uri-attributes: 'xs:boolean'
> include-content-type: 'xs:boolean'
> indent: 'xs:boolean'
> media-type: a new datatype derived from 'xs:string'
> normalize-unicode: 'xs:boolean'
> omit-xml-declaration: 'xs:boolean'
> standalone: 'xs:boolean'
> undeclare-namespaces: 'xs:boolean'
> version: a new datatype derived from 'xs:string'
> use-character-maps: NONE (see related issue, [N])
> method: 'xs:QName'
Thanks to you and the Schema WG for this comment.
The XSL and XQuery working groups considered the comment, and agreed
that the definitions of the permissible sets of values need to be
specified more clearly. However, the working groups did not feel it was
necessary to describe the values with reference to the XML Schema data
types, as the serialization parameters are not part of an API, but merely
a formalism used between specifications.
The working groups would like to replace the descriptions of the
values of the parameters that appears in the bulleted list in Section 3,
with a table. The following is my proposed replacement.
<<
+----------------------+------------------------------------------------+
|PARAMETER NAME |PERMITTED VALUES FOR PARAMETER |
+----------------------+------------------------------------------------+
|cdata-section-elements|A list of expanded-QNames, possibly empty. |
+----------------------+------------------------------------------------+
|doctype-public |A string of Unicode characters. This parameter |
| |is optional. |
+----------------------+------------------------------------------------+
|doctype-system |A string of Unicode characters. This parameter |
| |is optional. |
+----------------------+------------------------------------------------+
|encoding |A string of Unicode characters in the range #x21|
| |to #x7E (that is, printable ASCII characters); |
| |the value should be a charset registered with |
| |the Internet Assigned Numbers Authority [IANA], |
| |[RFC2278] or begin with the characters x- or X-.|
+----------------------+------------------------------------------------+
|escape-uri-attributes |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|include-content-type |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|indent |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|media-type |A string of Unicode characters specifying the |
| |media type (MIME content type) [RFC2376]; the |
| |charset parameter of the media type must not be |
| |specified explicitly. |
+----------------------+------------------------------------------------+
|method |An expanded-QName with a null namespace URI, and|
| |the local part of the name equal to xml, xhtml, |
| |html or text, or having a non-null namespace |
| |URI. If the namespace URI is non-null, the |
| |parameter specifies an implementation-defined |
| |output method. |
+----------------------+------------------------------------------------+
|normalize-unicode |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|omit-xml-declaration |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|standalone |One of the enumerated values yes, no or none |
+----------------------+------------------------------------------------+
|undeclare-namespaces |One of the enumerated values yes or no |
+----------------------+------------------------------------------------+
|use-character-maps |A list of pairs, possibly empty, with each pair |
| |consisting of a single Unicode character and a |
| |string of Unicode characters. |
+----------------------+------------------------------------------------+
|version |A string of Unicode characters. |
+----------------------+------------------------------------------------+
>>
May I ask you to confirm that this response is acceptable to the XML
Schema WG?
Thanks,
Henry
------------------------------------------------------------------
Henry Zongaro Xalan development
IBM SWS Toronto Lab T/L 969-6044; Phone +1 905 413-6044
mailto:zongaro@ca.ibm.com
Received on Sunday, 28 March 2004 18:19:30 UTC