Re: [relax-ng] Compact Syntax Tutorial available

[James Clark <jjc@jclark.com>]

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