From 4336f5447b6f5c53b8ef0682c82a39b8bce9e054 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Sat, 28 Aug 2004 03:46:45 +0000
Subject: [PATCH] 2004-08-28 Shane Landrum <epicene@pobox.com>

	* en/Gtk/TranslateFunc.xml: delegate docs.
	* en/Gtk/Settings*.xml: settings classes docs, first pass.
	* en/Gtk/Separator.xml: Documented protected constructor.
	* en/Gtk/StockItem.xml: Documented translation domain.
	* en/Gtk/Ruler.xml: Documented Ruler class.
	* en/Gtk/SpinButton.xml: Documented SpinButton class.
	* en/Gtk/TextMarkBody.xml: Internal class, do not use.
	* en/Gtk/Submenu.xml: Documented submenus.
	* en/Gtk/ItemFactory.xml
	* en/Gtk/WindowKeysForeachFunc.xml
	* en/Gtk/SurroundingDeletedArgs.xml: Added docs.

svn path=/trunk/gtk-sharp/; revision=32963
---
 doc/ChangeLog                         | 14 +++++
 doc/en/Gtk/ItemFactory.xml            | 14 ++---
 doc/en/Gtk/Ruler.xml                  | 62 +++++++++----------
 doc/en/Gtk/Separator.xml              |  6 +-
 doc/en/Gtk/Settings.xml               | 86 +++++++++++++--------------
 doc/en/Gtk/SettingsPropertyValue.xml  |  6 +-
 doc/en/Gtk/SettingsValue.xml          | 26 ++++----
 doc/en/Gtk/SpinButton.xml             | 50 ++++++++--------
 doc/en/Gtk/StockItem.xml              |  6 +-
 doc/en/Gtk/Submenu.xml                | 18 +++---
 doc/en/Gtk/SurroundingDeletedArgs.xml | 14 ++---
 doc/en/Gtk/TextMarkBody.xml           |  6 +-
 doc/en/Gtk/TranslateFunc.xml          |  6 +-
 doc/en/Gtk/WindowKeysForeachFunc.xml  |  4 +-
 14 files changed, 166 insertions(+), 152 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 35f242b54..7117b9b89 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,17 @@
+2004-08-28 Shane Landrum <epicene@pobox.com>
+
+	* en/Gtk/TranslateFunc.xml: delegate docs.
+	* en/Gtk/Settings*.xml: settings classes docs, first pass.
+	* en/Gtk/Separator.xml: Documented protected constructor.
+	* en/Gtk/StockItem.xml: Documented translation domain.
+	* en/Gtk/Ruler.xml: Documented Ruler class.
+	* en/Gtk/SpinButton.xml: Documented SpinButton class.
+	* en/Gtk/TextMarkBody.xml: Internal class, do not use.
+	* en/Gtk/Submenu.xml: Documented submenus.
+	* en/Gtk/ItemFactory.xml
+	* en/Gtk/WindowKeysForeachFunc.xml
+	* en/Gtk/SurroundingDeletedArgs.xml: Added docs.
+	
 2004-08-27 Shane Landrum <epicene@pobox.com>
 
 	* en/Gtk/Style.xml: bugfixes, more docs.
diff --git a/doc/en/Gtk/ItemFactory.xml b/doc/en/Gtk/ItemFactory.xml
index 80daae0a6..0cf7dc11f 100644
--- a/doc/en/Gtk/ItemFactory.xml
+++ b/doc/en/Gtk/ItemFactory.xml
@@ -138,9 +138,9 @@
       </Parameters>
       <Docs>
         <summary>Obtains the menu item which correponds to <paramref name="action" />.</summary>
