[PATCH] Monodocer <since/> support

Jonathan Pryor <[email protected]> Thu, 12 Oct 2006 08:05:48 -0400
Newsgroups gmane.comp.gnome.mono.documentation
Message-ID <[email protected]>
On Wed, 2006-10-11 at 14:08 -0500, Mike Kestner wrote:
> On Wed, 2006-10-11 at 07:28 -0400, Jonathan Pryor wrote:
> 
> > We could just do `--since "Gtk# 2.10"', and all new types/members would
> > get a "<since version="Gtk# 2.10" /> element inserted.  It would *only*
> > apply to added types/members, and there is no worry about
> > checking/comparing assembly versions or anything like that.
> > 
> > If `--since' isn't provided, then <since/> is never generated.
> > 
> > This is less "automagic", but it provides more control as well.

Attached is a patch+unit tests that implements this support.

Permission to commit?

> The task of adding since tags to existing doc members is outside the
> realm of monodocer, in my opinion.  It is a one-time task that is better
> served by a single tool like DVP.  We should probably just get it up to
> speed with the current monodocer signature code and turn it loose on the
> classlib assemblies.  Once they are seeded, monodocer can insert since
> tags with new stubs.
> 
> I went ahead and checked in DocVersionatorPlus.cs to monodoc/tools in
> the event anyone wants to play around with it.

Given that it was originally a fork, it would probably be nice to
refactor monodocer to use a shared library which is shared between
DocVersionatorPlus (which needs a better name) and monodocer.

Not sure if/when I'll get around to that, though.

 - Jon

_______________________________________________
Mono-docs-list maillist  -  [email protected]
http://lists.ximian.com/mailman/listinfo/mono-docs-list
monodocer-since.patch.gz (application/x-gzip, 7.4 KB) - not displayed