diff --git a/doc/ChangeLog b/doc/ChangeLog
index dbbbe6e02..297a859d8 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,30 +1,40 @@
+2004-09-06 Shane Landrum <epicene@pobox.com>
+	
+	* en/Gtk/HTML.xml
+	* en/Gtk/HTMLCommandType.xml
+	* en/Gtk/HTMLCursorSkipType.xml : Docs related to HTML widgets.
+	* en/Gtk/Button.xml
+	* en/Gtk/Widget.xml
+	* en/Gtk/Style.xml
+	* en/Gtk/Container.xml : Docs for major components.
+	
 2004-09-06 Shane Landrum <epicene@pobox.com>
 
-	* CommitArgs.xml
-	* ConfigureEventArgs.xml
-	* CursorMoveArgs.xml
-	* CycleChildFocusArgs.xml
-	* DeleteRangeArgs.xml
-	* DirectionChangedArgs.xml
-	* DrawPrintArgs.xml
-	* EnterNotifyEventArgs.xml
-	* FocusChildSetArgs.xml
-	* FocusTabArgs.xml
-	* FormatValueArgs.xml
-	* FrameEventArgs.xml
-	* HierarchyChangedArgs.xml
-	* LeaveNotifyEventArgs.xml
-	* MoveArgs.xml
-	* MoveCurrentArgs.xml
-	* MoveCursorArgs.xml
-	* MoveFocusArgs.xml
-	* MoveHandleArgs.xml
-	* OnCommandArgs.xml
-	* PageHorizontallyArgs.xml
-	* ParentSetArgs.xml
-	* ScrollChildArgs.xml
-	* SubmitArgs.xml
-	* TextEventArgs.xml : Event data docs.
+	* en/Gtk/CommitArgs.xml
+	* en/Gtk/ConfigureEventArgs.xml
+	* en/Gtk/CursorMoveArgs.xml
+	* en/Gtk/CycleChildFocusArgs.xml
+	* en/Gtk/DeleteRangeArgs.xml
+	* en/Gtk/DirectionChangedArgs.xml
+	* en/Gtk/DrawPrintArgs.xml
+	* en/Gtk/EnterNotifyEventArgs.xml
+	* en/Gtk/FocusChildSetArgs.xml
+	* en/Gtk/FocusTabArgs.xml
+	* en/Gtk/FormatValueArgs.xml
+	* en/Gtk/FrameEventArgs.xml
+	* en/Gtk/HierarchyChangedArgs.xml
+	* en/Gtk/LeaveNotifyEventArgs.xml
+	* en/Gtk/MoveArgs.xml
+	* en/Gtk/MoveCurrentArgs.xml
+	* en/Gtk/MoveCursorArgs.xml
+	* en/Gtk/MoveFocusArgs.xml
+	* en/Gtk/MoveHandleArgs.xml
+	* en/Gtk/OnCommandArgs.xml
+	* en/Gtk/PageHorizontallyArgs.xml
+	* en/Gtk/ParentSetArgs.xml
+	* en/Gtk/ScrollChildArgs.xml
+	* en/Gtk/SubmitArgs.xml
+	* en/Gtk/TextEventArgs.xml : Event data docs.
 
 2004-09-04 Mike Kestner <mkestner@ximian.com>
 