-        <param name="action">To be added: an object of type 'uint'</param>
-        <returns>To be added: an object of type 'Gtk.Widget'</returns>
-        <remarks>To be added</remarks>
+        <param name="action">A <see cref="T:System.UInt32"/> (TODO: where is this enumerated?)</param>
+        <returns>A <see cref="T:Gtk.Widget"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DeleteEntry">
@@ -188,9 +188,9 @@
       </Parameters>
       <Docs>
         <summary>Obtains the <paramref name="widget" /> which corresponds to <paramref name="action" />.</summary>
-        <param name="action">To be added: an object of type 'uint'</param>
-        <returns>To be added: an object of type 'Gtk.Widget'</returns>
-        <remarks>To be added</remarks>
+        <param name="action">A <see cref="T:System.UInt32"/> (TODO: where is this enumerated?)</param>
+        <returns>A <see cref="T:Gtk.Widget"/></returns>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GetItem">
@@ -477,4 +477,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Ruler.xml b/doc/en/Gtk/Ruler.xml
index 311c234ed..42c93d008 100644
--- a/doc/en/Gtk/Ruler.xml
+++ b/doc/en/Gtk/Ruler.xml
@@ -44,8 +44,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Draws tickmarks on the ruler.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DrawPos">
@@ -56,8 +56,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Draws the mouse position mark on the ruler.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetRange">
@@ -77,8 +77,8 @@
         <param name="lower">The lower value to display on the Ruler.</param>
         <param name="upper">The upper value to display on the Ruler.</param>
         <param name="position">The current position of the mouse aligned with this Ruler.</param>
-        <param name="max_size">To be added: an object of type 'double'</param>
-        <remarks>To be added</remarks>
+        <param name="max_size">A <see cref="T:System.Double"/>, the maximum size of the ruler.</param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GetRange">
@@ -94,12 +94,12 @@
         <Parameter Name="max_size" Type="System.Double&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="lower">To be added: an object of type 'double&amp;'</param>
-        <param name="upper">To be added: an object of type 'double&amp;'</param>
-        <param name="position">To be added: an object of type 'double&amp;'</param>
-        <param name="max_size">To be added: an object of type 'double&amp;'</param>
-        <remarks>To be added</remarks>
+        <summary>Gets the range information.</summary>
+        <param name="lower">A <see cref="T:System.Double"/> for the lower value to display on the Ruler.</param>
+        <param name="upper">A <see cref="T:System.Double"/> for the upper value to display on the Ruler.</param>
+        <param name="position">A <see cref="T:System.Double"/> for the current position of the mouse aligned with this Ruler.</param>
+        <param name="max_size">A <see cref="T:System.Double"/>, the maximum size of the ruler.</param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -156,10 +156,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
-        <remarks>To be added</remarks>
+        <summary>The upper value to display on the ruler.</summary>
+        <param name="value">A <see cref="T:System.Double"/></param>
+        <returns>A <see cref="T:System.Double"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Position">
@@ -171,10 +171,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
-        <remarks>To be added</remarks>
+        <summary>The position of the mouse mark on the ruler.</summary>
+        <param name="value">A <see cref="T:System.Double"/></param>
+        <returns>A <see cref="T:System.Double"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="MaxSize">
@@ -186,10 +186,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
-        <remarks>To be added</remarks>
+        <summary>The maximum size of the ruler.</summary>
+        <param name="value">A <see cref="T:System.Double"/></param>
+        <returns>A <see cref="T:System.Double"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Lower">
@@ -201,10 +201,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
-        <remarks>To be added</remarks>
+        <summary>The lower limit of the ruler.</summary>
+        <param name="value">A <see cref="T:System.Double"/></param>
+        <returns>A <see cref="T:System.Double"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -240,10 +240,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gtk.Ruler" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Separator.xml b/doc/en/Gtk/Separator.xml
index b5a417e68..6663aa682 100644
--- a/doc/en/Gtk/Separator.xml
+++ b/doc/en/Gtk/Separator.xml
@@ -93,10 +93,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gtk.Separator" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Settings.xml b/doc/en/Gtk/Settings.xml
index 2fd278961..ca5e8a3ce 100644
--- a/doc/en/Gtk/Settings.xml
+++ b/doc/en/Gtk/Settings.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>Maintains application settings for <see cref="T:Gtk.Widget"/> objects attached to a toplevel.</summary>
+    <remarks>See <see cref="P:Gtk.Widget.Settings"/></remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -37,10 +37,10 @@
         <Parameter Name="parser" Type="Gtk.RcPropertyParser" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="pspec">To be added: an object of type 'IntPtr'</param>
