[Mono-docs-list] Re: [Gtk-sharp-list] MonoDoc Issues
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 >.
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
"&" and "<" respectively. The right angle bracket (>) MAY
be represented using the string ">", and MUST, for
compatibility, be escaped using either ">" 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, <...> doesn't work within Monodoc either. It exhibits
the same behavior as <...> -- that is, nothing is displayed unless
there is a space following the <.