From 1d96ad49bcd3ee3ea7ac150028e66008a1f80522 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Fri, 13 Aug 2004 16:41:57 +0000
Subject: [PATCH] 2004-08-13  Shane Landrum <epicene@pobox.com>

	* en/Gtk/Widget.xml: Filled in some event information,
	removed a lot of extraneous "To be added" in remarks fields

svn path=/trunk/gtk-sharp/; revision=32315
---
 doc/ChangeLog         |   5 ++
 doc/en/Gtk/Widget.xml | 123 +++++++++++++++++++++---------------------
 2 files changed, 66 insertions(+), 62 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a605982b9..b50efe610 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2004-08-13  Shane Landrum <epicene@pobox.com>
+
+	* en/Gtk/Widget.xml: Filled in some event information,
+	removed a lot of extraneous "To be added" in remarks fields
+
 2004-08-13  Shane Landrum <epicene@pobox.com>
 
 	* en/Gtk/TextAppearance.xml
diff --git a/doc/en/Gtk/Widget.xml b/doc/en/Gtk/Widget.xml
index 25399590a..3db518a5a 100644
--- a/doc/en/Gtk/Widget.xml
+++ b/doc/en/Gtk/Widget.xml
@@ -1790,8 +1790,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired whenever the widget receives a request for a selection.</summary>
+        <remarks>To be added: explain more about the X selection model </remarks>
       </Docs>
     </Member>
     <Member MemberName="DirectionChanged">
@@ -1826,8 +1826,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when the widget is scrolled.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="VisibilityNotifyEvent">
@@ -1839,7 +1839,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="WindowStateEvent">
@@ -1851,7 +1851,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Mapped">
@@ -1875,7 +1875,6 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
       </Docs>
     </Member>
     <Member MemberName="HierarchyChanged">
@@ -1887,7 +1886,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ConfigureEvent">
@@ -1899,7 +1898,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="KeyPressEvent">
@@ -1923,7 +1922,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="FocusGrabbed">
@@ -1935,7 +1934,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="MotionNotifyEvent">
@@ -1947,7 +1946,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="StateChanged">
@@ -1959,7 +1958,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="NoExposeEvent">
@@ -1971,7 +1970,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Unrealized">
@@ -1983,7 +1982,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ButtonReleaseEvent">
@@ -1994,8 +1993,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when a (mouse) button is released on this widget.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SelectionGet">
@@ -2006,8 +2005,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when this widget gets a selection from the clipboard.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SizeAllocated">
@@ -2019,7 +2018,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="PopupMenu">
@@ -2031,7 +2030,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ExposeEvent">
@@ -2043,7 +2042,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Shown">
@@ -2055,7 +2054,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SelectionNotifyEvent">
@@ -2067,7 +2066,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="FocusInEvent">
@@ -2079,7 +2078,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ButtonPressEvent">
@@ -2090,8 +2089,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when a button is pressed.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="PropertyNotifyEvent">
@@ -2103,7 +2102,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="HelpShown">
@@ -2114,8 +2113,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when the help text is shown.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ClientEvent">
@@ -2127,7 +2126,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ProximityInEvent">
@@ -2139,7 +2138,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ProximityOutEvent">
@@ -2151,7 +2150,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DestroyEvent">
@@ -2163,7 +2162,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SelectionReceived">
@@ -2175,7 +2174,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragDataGet">
@@ -2187,7 +2186,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="EnterNotifyEvent">
@@ -2199,7 +2198,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragDataReceived">
@@ -2211,7 +2210,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragMotion">
@@ -2223,7 +2222,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SizeRequested">
@@ -2235,7 +2234,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="GrabNotify">
@@ -2247,7 +2246,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="StyleSet">
@@ -2259,7 +2258,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="FocusOutEvent">
@@ -2270,8 +2269,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when the focus leaves this widget.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ChildNotified">
@@ -2283,7 +2282,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Unmapped">
@@ -2295,7 +2294,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragEnd">
@@ -2307,7 +2306,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SelectionClearEvent">
@@ -2318,8 +2317,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when the current selection is cleared.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="MnemonicActivated">
@@ -2330,8 +2329,8 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when someone presses a mnemonic key.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragDrop">
@@ -2343,7 +2342,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="LeaveNotifyEvent">
@@ -2355,7 +2354,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DeleteEvent">
@@ -2367,7 +2366,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Realized">
@@ -2379,7 +2378,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="DragDataDelete">
@@ -2391,7 +2390,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="RootWindow">
@@ -2403,7 +2402,7 @@ handle focus grabs.</returns>
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Display">
@@ -2472,7 +2471,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Intersect">
@@ -2621,7 +2620,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="StyleGetProperty">
@@ -3212,7 +3211,7 @@ handle focus grabs.</returns>
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="OnDeleteEvent">
@@ -3750,7 +3749,7 @@ xs    <Member MemberName="OnMapEvent">
       <Docs>
         <summary>Obtains or sets the underlying Gdk.Window used to display the contents of the <paramref name="widget" />.</summary>
         <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Flags">
@@ -3804,7 +3803,7 @@ xs    <Member MemberName="OnMapEvent">
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:Gtk.Widget" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="FocusLineWidth">