Re: [relax-ng] Conversion of comments between the compact and the XMLsyntax

[James Clark <jjc@jclark.com>]

> It seems to me that the annotation should be included in what is
> described (especially if you want to extract documentation) and that if
> I want to document a complex regular expression within a pattern, the
> annotation should be included in the "pattern" element rather than
> following it.

Why?  The spec (DTD Compatibility) explicitly allows a:documentation to 
follow the RELAX NG element to which it applies.  This done precisely to 
allow annotation of param/value/name.

James