W3C home > Mailing lists > Public > www-xml-schema-comments@w3.org > April to June 2004

Re: XML schema draft comments: pt.1 4.2.1 <include>d

From: Daniel Barclay <daniel@fgm.com>
Date: Wed, 16 Jun 2004 14:20:35 -0400
Message-ID: <40D08F73.7070404@fgm.com>
To: Daniel Barclay <daniel@fgm.com>
Cc: www-xml-schema-comments@w3.org

I wrote:

> Regarding the draft at
> http://www.w3.org/TR/2004/PER-xmlschema-1-20040318/:
> 
> Section 4.2.1 says:
> 
>   ... all the components of all the ·XML Schemas· corresponding
>   to any <include>d schema documents.
> 
> AGH!!!
> 
> The notation "<include>" has meant "include element."  Using it
> as a verb (or punctuation the verb "include" as an element name)
                           ^ punctuating
> is confusing, or at least jarring.

Especially consider the density of occurrences of that form in
the next sentence:

   Such included schema documents must either (a) have the same
   targetNamespace as the <include>ing schema document, or (b) no
   targetNamespace at all, in which case the <include>d schema
   document is converted to the <include>ing schema document's
   targetNamespace.


> Just say "corresponding to any included schema documents" 

... as already done at the beginning of that second sentence.

Daniel
Received on Wednesday, 16 June 2004 14:21:05 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 5 February 2014 07:15:34 UTC