[gtk+/gtk-3-22] Layout: Tweak documentation blurb

[Daniel Boles <dboles src gnome org>]

commit 5acee3a3e054f25e73e2027269e5f51efe41af7d
Author: Daniel Boles <dboles src gnome org>
Date:   Thu Aug 3 10:13:52 2017 +0100

    Layout: Tweak documentation blurb
    
    Being addable to a ScrolledWindow is not interesting; now that SW
    auto-adds a Viewport if needed, so can DrawingArea and any other widget.
    
    Mention GtkFixed in case the reader just wants that bit of functionality

 gtk/gtklayout.c |   19 ++++++++++---------
 1 files changed, 10 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index 26b74f2..0abc988 100644
--- a/gtk/gtklayout.c
+++ b/gtk/gtklayout.c
@@ -44,19 +44,20 @@
  * @Short_description: Infinite scrollable area containing child widgets
  *   and/or custom drawing
  * @Title: GtkLayout
- * @See_also: #GtkDrawingArea, #GtkScrolledWindow
+ * @See_also: #GtkDrawingArea, #GtkFixed
  *
- * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate”
- * and doesn’t do anything but paint a blank background by default. It's
- * different in that it supports scrolling natively (you can add it to a
- * #GtkScrolledWindow), and it can contain child widgets, since it’s a
- * #GtkContainer. However if you’re just going to draw, a #GtkDrawingArea
- * is a better choice since it has lower overhead.
+ * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” and
+ * doesn’t do anything except paint a blank background by default. It’s
+ * different in that it supports scrolling natively due to implementing
+ * #GtkScrollable, and can contain child widgets since it’s a #GtkContainer.
+ *
+ * If you just want to draw, a #GtkDrawingArea is a better choice since it has
+ * lower overhead. If you just need to position child widgets at specific
+ * points, then #GtkFixed provides that functionality on its own.
  *
  * When handling expose events on a #GtkLayout, you must draw to
  * GTK_LAYOUT (layout)->bin_window, rather than to
- * GTK_WIDGET (layout)->window, as you would for a drawing
- * area.
+ * GTK_WIDGET (layout)->window, as you would for a #GtkDrawingArea.
  */