-        <param name="parser">To be added: an object of type 'Gtk.RcPropertyParser'</param>
-        <remarks>To be added</remarks>
+        <summary>Sets up the property parser for reading Rc files.</summary>
+        <param name="pspec">A <see cref="T:IntPtr"/>, pointer to the underlying C object (TODO: explain)</param>
+        <param name="parser">A <see cref="T:Gtk.RcPropertyParser"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="InstallProperty">
@@ -54,8 +54,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="pspec">To be added: an object of type 'IntPtr'</param>
-        <remarks>To be added</remarks>
+        <param name="pspec">A <see cref="T:IntPtr"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetLongProperty">
@@ -71,10 +71,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <param name="v_long">To be added: an object of type 'long'</param>
-        <param name="origin">To be added: an object of type 'string'</param>
-        <remarks>To be added</remarks>
+        <param name="name">A <see cref="T:System.String"/></param>
+        <param name="v_long">A <see cref="T:System.Int64"/></param>
+        <param name="origin">A <see cref="T:System.String"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetPropertyValue">
@@ -89,9 +89,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <param name="svalue">To be added: an object of type 'Gtk.SettingsValue'</param>
-        <remarks>To be added</remarks>
+        <param name="name">A <see cref="T:System.String"/></param>
+        <param name="svalue">A <see cref="T:Gtk.SettingsValue"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetDoubleProperty">
@@ -107,10 +107,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <param name="v_double">To be added: an object of type 'double'</param>
-        <param name="origin">To be added: an object of type 'string'</param>
-        <remarks>To be added</remarks>
+        <param name="name">A <see cref="T:System.String"/></param>
+        <param name="v_double">A <see cref="T:System.Double"/></param>
+        <param name="origin">A <see cref="T:System.String"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetStringProperty">
@@ -126,10 +126,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="name">To be added: an object of type 'string'</param>
-        <param name="v_string">To be added: an object of type 'string'</param>
-        <param name="origin">To be added: an object of type 'string'</param>
-        <remarks>To be added</remarks>
+        <param name="name">A <see cref="T:System.String"/></param>
+        <param name="v_string">A <see cref="T:System.String"/></param>
+        <param name="origin">A <see cref="T:System.String"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -167,9 +167,9 @@
         <ReturnType>Gtk.Settings</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.Settings'</returns>
-        <remarks>To be added</remarks>
+        <summary>Returns a default settings object.</summary>
+        <returns>A <see cref="T:Gtk.Settings"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GetForScreen">
@@ -185,7 +185,7 @@
         <summary>To be added</summary>
         <param name="screen">a <see cref="T:Gdk.Screen" /></param>
         <returns>a <see cref="T:Gtk.Settings" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -223,9 +223,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>True if the cursor should blink, false if it should not blink.</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="CursorBlinkTime">
@@ -236,9 +236,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Blink interval in milliseconds for the cursor.</summary>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DndDragThreshold">
@@ -251,7 +251,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DoubleClickTime">
@@ -262,9 +262,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Maximum interval between clicks for a mouse action to be considered a double-click. Measured in milliseconds.</summary>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="FontName">
@@ -277,7 +277,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="IconSizes">
@@ -290,7 +290,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="KeyThemeName">
@@ -303,7 +303,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="MenuBarAccel">
@@ -316,7 +316,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SplitCursor">
@@ -329,7 +329,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ThemeName">
@@ -342,7 +342,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -351,10 +351,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Default constructor.</summary>
         <returns>a <see cref="T:Gtk.Settings" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/SettingsPropertyValue.xml b/doc/en/Gtk/SettingsPropertyValue.xml
