[Mono-docs-list] Re: [Gtk-sharp-list] MonoDoc Issues

Jonathan Pryor jonpryor@vt.edu
Sun, 04 Jul 2004 17:35:23 -0400

On Sun, 2004-07-04 at 15:50, Brian Kerrick Nickel wrote:
> > 1.  MonoDoc doesn't like properly escaped XML code.
> I haven't checked it but this may not be the case. The < and >
> entities need to be defined in the XML doctype. If they aren't defined,
> they are invalid and result in broken XML. In the HTML 3.2 doctype these
> entities are declared as follows:

Uh, no.  < and > are part of the XML standard, and are *required*
merely to escape < and >.

See: http://www.w3.org/TR/2004/REC-xml-20040204/#syntax

        The ampersand character (&) and the left angle bracket (<) MUST
        NOT appear in their literal form, except when used as markup
        delimiters, or within a comment, a processing instruction, or a
        CDATA section. If they are needed elsewhere, they MUST be
        escaped using either numeric character references or the strings
        "&amp;" and "&lt;" respectively. The right angle bracket (>) MAY
        be represented using the string "&gt;", and MUST, for
        compatibility, be escaped using either "&gt;" or a character
        reference when it appears in the string "]]>" in content, when
        that string is not marking the end of a CDATA section.

And also: http://www.w3.org/TR/2004/REC-xml-20040204/#sec-predefined-ent

Finally, &#60;...&#62; doesn't work within Monodoc either.  It exhibits
the same behavior as &lt;...&gt; -- that is, nothing is displayed unless
there is a space following the &lt;.

 - Jon