Re: More documentation inconsistencies

[Emmanuele Bassi <ebassi gmail com>]

Hi;

On 16 August 2015 at 17:46, Igor Korot <ikorot01 gmail com> wrote:
> Emmanuele,
>
> On Sun, Aug 16, 2015 at 12:24 PM, Emmanuele Bassi <ebassi gmail com> wrote:
> > Hi;
> >
> > I suggest you file a bug.
> >
> > In any case, deprecation does not imply lack of support; you can still
> > use stock items — except you'll get a warning at compile time and/or
> > at run time.
>
> True.
> But it gives a wrong impression that one can use stock items here...

Why would it be a wrong impression? You *can* use stock items.

You should not be using stock items in newly written code, but that
does not mean that existing code will break. The API is correctly
documented.

It can be changed to ensure that stock IDs are discouraged, but you
can still use them.

Ciao,
 Emmanuele.

> > On 16 August 2015 at 17:09, Igor Korot <ikorot01 gmail com> wrote:
> > > Hi,
> > > In the https://developer.gnome.org/gtk3/stable/GtkFileChooserDialog.html
> > > it stays:
> > >
> > > [quote]
> > > first_button_text    stock ID or text to go in the first button, or
> > > NULL.   [allow-none]
> > > [/quote]
> > >
> > > However, if I understand correctly stock items are deprecated.
> > >
> > > So even though the function is present since 2.4, some notes should be added.
> > >
> > > Do you agree?
> > >
> > > Thank you.
> > > _______________________________________________
> > > gtk-list mailing list
> > > gtk-list gnome org
> > > https://mail.gnome.org/mailman/listinfo/gtk-list
> >
> >
> >
> > --
> > https://www.bassi.io
> > [ ] ebassi [ gmail com]



-- 
https://www.bassi.io
[ ] ebassi [ gmail com]