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

[Brian Kerrick Nickel]

> 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:

<!ENTITY amp    CDATA "&#38;"   -- ampersand          -->
<!ENTITY gt     CDATA "&#62;"   -- greater than       -->
<!ENTITY lt     CDATA "&#60;"   -- less than          -->

It would probably be useful to have such a declaration in the doc
doctype, but you could probably manage with:

        <example>
        <code lang=".config file">
        &#60;configuration&#62;
          &#60;system.diagnostics&#62;
            &#60;assert logfilename="where I want TraceListener messages to go"/&#62;
          &#60;/system.diagnostics&#62;
        &#60;/configuration&#62;</code>
        </example>


- Brian