2.9.0

[~andy/gtk] / docs / reference / gtk / tmpl / gtklayout.sgml

diff --git a/docs/reference/gtk/tmpl/gtklayout.sgml b/docs/reference/gtk/tmpl/gtklayout.sgml
index 4a834ad3405db0f2a0213c5f95b5181ed0fd4ebb..22ca60fcb03b7a964ededfa1ab3b3d777d8c7e94 100644 (file)
--- a/docs/reference/gtk/tmpl/gtklayout.sgml
+++ b/docs/reference/gtk/tmpl/gtklayout.sgml
@@ -3,22 +3,78 @@ GtkLayout
 
 <!-- ##### SECTION Short_Description ##### -->
 
+Infinite scrollable area containing child widgets and/or custom drawing
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+#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.
+</para>
 
+<para>
+When handling expose events on a #GtkLayout, you must draw to 
+GTK_LAYOUT (layout)-&gt;bin_window, rather than to 
+GTK_WIDGET (layout)-&gt;window, as you would for a drawing
+area.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkDrawingArea, #GtkScrolledWindow
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### STRUCT GtkLayout ##### -->
 <para>
 
 </para>
 
+@bin_window: 
+
+<!-- ##### SIGNAL GtkLayout::set-scroll-adjustments ##### -->
+<para>
+
+</para>
+
+@layout: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### ARG GtkLayout:hadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:height ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:vadjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:width ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:x ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkLayout:y ##### -->
+<para>
+
+</para>
 
 <!-- ##### FUNCTION gtk_layout_new ##### -->
 <para>
@@ -36,7 +92,7 @@ GtkLayout
 </para>
 
 @layout: 
-@widget: 
+@child_widget: 
 @x: 
 @y: 
 
@@ -47,7 +103,7 @@ GtkLayout
 </para>
 
 @layout: 
-@widget: 
+@child_widget: 
 @x: 
 @y: 
 
@@ -62,6 +118,16 @@ GtkLayout
 @height: 
 
 
+<!-- ##### FUNCTION gtk_layout_get_size ##### -->
+<para>
+
+</para>
+
+@layout: 
+@width: 
+@height: 
+
+
 <!-- ##### FUNCTION gtk_layout_freeze ##### -->
 <para>
 
@@ -114,32 +180,3 @@ GtkLayout
 @adjustment: 
 
 
-<!-- ##### SIGNAL GtkLayout::set-scroll-adjustments ##### -->
-<para>
-
-</para>
-
-@layout: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### ARG GtkLayout:hadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:vadjustment ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:width ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkLayout:height ##### -->
-<para>
-
-</para>
-