[gtk+] widget: Improve get_request_mode vfunc docs

[Timm Bäder <baedert src gnome org>]

commit f576002e9e980462589561c73c188707f87a0f43
Author: Timm Bäder <mail baedert org>
Date:   Sun Oct 29 20:10:44 2017 +0100

    widget: Improve get_request_mode vfunc docs

 gtk/gtkwidget.h |    9 ++++-----
 1 files changed, 4 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 46317ac..1fa9fbc 100644
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -174,13 +174,12 @@ struct _GtkWidget
  *   #GtkWidgetClass.get_preferred_width() called and then
  *   #GtkWidgetClass.get_preferred_height_for_width().
  *   %GTK_SIZE_REQUEST_CONSTANT_SIZE disables any height-for-width or
- *   width-for-height geometry management for a said widget and is the
+ *   width-for-height geometry management for said widget and is the
  *   default return.
- *   It’s important to note (as described below) that any widget
+ *   It’s important to note that any widget
  *   which trades height-for-width or width-for-height must respond properly
- *   to both of the virtual methods #GtkWidgetClass.get_preferred_height_for_width()
- *   and #GtkWidgetClass.get_preferred_width_for_height() since it might be
- *   queried in either #GtkSizeRequestMode by its parent container.
+ *   to a for_size value >= -1 passed to #GtkWidgetClass.measure, for both
+ *   possible orientations.
  * @measure: This is called by containers to obtain the minimum and natural
  *   size of the widget. Depending on the orientation parameter, the passed
  *   for_size can be interpreted as width or height. A widget will never be