[gtk+] Reword release notes



commit f732fa6883600a05595589f3281fa891ced85516
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Mar 20 21:48:05 2016 -0400

    Reword release notes

 README.in |   60 ++++++++++++++++++++++++++++++------------------------------
 1 files changed, 30 insertions(+), 30 deletions(-)
---
diff --git a/README.in b/README.in
index d0884ec..dcc9d1a 100644
--- a/README.in
+++ b/README.in
@@ -72,48 +72,48 @@ and attach the patch to that bug report.
 Patches should be in unified diff form. (The -up option to GNU diff)
 Even better are git-formatted patches. (Use git format-patch)
 
+
 Release notes for 3.20
 ======================
 
-* The way theming works in GTK+ has been reworked pretty fundamentally
-  in this release, to be able to implement many more CSS features and
-  generally give themes more power. As a result, custom CSS that is
-  shipped with applications and third-party themes will need adjustments.
-  Widgets now use element names much more than style classes; type
-  names are no longer used in style matching. Every widget now documents
-  the element names it has and the style classes it uses. The GTK+
-  inspector can also be helpful in finding this information.
+* The way theming works in GTK+ has been reworked fundamentally, to
+  implement many more CSS features and make themes more expressive.
+  As a result, custom CSS that is shipped with applications and third-
+  party themes will need adjustments. Widgets now use element names much
+  more than style classes; type names are no longer used in style matching.
+  Every widget now documents the element names it has and the style classes
+  it uses. The GTK+ inspector can also help with finding this information.
 
 * GTK+ now uses internal subobjects (also known as gadgets) for allocating
-  and drawing widget parts. Applications that subclass GTK+ widgets may
-  see warnings if they override size_allocate and don't chain up. The
-  proper way to subclass is to chain up in size_allocate. If you don't
-  want to do that for some reason, you have to override draw as well.
-
-* Several fixes for window sizing and placement with client-side
-  decorations may affect applications that are saving and restoring
-  window sizes. The recommended best practice for this which is known
-  to work with client-side and server-side decorations and with older
-  and newer versions of GTK+ is to use gtk_window_get_size() to save
-  and gtk_window_set_default_size() to restore the window size. See
-  https://wiki.gnome.org/HowDoI/SaveWindowState for a detailed example.
+  and drawing widget parts. Applications that subclass GTK+ widgets may see
+  warnings if they override the size_allocate vfunc and don't chain up.
+  The proper way to subclass is to chain up in size_allocate. If you do not
+  want to do that for some reason, you have to override the draw vfunc as
+  well.
+
+* Several fixes for window sizing and window placement with client-side
+  decorations may affect applications that are saving and restoring window
+  sizes. The recommended best practice for this which is known to work with
+  client-side and server-side decorations and with older and newer versions
+  of GTK+ is to use gtk_window_get_size() to save window sizes and
+  gtk_window_set_default_size() to restore it.
+  See https://wiki.gnome.org/HowDoI/SaveWindowState for a detailed example.
 
 * GtkDrawingArea used to implicitly render the theme background before
   calling the ::draw handler. This is no longer the case. If you rely
   on having a theme-provided background, call gtk_render_background()
   from your ::draw handler.
 
-* The GtkFileChooser interface pre-requisite changed from GtkWidget
+* The GtkFileChooser interface prerequisite 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 way in which GtkLevelBar determines the offset to apply was
-  a bit inconsistent in the past; this has been fixed. Applications
-  that are using custom offsets should double-check that their
-  levels look as expected.
+  This is a minor change in ABI, as applications are no longer guaranteed
+  that a GtkFileChooser also supports all GtkWidget methods. However, all
+  previously existing implementations still derive from GtkWidget, so no
+  existing code should break.
+
+* The way in which GtkLevelBar determines the offset to apply was a bit
+  inconsistent in the past; this has been fixed. Applications that are using
+  custom offsets should double-check that their levels look as expected.
 
 Release notes for 3.18
 ======================


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]