[gtk+] Layout: Tweak documentation blurb



commit 06da81486376355e4a57ad8d40cb0cf91a4ba09b
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 |   16 +++++++++-------
 1 files changed, 9 insertions(+), 7 deletions(-)
---
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index c4e46ae..d89cc9f 100644
--- a/gtk/gtklayout.c
+++ b/gtk/gtklayout.c
@@ -44,14 +44,16 @@
  * @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.
  */
 
 


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