[Mono-docs-list] Proposing a new documentation subsystem
jonpryor at vt.edu
Mon Dec 10 15:12:01 EST 2007
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).
More information about the Mono-docs-list