Re: [Content-in-RDF] proposed changes

Shadi Abou-Zahra schrieb:
> Hi Johannes,
> 
> Johannes Koch wrote:

>> I will change the following property names:
>> xmlEncoding to declaredEncoding,
> 
> I'm OK with this, it reflects its XML name "EncodingDecl". Have you also 
> considered just "encoding"?

There may be different encodings:
* the encoding declared in the XML declaration,
* the encoding specified via byte order mark (BOM)
* the encoding specified via lower-level protocols, e.g. HTTP charset 
parameter

We also have characterEncoding.

>> xmlLeadingMisc to leadingMisc,
> 
> How about prologMisc? (XML calls the entire front-matter the "prolog" 
> and this part of it "Misc", which where the name may have derived from)

In the XML spec, everything preceding the root element (XML declaration, 
whitespace, comments, PIs, document type declaration) is the prolog. In 
our case, we need to seperate the stuff preceding the document type 
declaration from the stuff following it. That's a different thing.

>> xmlRest to rest,
> 
> The XML spec calls this "element". How about calling it "elements"?

See above, the rest is everything following the document type 
declaration, i.e. whitespace, comments, PIs, root element.

>> I don't have a name change proposal for the XMLDecl class and xmlDecl 
>> property.
> 
> I strongly suggest that we don't use only caps for differentiating 
> between the class and property names.
> 
> How about just "decl" for the property and "DeclarationOfXMLfile" for 
> the class? See below for more:
> 
> 
>> But: Maybe we can drop them and put declaredEncoding, standalone and 
>> version to ContentAsXML. In the DOM there's no interface for the XML 
>> declaration, but the corresponding properties belong to the Document 
>> interface. What do you think?
> 
> This makes sense too.

I suggest this option.

-- 
Johannes Koch
Fraunhofer Institute for Applied Information Technology FIT
Web Compliance Center
Schloss Birlinghoven, D-53757 Sankt Augustin, Germany
Phone: +49-2241-142628    Fax: +49-2241-142065

Received on Wednesday, 17 June 2009 12:06:08 UTC