[Mono-docs-list] monoapi Documentation

[Jonathan Pryor]

On Wed, 2008-10-29 at 11:33 -0400, Jonathan Pryor wrote:
> After hunting around for a bit (wondering why my openSUSE monodoc had
> mono embedding documentation but not my local build), I found that
> mono/mono/docscripts generates the monoapi{.source,.tree.zip} files
> needed to display mono embedding documentation within monodoc.
...
> Thus, a question/proposal; could we:
> 
> 1. Move mono/mono/docscripts/* into mono/docs.
> 2. Change mono/Makefile.am so that docs is built *after* runtime.
>    This looks safe, as mono/docs/Makefile.am doesn't really do anything.
> 3. Always build/install the monoapi documentation as part of the normal 
>    build process.
> 4. Update the RPM .spec file to install the monoapi files
>    (necessary so that we don't "lose" the monoapi documentation between
>    2.0 and 2.2.)
> 
> (1), (2), and (4) should be quite straightforward; it's (3) I worry
> about;

Not quite as bad as I feared.

Please see the attached patch.

Thanks,
 - Jon

-------------- next part --------------
A non-text attachment was scrubbed...
Name: mono-docs.patch
Type: text/x-patch
Size: 8771 bytes
Desc: not available
Url : http://lists.ximian.com/pipermail/mono-docs-list/attachments/20081029/7916242b/attachment.bin