[Mono-list] generating html docs

[Jonathan Pryor]

On Oct 19, 2011, at 12:48 PM, Ian Norton wrote:
> This is all very cool except it seems that webdoc will only let me serve docs installed in my mono prefix rather than an arbitrary folder, this means I've had to give my script that generates nightly docs has to have an entry in sudoers.

Not true, it's just not at all documented. :-)

Edit webdoc/Global.asax [0] and change the RootTree.LoadTree() [1] call to have a full path name:

	help_tree = RootTree.LoadTree ("/path/to/your/prefix");

The /path/to/your/prefix directory needs to contain two things:

1. A "monodoc.xml" file (you can just copy ye normal /usr/lib/monodoc/monodoc.xml)
2. A "sources" directory, which contains your .source/.tree/.zip files that you want to host.

 - Jon

[0] https://github.com/mono/mono-tools/blob/master/webdoc/Global.asax#L13
[1] https://github.com/mono/mono/blob/master/mcs/tools/monodoc/Monodoc/provider.cs#L863