Re: When deprecating, always say what the replacement is.
- Date: Tue, 23 Feb 2010 20:28:28 +0200
- From: Claudio Saavedra <csaavedra@xxxxxxxxx>
- Subject: Re: When deprecating, always say what the replacement is.
El mar, 23-02-2010 a las 19:17 +0100, Javier Jardón escribió:
> 2010/2/23 Murray Cumming <murrayc@xxxxxxxxxxx>:
> > When we deprecate API, please remember to document what the replacement
> > is. People forget this quite often.
> >
> > A small recent example that doesn't do this:
> > http://git.gnome.org/browse/gtk
> > +/commit/?id=bb1824c131f247c2ef64f3c5f8b9ffe3885c9d90
>
> Indeed, the info about the replacements is on the deprecated
> functions/macros documentation (inline comments ;)):
>
> http://git.gnome.org/browse/gtk+/diff/gtk/gtkwidget.h?id=bb1824c131f247c2ef64f3c5f8b9ffe3885c9d90
>
> Best Regards,
What about patching gtk-doc to provide syntax for replacements?
Claudio
_______________________________________________
gtk-devel-list mailing list
gtk-devel-list@xxxxxxxxx
http://mail.gnome.org/mailman/listinfo/gtk-devel-list