W3C home > Mailing lists > Public > public-xml-processing-model-wg@w3.org > September 2008

Optional options w/o defaults on built-in steps

From: Henry S. Thompson <ht@inf.ed.ac.uk>
Date: Fri, 05 Sep 2008 11:54:42 +0100
To: public-xml-processing-model-wg@w3.org
Message-ID: <f5b1vzyamml.fsf@hildegard.inf.ed.ac.uk>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

We have 67 of these (!) -- 31 after merging duplicates:

Here's my recommended disposition, but please review this, as some of
these are not completely straightforward. . :

p:count
 limit Add select='0'
p:directory-list
 include-filter Leave as is -- empty not the same as absent
 exclude-filter    ditto
p:escape-markup
 cdata-section-elements Add select='""' [same as XSLT2]
 doctype-public Leave as is [QTS says may be absent]
 doctype-system           ditto
 escape-uri-attributes  Add select="'false'"
 include-content-type   Add select="'true'" plus remark that should
                        be ignored unless method='xhtml' or method="'html'"
 media-type Add prose saying "if not specified, per method:
                                 xml: text/xml
                                 html or xhtml: text/html
                                 text: text/plain
                                 otherwise: implementation defined"
 standalone             Add select="'omit'", to fit with o-x-d='true'
 undeclare-prefixes Leave as is (any default might cause errors wrt version)
p:exec
 args Add select='""'
 cwd Leave as is -- relies on absence/empty distinction 
 byte-order-mark  Add prose saying "if not specified, per encoding:
                                      UTF-16: true
                                      all others: false"
 cdata-section-elements As above
 doctype-public As above
 doctype-system As above
 encoding Add prose saying "if not specified, implementation-defined,
                            but in the case of the xml and xhtml
                            methods it must be either UTF-8 or UTF-16."
 escape-uri-attributes As above
 include-content-type As above
 media-type As above
 normalization-form "'none'"
 omit-xml-declaration "'true'"
 standalone "'omit'"
 undeclare-prefixes As above
p:hash
 version Already specified in the prose, no change required
p:http-request
 byte-order-mark As above
 cdata-section-elements As above
 doctype-public As above
 doctype-system As above
 encoding As above
 escape-uri-attributes As above
 include-content-type As above
 media-type As above
 normalization-form As above
 omit-xml-declaration As above
 standalone As above
 undeclare-prefixes As above
p:load
 dtd-validate Add select="'false'"
p:make-absolute-uris
 base-uri Leave as is -- empty not the same as absent
p:namespace-rename
 from Leave as is -- empty not the same as absent
 to Leave as is -- empty not the same as absent
 elements-only Add select="'false'"
p:store
 href Add select="''" (implied by prose) and add prose lower down as follows:
                             "The value of the href option may be
                              relative, in which case it will be
                              resolved against the base URI of its
                              p:option element or parent before use."
 byte-order-mark As above
 cdata-section-elements As above
 doctype-public As above
 doctype-system As above
 encoding As above
 escape-uri-attributes As above
 include-content-type As above
 media-type As above
 normalization-form As above
 omit-xml-declaration As above
 standalone As above
 undeclare-prefixes As above
p:unescape-markup
 namespace Leave as is -- empty not the same as absent
 content-type Wrong as is -- change to select="'text/xml'", and in prose
 encoding Leave as is -- empty not the same as absent
 charset Add select="'UTF-8'" and remove the prose to that effect,
                              also correcting "using the specified
                              encoding" to "using the encoding named
                              by the value of the charset option".
p:uuid
 version Leave as is, prose already covers
p:wrap
 group-adjacent Leave as is -- empty not the same as absent
p:wrap-sequence
 group-adjacent Leave as is -- empty not the same as absent
p:xsl-formatter
 content-type Leave as is, prose already covers
p:xslt
 initial-mode Leave as is -- empty not the same as absent
 template-name Leave as is -- empty not the same as absent
 output-base-uri Leave as is, prose already covers
 version Leave as is, prose already covers

Also note that the prose for p:directory-list, p:load,
p:make-absolute-uris, p:xslt and p:xsl-formatter needs to be changed
by the addition of the words "or parent" or similar to phrases along
the lines of "if relative, [it] will be resolved against the base URI
of its p:option element", to allow for the shorthand form of the
relevant option.
- -- 
       Henry S. Thompson, School of Informatics, University of Edinburgh
                         Half-time member of W3C Team
      10 Crichton Street, Edinburgh EH8 9AB, SCOTLAND -- (44) 131 650-4440
                Fax: (44) 131 651-1426, e-mail: ht@inf.ed.ac.uk
                       URL: http://www.ltg.ed.ac.uk/~ht/
[mail really from me _always_ has this .sig -- mail without it is forged spam]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.6 (GNU/Linux)

iD8DBQFIwQ/ykjnJixAXWBoRAlNyAJ99BqBHH6hkOR1bXuJFlfYte5gkywCfYvLf
GJIcdus/rjAQ7CtrGOXvV2c=
=4P0D
-----END PGP SIGNATURE-----
Received on Friday, 5 September 2008 10:55:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 5 September 2008 10:55:18 GMT