[Mono-docs-list] [PATCH] Monodocer <since/> support

Jonathan Pryor jonpryor at vt.edu
Thu Oct 12 08:05:48 EDT 2006

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

-------------- next part --------------
A non-text attachment was scrubbed...
Name: monodocer-since.patch.gz
Type: application/x-gzip
Size: 7604 bytes
Desc: not available
Url : http://lists.ximian.com/pipermail/mono-docs-list/attachments/20061012/209643e7/attachment.gz 

More information about the Mono-docs-list mailing list