index 9a7f5c2d8..b5b29ec78 100644
--- a/doc/en/Gtk/SettingsPropertyValue.xml
+++ b/doc/en/Gtk/SettingsPropertyValue.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>A value for a <see cref="T:Gtk.Settings"/> property.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -38,4 +38,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/SettingsValue.xml b/doc/en/Gtk/SettingsValue.xml
index 42a05f64a..744f324dd 100644
--- a/doc/en/Gtk/SettingsValue.xml
+++ b/doc/en/Gtk/SettingsValue.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>Data for <see cref="T:Gtk.Settings"/>.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -27,8 +27,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>An empty value.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -41,10 +41,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'Gtk.SettingsValue'</returns>
-        <remarks>To be added</remarks>
+        <summary>Constructor.</summary>
+        <param name="raw">A <see cref="T:IntPtr"/>, pointer to the underlying C object.</param>
+        <returns>A <see cref="T:Gtk.SettingsValue"/></returns>
+        <remarks>Not for general developer use.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Origin">
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>The source of this data (usually an rcfile).</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -69,9 +69,9 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>The data value.</summary>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/SpinButton.xml b/doc/en/Gtk/SpinButton.xml
index 4d1046901..a234821a7 100644
--- a/doc/en/Gtk/SpinButton.xml
+++ b/doc/en/Gtk/SpinButton.xml
@@ -229,11 +229,11 @@ private void OutputValue(object source, System.EventArgs args)
       </Parameters>
       <Docs>
         <summary>Creates a new SpinButton based on the specified <see cref="T:Gtk.Adjustment" />.</summary>
-        <param name="adjustment">To be added: an object of type 'Gtk.Adjustment'</param>
-        <param name="climb_rate">To be added: an object of type 'double'</param>
-        <param name="digits">To be added: an object of type 'uint'</param>
-        <returns>To be added: an object of type 'Gtk.SpinButton'</returns>
-        <remarks>To be added</remarks>
+        <param name="adjustment">A <see cref="T:Gtk.Adjustment"/></param>
+        <param name="climb_rate">A <see cref="T:System.Double"/></param>
+        <param name="digits">A <see cref="T:uint"/></param>
+        <returns>A <see cref="T:Gtk.SpinButton"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -295,10 +295,10 @@ private void OutputValue(object source, System.EventArgs args)
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
-        <remarks>To be added</remarks>
+        <summary>The acceleration rate when user holds down a button.</summary>
+        <param name="value">A <see cref="T:System.Double"/></param>
+        <returns>A <see cref="T:System.Double"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Wrap">
@@ -379,10 +379,10 @@ private void OutputValue(object source, System.EventArgs args)
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.SpinButtonUpdatePolicy'</param>
-        <returns>To be added: an object of type 'Gtk.SpinButtonUpdatePolicy'</returns>
-        <remarks>To be added</remarks>
+        <summary>The policy for how to update this SpinButton when its value changes.</summary>
+        <param name="value">A <see cref="T:Gtk.SpinButtonUpdatePolicy"/></param>
+        <returns>A <see cref="T:Gtk.SpinButtonUpdatePolicy"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Adjustment">
@@ -394,10 +394,10 @@ private void OutputValue(object source, System.EventArgs args)
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.Adjustment'</param>
-        <returns>To be added: an object of type 'Gtk.Adjustment'</returns>
-        <remarks>To be added</remarks>
+        <summary>The lower/upper/step range of this widget's values.</summary>
+        <param name="value">A <see cref="T:Gtk.Adjustment"/></param>
+        <returns>A <see cref="T:Gtk.Adjustment"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Output">
@@ -408,8 +408,8 @@ private void OutputValue(object source, System.EventArgs args)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when this widget outputs its value.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ValueChanged">
@@ -420,7 +420,7 @@ private void OutputValue(object source, System.EventArgs args)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>This event is fired when the SpinButton's value changes.</summary>
+        <summary>This event is fired after the SpinButton's value changes.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -432,8 +432,8 @@ private void OutputValue(object source, System.EventArgs args)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired when the user inputs a new value.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ChangeValue">
@@ -444,8 +444,8 @@ private void OutputValue(object source, System.EventArgs args)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Fired in order to change the button's value.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -532,4 +532,4 @@ private void OutputValue(object source, System.EventArgs args)
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/StockItem.xml b/doc/en/Gtk/StockItem.xml
index c739f4571..3c16161ee 100644
--- a/doc/en/Gtk/StockItem.xml
+++ b/doc/en/Gtk/StockItem.xml
@@ -136,9 +136,9 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Specifies the translation domain for this item, for use in globalization.</summary>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Submenu.xml b/doc/en/Gtk/Submenu.xml
index 2a88e280f..20810df97 100644
--- a/doc/en/Gtk/Submenu.xml
+++ b/doc/en/Gtk/Submenu.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>A menu that pops out from another menu; see <see cref="M:Gtk.MenuItem.Submenu"/>.</summary>
+    <remarks>TODO: show an example.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -25,9 +25,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Default constructor.</summary>
         <returns>a <see cref="T:Gtk.Submenu" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PlacementGetType">
