summaryrefslogtreecommitdiff
path: root/gtk/gtklayout.c
diff options
context:
space:
mode:
authorDaniel Boles <dboles@src.gnome.org>2017-08-03 10:13:52 +0100
committerDaniel Boles <dboles@src.gnome.org>2017-08-03 10:19:13 +0100
commit06da81486376355e4a57ad8d40cb0cf91a4ba09b (patch)
tree896c49ce8c2c25953f1f151bd8b7358273a613fd /gtk/gtklayout.c
parent5cafa2b1ce1ee38c8f3bb1befeed98ae55dcc923 (diff)
downloadgtk+-06da81486376355e4a57ad8d40cb0cf91a4ba09b.tar.gz
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
Diffstat (limited to 'gtk/gtklayout.c')
-rw-r--r--gtk/gtklayout.c16
1 files changed, 9 insertions, 7 deletions
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index c4e46ae493..d89cc9f587 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.
*/