[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