W3C home > Mailing lists > Public > www-dom@w3.org > April to June 2011

[DOMCore] DocumentType: optional publicId and systemId

From: David Flanagan <dflanagan@mozilla.com>
Date: Thu, 02 Jun 2011 14:12:34 -0700
Message-ID: <4DE7FCC2.3060609@mozilla.com>
To: www-dom@w3.org
5.7 includes this text:

> When a |DocumentType 
> <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#documenttype>| 
> node is created, its name 
> <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-doctype-name> 
> is always given. Unless explicitly given when a |DocumentType 
> <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#documenttype>| 
> node is created, its public ID 
> <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-doctype-publicid> 
> and system ID 
> <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-doctype-systemid> 
> are the empty string.
>

But the IDL for DOMImplementation.createDocumentType() is:

>    DocumentType  <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#documenttype>  createDocumentType  <http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domimplementation-createdocumenttype>([TreatNullAs=EmptyString] DOMString qualifiedName, DOMString publicId, DOMString systemId);

Shouldn't the publicId and systemId arguments be annotated 
[TreatUndefinedAs=EmptyString]?  And maybe also 
[TreatNullAs=EmptyString]?  Or maybe they should just be declared 
optional and the textual description of createDocumentType should be 
updated to specify the empty string defaults.

     David
Received on Thursday, 2 June 2011 21:13:03 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 22 June 2012 06:14:07 GMT