Add long description

svn path=/trunk/; revision=22063

1 files changed, 13 insertions, 1 deletions

diff --git a/docs/reference/gtk/tmpl/gtkviewport.sgml b/docs/reference/gtk/tmpl/gtkviewport.sgml
index 54eefc0e60..c6343cb8e0 100644
--- a/docs/reference/gtk/tmpl/gtkviewport.sgml
+++ b/docs/reference/gtk/tmpl/gtkviewport.sgml
@@ -6,12 +6,24 @@ An adapter which makes widgets scrollable
 
 <!-- ##### 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 ##### -->