[Mono-docs-list] Rendering <example/> blocks

[Joshua Tauberer]

 > 2.  Modify Colorizer.Colorize so that it always escapes XML entities,
 > even for unrecognized languages.  This seems reasonable and
 > straightforward to me, but could possibly prevent some functionality
 > (such as directly emitting HTML into example, such as custom <font/>s,
 > <span/>s, etc.).

This is my preference.  <example> blocks should be able to be rendered 
with or without the colorizer so that we can still get offline HTML 
output without the help of extension functions.   But, there is too much 
escaping going on.

The example blocks in the files should be considered as having raw code, 
not HTML.  The renderer should take care of making sure that &lt;'s come 
through as less than signs in the final output.  So, you shouldn't 
double-esacpe.

> I've done this in a local copy, but I'm unable to test it.  (For reasons
> I can't fathom, mono prefers loading the monodoc.dll that's in the GAC
> than the newer one in the current directory.  I've got to figure out how
> to disable this behavior...)

I usually: export MONO_PATH=. and then mono browser.exe.

> As a side note, the xml colorizer seems borked within monodoc.  It
> doesn't color the text, but inserts the colors inline with the text; for
> example, this:

The one extension function I didn't write... :)  Maybe it's a bug in 
XSLT or streams or something.

-- 
- Joshua Tauberer

http://taubz.for.net

** Nothing Unreal Exists **