GNOME Bugzilla – Bug 605764
No pointer or deeper explanation in description of deprecated function.
Last modified: 2010-01-06 11:12:10 UTC
gtk_source_view_get_mark_category_pixbuf() is deprecated since 2.8, but contrary to also deprecated gtk_source_view_set_mark_category_pixbuf(), it does not have in its description which function should be used instead. In C++ bindings, when a C function gets deprecated, we mark respective method as deprecated, but inside this method a nondeprecated function is used. For example: deprecated C function: gtk_source_view_set_mark_category_pixbuf() deprecated C++ method: SourceView::set_mark_category_pixbuf() which internally calls gtk_source_view_set_mark_category_icon_from_pixbuf(). I have no idea (didn't investigated it thoroughly though) which nondeprecated function to use in place of gtk_source_view_get_mark_category_pixbuf(). It would be useful to know since distcheck in C++ bindings using mm-common uses nitpicky flags with -Werror, so compilation ends with warning about using deprecated function. Thanks.
Well, the fact is that when we added the old api we didn't think much about it and jsut added the getter. But when we revised the api to add different ways to set the image, we felt that adding all the getters was not a good idea (eg: what would get_icon_name give you if you set the icon using a pixbuf etc). We also could not think of any use cases where you need the getter, so we simply decided to drop it and deprecate the old function. So in this case there is no replacement
Thanks for explanation. In the end, I decided to change behaviour of get_mark_category_pixbuf() method to return an empty Glib::RefPtr<Gdk::Pixbuf>.
I guess we can close this.