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

[Javier Jardón <jjardon gnome org>]

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,


-- 
Javier Jardón Cabezas