Add a release note about subclassing

This is showing up in bug reports like
https://bugzilla.gnome.org/show_bug.cgi?id=762754
so better add a note that gives a hint at the solution.
This commit is contained in:
Matthias Clasen 2016-02-28 09:38:31 -05:00
parent 870a5b424f
commit 54ebe5d3c5

View File

@ -84,12 +84,11 @@ Release notes for 3.20
the element names it has and the style classes it uses. The GTK+ the element names it has and the style classes it uses. The GTK+
inspector can also be helpful in finding this information. inspector can also be helpful in finding this information.
* The GtkFileChooser interface pre-requisite changed from GtkWidget * GTK+ now uses internal subobjects (also known as gadgets) for allocating
to GObject, allowing non-widget implementations of this interface. and drawing widget parts. Applications that subclass GTK+ widgets may
This is a minor change in ABI, as apps are no longer guaranteed see warnings if they override size_allocate and don't chain up. The
that a GtkFileChooser interface also supports all GtkWidget methods. proper way to subclass is to chain up in size_allocate. If you don't
However, all previously existing objects still derive from GtkWidget, want to do that for some reason, you have to override draw as well.
so no existing code should break.
* Several fixes for window sizing and placement with client-side * Several fixes for window sizing and placement with client-side
decorations may affect applications that are saving and restoring decorations may affect applications that are saving and restoring
@ -104,6 +103,13 @@ Release notes for 3.20
on having a theme-provided background, call gtk_render_background() on having a theme-provided background, call gtk_render_background()
from your ::draw handler. from your ::draw handler.
* The GtkFileChooser interface pre-requisite changed from GtkWidget
to GObject, allowing non-widget implementations of this interface.
This is a minor change in ABI, as apps are no longer guaranteed
that a GtkFileChooser interface also supports all GtkWidget methods.
However, all previously existing objects still derive from GtkWidget,
so no existing code should break.
* The GtkPlacesSidebar added a GtkPlacesOpenFlags parameter to the * The GtkPlacesSidebar added a GtkPlacesOpenFlags parameter to the
other-locations signal in order to allow opening new windows or other-locations signal in order to allow opening new windows or
tabs as done with other locations. This breaks the API for those tabs as done with other locations. This breaks the API for those