RE: [relax-ng] Compact Syntax Tutorial available

["Mike Fitzgerald" <mike@wyeast.net>]

Fine on all counts. -Mike

> -----Original Message-----
> From: James Clark [mailto:jjc@jclark.com]
> Sent: Tuesday, March 25, 2003 7:06 PM
> To: Mike Fitzgerald
> Cc: RELAX NG List
> Subject: Re: [relax-ng] Compact Syntax Tutorial available
> 
> 
> Mike Fitzgerald wrote:
> 
> > Section 1.
> > current: "The DTD would be as follows:"
> > suggest: "The DTD (an internal subset) would be as follows:"
> 
> OK, but I prefer "(as an internal subset)".
> 
> > also suggest: You mention # at the end of the section. You 
> could incorporate
> > # into at least one of the samples in sec. 1.
> 
> I think I'll just add another example with some comments.
> 
> > Section 4.
> > current: "However, recursive references must be within an element."
> > suggest: "However, recursive references must be within an element
> > definition."
> 
> OK, but should be "element pattern" rather than "element definition".
> 
> > Section 6.
> > current: "normalization automatically performed by XML"
> > suggest: "normalization automatically performed by an XML processor"
> 
> OK.
> 
> > Section 15.
> > current: "This would match a XML document such as:"
> > suggest: "This would match a document such as:"
> 
> OK.
> 
> > A.
> > suggest: You could list the keywords in list rather than a block.
> 
> OK.
> 
> > B.
> > current: "Also RELAX NG does not define a way for an XML document to
> > associate itself with a RELAX NG pattern."
> > suggest: "Also RELAX NG does not define a way for an XML document to
> > associate itself with a RELAX NG pattern as a document type 
> declaration does
> > with a DTD."
> 
> How about:
> 
> Also, whereas an XML document can associate itself with a DTD
> using a DOCTYPE declaration,
> RELAX NG does not define a way for an XML document to associate
> itself with a RELAX NG pattern.
> 
> James
> 
> 
>