[Gtk-sharp-list] gtk# docs assembly information

Todd Berman tberman@off.net
Fri, 03 Dec 2004 14:14:04 -0800


On Fri, 2004-12-03 at 17:02 -0500, John Luke wrote:
> On Fri, 2004-12-03 at 13:35 -0600, Mike Kestner wrote:
> > On Tue, 2004-11-30 at 19:08 -0500, John Luke wrote:
> > > Hello,
> > > 	Some of the docs state the class is 'Assembly: gtk-sharp 0.0.0.0 (in
> > > gtk-sharp.dll)' it would be nice to make sure that the ones that existed
> > > in 1.0 were marked as so.  The key is also inconsistently included.
> > > Mostly this was caused by the original updater did not update this info.
> > > I don't know if the newer versions do or not.
> > > 
> > > It's probably the matter of substituting 0.0.0.0 for 1.0.0.0 as the
> > > newer stuff seems to be getting 2.0.0.0 fine. sed would work fine for
> > > the versions, but I thought someone want want to make a quick tool to do
> > > both at once.
> > 
> > There's multiple issues probably.  The assembly version reported for all
> > these should probably be 2.0.0.0, in svn trunk.  We also need a
> > mechanism to mark API as new in a particular API version.  I don't know
> > if monodoc already automatically marks "Obsolete" API, if not, that
> > would be a nice feature as well.
> 
> Would it not be right that the AssemblyVersion in the docs is the
> version in which it was added?  At least that is how I was thinking (the
> equivalent of gtk's since $version).  Monodoc handles [Obsolete] through
> the updater I believe.
> 

No, for docs shipping with 2.0.0.0 it should be 2.0.0.0 globaly, as that
is the version of the assembly the documentation corresponds with.

And I believe Mike was talking about monodoc displaying some fu that
shows that a specific method/class/thing is Obsolete.

--Todd