diff --git a/doc/en/Gtk/Button.xml b/doc/en/Gtk/Button.xml
index b19fdc36a..a8625c669 100644
--- a/doc/en/Gtk/Button.xml
+++ b/doc/en/Gtk/Button.xml
@@ -342,9 +342,9 @@ public class ButtonApp  {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Whether or not the cursor is inside the button.</summary>
+        <returns>a <see cref="T:System.Boolean" />, true if the cursor is inside the button.</returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="NewWithMnemonic">
@@ -399,9 +399,10 @@ public class ButtonApp  {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns the kind of action this button does.</summary>
         <returns>a <see cref="T:GLib.GType" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>There are four possible options: "ignored", "selects", "drags",
+	  and "expands".</remarks>
       </Docs>
     </Member>
     <Member MemberName="OnEntered">
@@ -491,4 +492,4 @@ public class ButtonApp  {
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Container.xml b/doc/en/Gtk/Container.xml
index e41556885..1b82ba475 100644
--- a/doc/en/Gtk/Container.xml
+++ b/doc/en/Gtk/Container.xml
@@ -56,8 +56,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Attempts to resize this container.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ChildGetValist">
@@ -135,8 +135,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Tries to resize the child widgets of this container.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ChildSetProperty">
@@ -260,10 +260,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>The vertical focus adjustment.</summary>
         <param name="value">an object of type <see cref="T:Gtk.Adjustment" /></param>
         <returns>an object of type <see cref="T:Gtk.Adjustment" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="FocusHadjustment">
@@ -275,10 +275,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>The horizontal focus adjustment.</summary>
         <param name="value">an object of type <see cref="T:Gtk.Adjustment" /></param>
         <returns>an object of type <see cref="T:Gtk.Adjustment" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="FocusChild">
@@ -290,10 +290,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">an object of type <see cref="T:Gtk.Widget" /></param>
+        <summary>Moves the focus to a particular child widget.</summary>
+        <param name="value">A <see cref="T:Gtk.Widget" />, a child of this container.</param>
         <returns>an object of type <see cref="T:Gtk.Widget" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ReallocateRedraws">
@@ -305,10 +305,12 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>The redraw-reallocation flag. Containers requesting 
+	  reallocation redraws get automatically redrawn if any of their 
+	  children changed allocation. </summary>
         <param name="value">an object of type <see cref="T:System.Boolean" /></param>
         <returns>an object of type <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Child">
@@ -320,10 +322,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>A child widget for this container.</summary>
         <param name="value">an object of type <see cref="T:Gtk.Widget" /></param>
         <returns>an object of type <see cref="T:Gtk.Widget" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ResizeMode">
@@ -335,10 +337,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>How this container behaves when resized.</summary>
         <param name="value">an object of type <see cref="T:Gtk.ResizeMode" /></param>
         <returns>an object of type <see cref="T:Gtk.ResizeMode" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="BorderWidth">
@@ -350,10 +352,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">an object of type <see cref="T:System.UInt32" /></param>
-        <returns>an object of type <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>This container's border width.</summary>
+        <param name="value">A <see cref="T:System.UInt32" /></param>
+        <returns>A <see cref="T:System.UInt32" /></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Added">
@@ -364,7 +366,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when a child widget is added to the container.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -376,7 +378,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the focus moves to a child widget of this container.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -388,7 +390,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when a child widget is removed from this container.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -400,7 +402,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when this container's resizability is queried.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -484,9 +486,13 @@
         <Parameter Name="cb" Type="Gtk.Callback" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Invokes a callback function on each child of this container, 
+	  including children that are considered "internal" (implementation 
+	  details of the container). "Internal" children generally weren't 
+	  added by the user of the container but were added by the container 
+	  implementation itself. </summary>
         <param name="cb">a <see cref="T:Gtk.Callback" /></param>
-        <remarks>To be added</remarks>
+        <remarks>Most applications should use <see cref="M:Gtk.Container.Foreach"/> instead of this method.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Foreach">
@@ -499,9 +505,10 @@
         <Parameter Name="cb" Type="Gtk.Callback" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Invokes a callback function on each non-internal child of this container. See <see cref="M:Gtk.Container.Forall"/> for more details on internal children. </summary>
         <param name="cb">a <see cref="T:Gtk.Callback" /></param>
-        <remarks>To be added</remarks>
+        <remarks>Most applications should use this method instead of <see cref="M:Gtk.Container.Forall"/>.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -580,7 +587,7 @@
         <summary>To be added</summary>
         <param name="include_internals">a <see cref="T:System.Boolean" /></param>
         <param name="invoker">a <see cref="T:Gtk.Container+CallbackInvoker" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ChildType">
@@ -591,9 +598,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns the type of children supported by this container.</summary>
         <returns>a <see cref="T:GLib.GType" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gtk/HTML.xml b/doc/en/Gtk/HTML.xml
index 54223442f..a4c6fbee4 100644
--- a/doc/en/Gtk/HTML.xml
+++ b/doc/en/Gtk/HTML.xml
@@ -1631,7 +1631,7 @@ class X {
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Whether or not to check spelling inline by indicating misspelled words.</summary>
         <param name="value">a <see cref="T:System.Boolean" /></param>
         <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks />
diff --git a/doc/en/Gtk/HTMLCommandType.xml b/doc/en/Gtk/HTMLCommandType.xml
index fbe6ae8b9..6a2dcf12b 100644
--- a/doc/en/Gtk/HTMLCommandType.xml
+++ b/doc/en/Gtk/HTMLCommandType.xml
@@ -1623,7 +1623,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Stops the widget from redrawing.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -1636,7 +1636,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Allows the widget to redraw.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -1831,7 +1831,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Deletes a word.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -1844,7 +1844,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Deletes the word before the cursor.</summary>
         <remarks>
         </remarks>
       </Docs>
diff --git a/doc/en/Gtk/HTMLCursorSkipType.xml b/doc/en/Gtk/HTMLCursorSkipType.xml
index 66cafde5b..4b42f609f 100644
--- a/doc/en/Gtk/HTMLCursorSkipType.xml
+++ b/doc/en/Gtk/HTMLCursorSkipType.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Units for allowing the HTML widget's cursor to skip.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Skip units should be counted in characters.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -50,7 +50,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Skip units should be counted in words.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -63,7 +63,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Skip units should be counted in pages.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -76,7 +76,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Skip units should encompass the whole document. Use for skipping to the beginning or end of the document.</summary>
         <remarks>
         </remarks>
       </Docs>
@@ -95,4 +95,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Style.xml b/doc/en/Gtk/Style.xml
index 4013b2857..1722b8921 100644
--- a/doc/en/Gtk/Style.xml
+++ b/doc/en/Gtk/Style.xml
@@ -411,10 +411,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gc" Type="Gdk.GC" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Sets the graphics context for the foreground.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to set the style for</param>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetBackgroundGC">
@@ -428,10 +428,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gc" Type="Gdk.GC" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Sets the graphics context for the background.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to set the style for</param>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="BaseGC">
@@ -444,10 +444,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="state" Type="Gtk.StateType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Returns the base graphics context for the widget.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to get the style for</param>
         <returns>a <see cref="T:Gdk.GC" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetBaseGC">
@@ -461,10 +461,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gc" Type="Gdk.GC" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Sets the graphics context for the background.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to set the style for</param>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="TextGC">
@@ -477,10 +477,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="state" Type="Gtk.StateType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Returns the graphics context for the widget's text.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to get the style for</param>
         <returns>a <see cref="T:Gdk.GC" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetTextGC">
@@ -494,10 +494,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gc" Type="Gdk.GC" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="state">a <see cref="T:Gtk.StateType" /></param>
+        <summary>Sets the graphics context for text.</summary>
+        <param name="state">a <see cref="T:Gtk.StateType" />, the state of the widget to set the style for</param>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintBox">
@@ -520,7 +520,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a box on the screen with the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -532,7 +532,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintCheck">
@@ -555,7 +555,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a check button indicator in the given rectangle on <paramref name="window"/> with the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -567,7 +567,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintResizeGrip">
@@ -590,7 +590,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary> Draws a resize grip in the given rectangle on @window using the given parameters. </summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -602,7 +602,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintLayout">
@@ -624,7 +624,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="layout" Type="Pango.Layout" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a layout on the screen using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -635,7 +635,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="x">a <see cref="T:System.Int32" /></param>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="layout">a <see cref="T:Pango.Layout" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintOption">
@@ -658,7 +658,8 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a radio button indicator in the given rectangle on @window with the given parameters.
+	</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -670,7 +671,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintSlider">
@@ -694,7 +695,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="orientation" Type="Gtk.Orientation" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a slider widget with the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -707,7 +708,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
         <param name="orientation">a <see cref="T:Gtk.Orientation" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintDiamond">
@@ -730,7 +731,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a diamond in the given rectangle on <paramref name="window"/> using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -765,7 +766,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a shadow around the given rectangle in <paramref name="window"/> using the given style and state and shadow type.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -777,7 +778,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintVline">
@@ -798,7 +799,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="x" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary> Draws a vertical line from (<paramref name="x"/>, <paramref name="y1_"/>) to (<paramref name="x"/>, <paramref name="y2_"/>) in <paramref name="window"/> using the given style and state.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -808,7 +809,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y1_">a <see cref="T:System.Int32" /></param>
         <param name="y2_">a <see cref="T:System.Int32" /></param>
         <param name="x">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintTab">
@@ -831,7 +832,8 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws an option menu tab (i.e. the up and down pointing arrows) in the given rectangle on @window using the given parameters.
+	</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -843,7 +845,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintFocus">
@@ -865,7 +867,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a focus indicator around the given rectangle on <paramref name="window"/> using the given style.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -876,7 +878,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintShadowGap">
@@ -902,7 +904,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gap_width" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a shadow gap around the given widget using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -917,7 +919,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="gap_side">a <see cref="T:Gtk.PositionType" /></param>
         <param name="gap_x">a <see cref="T:System.Int32" /></param>
         <param name="gap_width">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintExtension">
@@ -941,7 +943,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gap_side" Type="Gtk.PositionType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws an extension for the given widget in the given style.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -954,7 +956,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
         <param name="gap_side">a <see cref="T:Gtk.PositionType" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintFlatBox">
@@ -977,7 +979,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a flat box on <paramref name="window"/> with the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -989,7 +991,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintHandle">
@@ -1013,7 +1015,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="orientation" Type="Gtk.Orientation" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw a handle graphic for the given widget using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -1026,7 +1028,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
         <param name="orientation">a <see cref="T:Gtk.Orientation" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintArrow">
@@ -1051,7 +1053,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw an arrow at (<paramref name="x"/>, <paramref name="y"/>) using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -1065,7 +1067,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="y">a <see cref="T:System.Int32" /></param>
         <param name="width">a <see cref="T:System.Int32" /></param>
         <param name="height">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintHline">
@@ -1086,7 +1088,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary> Draws a horizontal line from (<paramref name="x1"/>, <paramref name="y"/>) to (<paramref name="x2"/>, <paramref name="y"/>) in <paramref name="window"/> using the given style and state.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -1096,7 +1098,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="x1">a <see cref="T:System.Int32" /></param>
         <param name="x2">a <see cref="T:System.Int32" /></param>
         <param name="y">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintBoxGap">
@@ -1122,7 +1124,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="gap_width" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draws a gap around a box using the given parameters.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
         <param name="state_type">a <see cref="T:Gtk.StateType" /></param>
@@ -1137,7 +1139,7 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <param name="gap_side">a <see cref="T:Gtk.PositionType" /></param>
         <param name="gap_x">a <see cref="T:System.Int32" /></param>
         <param name="gap_width">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -1175,9 +1177,9 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The colors to use for text.</summary>
         <returns>a <see cref="T:Gdk.Color[]" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="BaseColors">
@@ -1188,9 +1190,9 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The base color set.</summary>
         <returns>a <see cref="T:Gdk.Color[]" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Text">
@@ -1203,10 +1205,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="state" Type="Gtk.StateType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns the color for text in the given state.</summary>
         <param name="state">a <see cref="T:System.Int32" /></param>
         <returns>a <see cref="T:Gdk.Color" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Base">
@@ -1219,10 +1221,10 @@ color or pixmap specified by this style for <paramref name="state"/>.</summary>
         <Parameter Name="state" Type="Gtk.StateType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns the base color for the given state.</summary>
         <param name="state">a <see cref="T:System.Int32" /></param>
         <returns>a <see cref="T:Gdk.Color" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PaintExpander">
diff --git a/doc/en/Gtk/Widget.xml b/doc/en/Gtk/Widget.xml
index f650ba963..736a9d483 100644
--- a/doc/en/Gtk/Widget.xml
+++ b/doc/en/Gtk/Widget.xml
@@ -1885,7 +1885,7 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the hierarchy (parent or child relationships) of this widget or its parent or children changes.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -2029,7 +2029,7 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when this widget's popup menu is activated.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -2353,7 +2353,7 @@ handle focus grabs.</returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the mouse leaves this widget.</summary>
         <remarks />
       </Docs>
     </Member>