Re: GtkRecentChooser API glitch
- From: Murray Cumming <murrayc murrayc com>
- To: Emmanuele Bassi <ebassi gmail com>
- Cc: GTK Development List <gtk-devel-list gnome org>
- Subject: Re: GtkRecentChooser API glitch
- Date: Sun, 29 Jul 2007 18:49:28 +0200
On Tue, 2006-07-11 at 21:47 +0100, Emmanuele Bassi wrote:
> Hi all;
>
> Unfortunately, when importing the GtkRecent API in GTK+ I made a mistake
> and these two functions have been erroneously left inside the
> GtkRecentChooser interface API:
>
> gtk_recent_chooser_set_show_numbers()
> gtk_recent_chooser_get_show_numbers()
>
> These two functions try to set the "show-numbers" property, which is
> installed only by GtkRecentChooserMenu and it's not one of the
> properties defined by the GtkRecentChooser interface. Using these
> functions on a GtkRecentChooserMenu (or any other custom
> GtkRecentChooser implementation which defines a boolean "show-numbers"
> property) will yield the expected results, while using them on a
> GtkRecentChooser implementation that do not support the "show-numbers"
> property will result in a warning.
>
> Since we are in a stable release we can't mark those functions as
> deprecated, and we cannot remove them without breaking the API. You are
> advised not to use these functions: use the GtkRecentChooserMenu
> functions instead:
>
> gtk_recent_chooser_menu_set_show_numbers()
> gtk_recent_chooser_menu_get_show_numbers()
>
> Language binding authors should not bind those functions, but bind the
> GtkRecentChooserMenu functions instead.
>
> These functions will be marked as deprecated as soon as GTK+ will branch
> off for the 2.11/2.12 cycle,
While reviewing this change for gtkmm, I noticed that you didn't use the
"Deprecated:" syntax so these don't show up in the list of deprecated
symbols.
> so you'll have to bear with this
> inconsistency for a short period of time.
>
> Again, sorry for the mess.
>
> Ciao,
> Emmanuele.
>
--
Murray Cumming
murrayc murrayc com
www.murrayc.com
www.openismus.com
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]