gtk+ r22063 - in trunk/docs/reference: . gtk/tmpl

[matthiasc svn gnome org]

Author: matthiasc
Date: Mon Jan  5 04:19:48 2009
New Revision: 22063
URL: http://svn.gnome.org/viewvc/gtk+?rev=22063&view=rev

Log:
Add long description


Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/gtk/tmpl/gtkviewport.sgml

Modified: trunk/docs/reference/gtk/tmpl/gtkviewport.sgml
==============================================================================
--- trunk/docs/reference/gtk/tmpl/gtkviewport.sgml	(original)
+++ trunk/docs/reference/gtk/tmpl/gtkviewport.sgml	Mon Jan  5 04:19:48 2009
@@ -6,12 +6,24 @@
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+The #GtkViewport widget acts as an adaptor class, implementing 
+scrollability for child widgets that lack their own scrolling 
+capabilities. Use #GtkViewport to scroll child widgets such as 
+#GtkTable, #GtkBox, and so on.
+</para>
 
+<para>
+If a widget has native scrolling abilities, such as #GtkTextView, 
+#GtkTreeView or #GtkIconview, it can be added to a #GtkScrolledWindow 
+with gtk_container_add(). If a widget does not, you must first add the 
+widget to a #GtkViewport, then add the viewport to the scrolled window. 
+The convenience function gtk_scrolled_window_add_with_viewport() does 
+exactly this, so you can ignore the presence of the viewport.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkScrolledWindow, #GtkAdjustment
 </para>
 
 <!-- ##### SECTION Stability_Level ##### -->