[Mono-docs-list] Proposing a new documentation subsystem

[Jonathan Pryor]

On Sun, 2007-11-25 at 22:05 -0500, Jonathan Pryor wrote:
> Attached is a preliminary patch to add this support.  The monodocer
> change is 66 lines, and generates output like the attached
> Environment.xml.  monodocs2html has also been updated; Environment.html
> is the current output.
> 
> I should stress that this is a work-in-progress; in particular, it
> should (but doesn't) "garbage-collect" the <AssemblyVersion/> elements,
> such that if updated assembly 2.0, and a member has an
> <AssemblyVersion>2.0</AssemblyVersion> element AND the element has been
> REMOVED, the docs are not currently updated to remove this element.
> Similar things should be done to ONLY remove a member if e.g. there are
> no remaining <AssemblyVersion/> elements (which would likely obsolete
> the -ignore_extra_docs parameter if done well).

This has been committed to monodoc-HEAD, complete with support for
"garbage collecting" <AssemblyVersion/> elements on repeated invocations
of monodocer against different assembly versions (thus removing the need
for both -since and -ignore_extra_docs).

 - Jon