@@ -38,9 +38,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The placement of this submenu.</summary>
         <returns>a <see cref="T:GLib.GType" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DirectionGetType">
@@ -51,10 +51,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The direction this menu pops out.</summary>
         <returns>a <see cref="T:GLib.GType" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/SurroundingDeletedArgs.xml b/doc/en/Gtk/SurroundingDeletedArgs.xml
index 115386909..2c9647cf1 100644
--- a/doc/en/Gtk/SurroundingDeletedArgs.xml
+++ b/doc/en/Gtk/SurroundingDeletedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <summary>The number of characters that were deleted.</summary>
+        <returns>A <see cref="T:System.Int32"/>.</returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Offset">
@@ -51,10 +51,10 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'int'</returns>
-        <remarks>To be added</remarks>
+        <summary>The offset the characters were deleted near.</summary>
+        <returns>A <see cref="T:System.Int32"/></returns>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TextMarkBody.xml b/doc/en/Gtk/TextMarkBody.xml
index 57552d4cc..0bce25115 100644
--- a/doc/en/Gtk/TextMarkBody.xml
+++ b/doc/en/Gtk/TextMarkBody.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>Do not use.</summary>
+    <remarks>TODO: Can this document be deleted?</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -40,4 +40,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TranslateFunc.xml b/doc/en/Gtk/TranslateFunc.xml
index 225f11643..093ceb4d0 100644
--- a/doc/en/Gtk/TranslateFunc.xml
+++ b/doc/en/Gtk/TranslateFunc.xml
@@ -7,8 +7,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>Delegate used by <see cref="T:Gtk.ItemFactory"/> to translate path elements before they are displayed.</summary>
+    <remarks>TODO: Add an example here.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -29,4 +29,4 @@
   <ReturnValue>
     <ReturnType>System.String</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/WindowKeysForeachFunc.xml b/doc/en/Gtk/WindowKeysForeachFunc.xml
index c7bf7cdbc..b7cf6ae9d 100644
--- a/doc/en/Gtk/WindowKeysForeachFunc.xml
+++ b/doc/en/Gtk/WindowKeysForeachFunc.xml
@@ -7,8 +7,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>Delegate for use by <see cref="" /></summary>
-    <remarks>To be added</remarks>
+    <summary>Delegate class.</summary>
+    <remarks>TODO: There are no references to this class elsewhere in the doc; is it obsolete?</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>