Re: When deprecating, always say what the replacement is.

[Stefan Kost <ensonic hora-obscura de>]

Am 23.02.2010 20:28, schrieb Claudio Saavedra:
> El mar, 23-02-2010 a las 19:17 +0100, Javier Jardón escribió:
>> 2010/2/23 Murray Cumming <murrayc murrayc com>:
>>> 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?

It is there:

 *
 * Deprecated: <version> <replacement>
 *

Stefan

> 
> Claudio
> 
> 
> _______________________________________________
> gtk-devel-list mailing list
> gtk-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/gtk-devel-list