Re: Stock Items Deprecation

[Emmanuele Bassi <ebassi gmail com>]

hi Murray;

On 17 July 2013 10:47, Murray Cumming <murrayc murrayc com> wrote:
> On Tue, 2013-07-02 at 09:41 -0400, William Jon McCann wrote:
> > As some of you may have noticed we have recently deprecated Stock
> > Items in master.
> >
> >
> > Some details on this change may be found here:
> > https://docs.google.com/document/d/1KCVPoYQBqMbDP11tHPpjW6uaEHrvLUmcDPqKAppCY8o/pub
> >
> >
> > Please let us know what you think.
>
> This deprecated several classes (GtkIconFactory, GtkIconSet,
> GtkIconSource, GtkImageMenuItem, GtkAction, GtkUIManager).
>
> But their overview documentation does not mention that the whole API is
> deprecated. And the deprecation comments for the individual methods just
> say that they are deprecated without any further advice. For instance:
> https://developer.gnome.org/gtk3/unstable/GtkUIManager.html#gtk-ui-manager-new

I'm sure documentation patches are welcome; I'll gladly review them.

in general, GtkUIManager should be replaced by GtkBuilder, so that
could be added to the long description of the class instead of each
public entry point in the API. for GtkIcon* API, the replacement has
been named theme icons, and has been so for a while.

ciao,
 Emmanuele.

--
W: http://www.emmanuelebassi.name
B: http://blogs.gnome.org/ebassi/