[Mono-list] monodoc troubles

[Jonathan Pryor]

On Thu, 2008-12-25 at 13:15 -0600, Austin Winstanley wrote:
> Where is the source for monodoc? I wouldn't mind checking it out to  
> see if it could be run in windows...

Current sources are:

http://anonsvn.mono-project.com/trunk/mcs/class/Mono.Cecil/
http://anonsvn.mono-project.com/trunk/mcs/tools/monodoc/
http://anonsvn.mono-project.com/trunk/mcs/tools/mdoc
http://anonsvn.mono-project.com/trunk/mono-tools/docbrowser/

Dependency tree:

    Mono.Cecil    monodoc
        \          / |
         \        /  |
          \      /   |    HTML
           \    /    |    /
            \  /     |   /
             \/      |  /
            mdoc   docbrowser

`mdoc' is responsible for parsing assemblies (via Mono.Cecil) into an
internal XML format, and then "assembling" the XML into .tree/.zip file
pairs which monodoc.dll understands.  docbrowser provides the actual GUI
browser to view the documentation stored within the .tree/.zip files.

The HTML bit is the biggest variance, as the docbrowser module supports
a pluggable HTML renderer model, with support for WebKit, GtkHtml,
MonoWebBrowser, and Gecko (which is often flaky).  You will want to
either install the sources for them separately or use pre-existing
packages.  Using GtkHtml is likely easiest, though.

 - Jon