W3C home > Mailing lists > Public > public-xml-core-wg@w3.org > April 2011

RE: [Fwd: [xml-model] Minor wording ambiguity]

From: Grosso, Paul <pgrosso@ptc.com>
Date: Thu, 7 Apr 2011 10:26:16 -0400
Message-ID: <9B2DE9094C827E44988F5ADAA6A2C5DA0283A6C7@HQ-MAIL9.ptcnet.ptc.com>
To: <public-xml-core-wg@w3.org>
I was trying to reword this sentence to avoid the ambiguity when
I realized I wasn't sure what it means for a "document [to] use 
processing instruction information items."

Does that mean that a document conforming to this spec must not 
contain such, or if it does contain such, they must be ignored
by an xml-model processor and/or the application?

I believe we want it to be a document conformance issue, in which
case I suggest we reword it to say:

 Documents conforming to this specification *must not* contain
 processing instruction information items with the [target]
 property xml-model that are not xml-model processing instructions.

and I'm not sure if we need to say "conforming to this specification"
at all, though I put it into my suggestion for clarity.

Thoughts?

paul

> -----Original Message-----
> From: public-xml-core-wg-request@w3.org [mailto:public-xml-core-wg-
> request@w3.org] On Behalf Of Jirka Kosek
> Sent: Thursday, 2011 April 07 8:40
> To: public-xml-core-wg@w3.org
> Subject: [Fwd: [xml-model] Minor wording ambiguity]
> 
> FYI -- I'm not sure if someone periodically checking xml-editor mailing
> list.
> 
> I'm not native speaker, but to me this seems as a little bit
> exaggerated
> -- although from grammar point of view Tony is right and there is
> ambiguity, I don't think that there is any ambiguity in the
> interpretation of the statement. Also I don't think that proposed
> change
> of wording will lead to more digestible text.
> 
> 				Jirka
> 
> -------- Original Message --------
> Subject: [xml-model] Minor wording ambiguity
> Resent-Date: Mon, 04 Apr 2011 17:03:11 +0000
> Resent-From: xml-editor@w3.org
> Date: Tue, 29 Mar 2011 15:40:57 +0100 (IST)
> From: Tony Graham <tgraham@mentea.net>
> To: xml-editor@w3.org
> 
> In http://www.w3.org/TR/2010/NOTE-xml-model-20100415/ in the text:
> 
>    Documents must not use processing instruction information items with
> the
>    [target] property xml-model if they are not xml-model processing
>    instructions.
> 
> the "they" could refer to either "documents" or "processing instruction
> information items".
> 
> Up until I read "xml-model processing instructions", I thought "they"
> were
> documents.  I suggest changing this "they" to "the information items"
> in
> any future edition.
> 
> Regards,
> 
> 
> Tony Graham
> Mentea.
> 
> 
> --
> ------------------------------------------------------------------
>   Jirka Kosek      e-mail: jirka@kosek.cz      http://xmlguru.cz

> ------------------------------------------------------------------
>        Professional XML consulting and training services
>   DocBook customization, custom XSLT/XSL-FO document processing
> ------------------------------------------------------------------
>  OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
> ------------------------------------------------------------------

Received on Thursday, 7 April 2011 14:26:43 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 7 April 2011 14:26:44 GMT