diff --git a/doc/en/Gdk/AxisUse.xml b/doc/en/Gdk/AxisUse.xml
index dc786911d..3542c7abb 100644
--- a/doc/en/Gdk/AxisUse.xml
+++ b/doc/en/Gdk/AxisUse.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>An enumeration describing the way in which a device axis (valuator) maps onto the predefined valuator types that Gtk# understands.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is ignored.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used as the x axis.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used as the y axis.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used for pressure information.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used for x tilt information.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used for y tilt information.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The axis is used for wheel information.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A constant equal to the numerically highest axis value.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Colormap.xml b/doc/en/Gdk/Colormap.xml
index fde4e6c8a..44d6e29d6 100644
--- a/doc/en/Gdk/Colormap.xml
+++ b/doc/en/Gdk/Colormap.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 structure that contains different colors.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -63,11 +63,11 @@
         <Parameter Name="allocate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="visual">To be added: an object of type 'Gdk.Visual'</param>
-        <param name="allocate">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'Gdk.Colormap'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new colormap for the given visual.</summary>
+        <param name="visual">A <see cref="T:Gdk.Visual" /></param>
+        <param name="allocate">if true, the newly created colormap will be a private colormap, and all colors in it will be allocated for the applications use.</param>
+        <returns>The new <see cref="T:Gdk.Colormap" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="System">
@@ -77,9 +77,9 @@
         <ReturnType>Gdk.Colormap</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Colormap'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets the system's default colormap for the default screen.</summary>
+        <returns>The system's default colormap for the default screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Visual">
@@ -89,9 +89,9 @@
         <ReturnType>Gdk.Visual</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Visual'</returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the visual for which a given colormap was created.</summary>
+        <returns>The <see cref="Gdk.Visual" /> of the colormap.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="AllocColor">
@@ -106,12 +106,12 @@
         <Parameter Name="best_match" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="color">To be added: an object of type 'Gdk.Color&amp;'</param>
-        <param name="writeable">To be added: an object of type 'bool'</param>
-        <param name="best_match">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Allocates a single color from a colormap.</summary>
+        <param name="color">The color to allocate. On return the pixel field will be filled in if allocation succeeds.</param>
+        <param name="writeable">If true, the color is allocated writeable (their values can later be changed using <see cref="M:Gdk.Color.Change" />). Writeable colors cannot be shared between applications.</param>
+        <param name="best_match">If true, GDK will attempt to do matching against existing colors if the color cannot be allocated as requested.</param>
+        <returns>True if the allocation succeeded.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Screen">
@@ -121,9 +121,9 @@
         <ReturnType>Gdk.Screen</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Screen" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Gets the screen for which this colormap was created.</summary>
+        <returns>The screen for which this colormap was created.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -150,10 +150,11 @@
         <Parameter Name="result" Type="Gdk.Color&amp;" RefType="ref" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="pixel">a <see cref="T:System.UInt64" /></param>
-        <param name="result">a <see cref="T:Gdk.Color&amp;" /></param>
-        <remarks>To be added</remarks>
+        <summary>Locates the RGB color in the colormap corresponding to the given hardware pixel.</summary>
+        <param name="pixel">Pixel value in hardware display format.</param>
+        <param name="result">
+          <see cref="T:Gdk.Color" /> with red, green, blue fields initialized.</param>
+        <remarks>Pixel must be a valid pixel in the colormap; it's a programmer error to call his function with a pixel which is not in the colormap. Hardware pixels are normally obtained from <see cref="M:Gdk.Colormap.AllocColors" />, or from a <see cref="T:Gdk.Image" />. (A <see cref="T:Gdk.Image" /> contains image data in hardware format, a <see cref="T:Gdk.Pixbuf" /> contains image data in a canonical 24-bit RGB format.)</remarks>
       </Docs>
     </Member>
     <Member MemberName="FreeColors">
@@ -167,10 +168,10 @@
         <Parameter Name="ncolors" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="colors">a <see cref="T:Gdk.Color[]" /></param>
-        <param name="ncolors">a <see cref="T:System.Int32" /></param>
-        <remarks>To be added</remarks>
+        <summary>Frees previously allocated colors.</summary>
+        <param name="colors">The colors to free.</param>
+        <param name="ncolors">The number of colors in colors.</param>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="AllocColors">
@@ -187,14 +188,14 @@
         <Parameter Name="success" Type="System.Boolean[]" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="colors">a <see cref="T:Gdk.Color[]" /></param>
-        <param name="ncolors">a <see cref="T:System.Int32" /></param>
-        <param name="writeable">a <see cref="T:System.Boolean" /></param>
-        <param name="best_match">a <see cref="T:System.Boolean" /></param>
-        <param name="success">a <see cref="T:System.Boolean[]" /></param>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Allocates colors from a colormap.</summary>
+        <param name="colors">The color values to allocate. On return, the pixel values for allocated colors will be filled in.</param>
+        <param name="ncolors">The number of colors in colors.</param>
+        <param name="writeable">If true, the colors are allocated writeable (their values can later be changed using <see cref="M:Gdk.Color.Change" />). Writeable colors cannot be shared between applications.</param>
+        <param name="best_match">If true, GDK will attempt to do matching against existing colors if the colors cannot be allocated as requested.</param>
+        <param name="success">An array of length ncolors. On return, this indicates whether the corresponding color in colors was sucessfully allocated or not.</param>
+        <returns>The number of colors that were not successfully allocated.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
diff --git a/doc/en/Gdk/CrossingMode.xml b/doc/en/Gdk/CrossingMode.xml
index dcaf348b2..c09416683 100644
--- a/doc/en/Gdk/CrossingMode.xml
+++ b/doc/en/Gdk/CrossingMode.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>Specifies the crossing mode for <see cref="T:Gdk.EventCrossing" /></summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Crossing because of pointer motion.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Crossing because a grab is activated.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Crossing because a grab is deactivated.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Cursor.xml b/doc/en/Gdk/Cursor.xml
index 4deaab320..24001d09f 100644
--- a/doc/en/Gdk/Cursor.xml
+++ b/doc/en/Gdk/Cursor.xml
@@ -64,10 +64,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.Cursor" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw managed pointer.</param>
+        <returns>A new <see cref="T:Gdk.Cursor" />.</returns>
+        <remarks>This is an internal constructor, do not use it.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -96,11 +96,11 @@ To make the cursor invisible, use gdk_cursor_new_from_pixmap() to create a curso
         <Parameter Name="cursor_type" Type="Gdk.CursorType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="display">a <see cref="T:Gdk.Display" /></param>
-        <param name="cursor_type">a <see cref="T:Gdk.CursorType" /></param>
-        <returns>a <see cref="T:Gdk.Cursor" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new cursor from the set of builtin cursors.</summary>
+        <param name="display">The <see cref="T:Gdk.Display" /> for which the cursor will be created.</param>
+        <param name="cursor_type">Cursor to create.</param>
+        <returns>A new <see cref="T:Gdk.Cursor" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
diff --git a/doc/en/Gdk/Device.xml b/doc/en/Gdk/Device.xml
index 573a98c53..024aa2449 100644
--- a/doc/en/Gdk/Device.xml
+++ b/doc/en/Gdk/Device.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>This class contains a detailed description of an extended input device.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -37,10 +37,10 @@
         <Parameter Name="n_events" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="events">To be added: an object of type 'Gdk.TimeCoord'</param>
-        <param name="n_events">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>Frees an array of <see cref="T:Gdk.TimeCoord" /> that was returned by <see cref="M:Gdk.Device.GetHistory" />.</summary>
+        <param name="events">An array of <see cref="T:Gdk.TimeCoord" /></param>
+        <param name="n_events">Length of the array.</param>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetMode">
@@ -94,9 +94,9 @@
         <ReturnType>Gdk.Device</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.Device'</returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the core pointer device for the default display.</summary>
+        <returns>the core pointer device.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Source">
@@ -108,10 +108,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.InputSource'</param>
-        <returns>To be added: an object of type 'Gdk.InputSource'</returns>
-        <remarks>To be added</remarks>
+        <summary>Sets the source type for an input device.</summary>
+        <param name="value">Sets the source type for an input device.</param>
+        <returns>None.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetKey">
@@ -181,11 +181,11 @@
         <Parameter Name="value" Type="System.Double&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="axes">a <see cref="T:System.Double&amp;" /></param>
-        <param name="use">a <see cref="T:Gdk.AxisUse" /></param>
-        <param name="value">a <see cref="T:System.Double&amp;" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
+        <summary>Interprets an array of double as axis values for a given device, and locates the value in the array for a given axis use.</summary>
+        <param name="axes">An array of axes.</param>
+        <param name="use">The <see cref="T:Gdk.AxisUse" /> to look for.</param>
+        <param name="value">Found value.</param>
+        <returns>True if the given axis use was found, otherwise false.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -246,9 +246,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Device" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <returns>A new <see cref="T:Gdk.Device" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/DragAction.xml b/doc/en/Gdk/DragAction.xml
index 8f80f4c43..2e861e845 100644
--- a/doc/en/Gdk/DragAction.xml
+++ b/doc/en/Gdk/DragAction.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>Used in <see cref="T:Gdk.DragContext" /> to indicate what the destination should do with the dropped data.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The default action. The same as the Copy action.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Copy the data.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Move the data, i.e. first copy it, then delete it from the source using the DELETE targetof the X selection protocol.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Add a link to the data. Note that this is only useful if source and destination agree on what it means.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Special action which tells the source that the destination will do something that the source doesn't understand.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Ask t user what to do with the data.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/DragContext.xml b/doc/en/Gdk/DragContext.xml
index 9af8a1bed..eca5e7fc7 100644
--- a/doc/en/Gdk/DragContext.xml
+++ b/doc/en/Gdk/DragContext.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>This holds information about a drag in progress. It is used on both source and destination sides.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -60,9 +60,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.DragContext'</returns>
-        <remarks>To be added</remarks>
+        <summary>Default constructor.</summary>
+        <returns>A new <see cref="T:Gdk.DragContext" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DragProtocol">
@@ -73,9 +73,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DragProtocol" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The DND protocol that governs this drag.</summary>
+        <returns>The DND protocol which governs this drag.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="IsSource">
@@ -86,9 +86,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>True if the context is used on the source side.</summary>
+        <returns>True if the context is used on the source side.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SourceWindow">
@@ -99,9 +99,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The source of this drag.</summary>
+        <returns>The source <see cref="T:Gdk.Window" /> of this drag.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DestWindow">
@@ -112,9 +112,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The destination window of this drag.</summary>
+        <returns>The destination window of this drag.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Targets">
@@ -125,9 +125,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom[]" /></returns>
-        <remarks>To be added</remarks>
+        <summary>A list of targets offered by the source.</summary>
+        <returns>A list of targets offered by the source.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Actions">
@@ -138,9 +138,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DragAction" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Various actions proposed by the source when the <see cref="P:Gdk.DragContext.SuggestedAction" /> is <see cref="M:Gdk.DragAction.Ask" /></summary>
+        <returns>Various actions proposed by the source when the <see cref="P:Gdk.DragContext.SuggestedAction" /> is <see cref="M:Gdk.DragAction.Ask" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SuggestedAction">
@@ -151,9 +151,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DragAction" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The action suggested by the source.</summary>
+        <returns>The <see cref="T:Gdk.DragAction" /> suggested by the source.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Action">
@@ -164,9 +164,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DragAction" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The action chosen by the destination.</summary>
+        <returns>The <see cref="T:Gdk.DragAction" /> chosen by the destination.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="StartTime">
@@ -177,9 +177,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>A timestamp, in milliseconds, recording the start time of this drag.</summary>
+        <returns>A timestamp, in milliseconds, recording the start time of this drag.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
diff --git a/doc/en/Gdk/DragProtocol.xml b/doc/en/Gdk/DragProtocol.xml
index 2863a7f0e..f00091c38 100644
--- a/doc/en/Gdk/DragProtocol.xml
+++ b/doc/en/Gdk/DragProtocol.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>Used in <see cref="T:Gdk.DragContext" /> to indicate the protocol according to which DND is done.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The Motif DND protocol.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The Xdnd protocol.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>An extension to the Xdnd protocol for unclaimed root window drops.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The simple WM_DROPFILES protocol.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The complex OLE2 DND protocol (not implemented).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Intra-application DND.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -110,7 +110,7 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Event.xml b/doc/en/Gdk/Event.xml
index c06404180..87da6f995 100644
--- a/doc/en/Gdk/Event.xml
+++ b/doc/en/Gdk/Event.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>This object contains the fields that are common to all Event classes. Any Gdk.Event* can be safely cast to a Gdk.Event</summary>
+    <remarks>This class is equivalent to the GdkEventAny structure in the C API.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Boxed</BaseTypeName>
@@ -42,9 +42,9 @@
         <ReturnType>Gdk.EventType</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.EventType'</returns>
-        <remarks>To be added</remarks>
+        <summary>the type of the event.</summary>
+        <returns>the type of the event.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -68,9 +68,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.IntPtr" /></returns>
-        <remarks>To be added</remarks>
+        <summary>IntPtr for the unmanaged structure.</summary>
+        <returns>The <see cref="T:System.IntPtr" /> to the unmanaged GdkEvent structure.</returns>
+        <remarks>This property should rarely if ever need to be accessed.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Window">
@@ -81,9 +81,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The window which received the event.</summary>
+        <returns>The window which received the event.</returns>
+        <remarks>This is a <see cref="T:Gdk.Window" /> not a <see cref="T:Gtk.Window" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SendEvent">
@@ -94,9 +94,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>true if the event was sent explicitly (e.g. using XSendEvent).</summary>
+        <returns>true if the event was sent explicitly (e.g. using XSendEvent).</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventButton.xml b/doc/en/Gdk/EventButton.xml
index ce97d7f69..d04b8ffc8 100644
--- a/doc/en/Gdk/EventButton.xml
+++ b/doc/en/Gdk/EventButton.xml
@@ -237,10 +237,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>Constructor</summary>
+        <summary>Internal constructor</summary>
         <param name="raw">a <see cref="T:System.IntPtr" /> to a <see cref="T:Gdk.Event.Handle" /></param>
         <returns>a <see cref="T:Gdk.EventButton" /></returns>
-        <remarks />
+        <remarks>This constructor is internal and should not be used.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventClient.xml b/doc/en/Gdk/EventClient.xml
index 62ec91d4d..61b96567d 100644
--- a/doc/en/Gdk/EventClient.xml
+++ b/doc/en/Gdk/EventClient.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom" /></returns>
-        <remarks>To be added</remarks>
+        <summary>the type of the message, which can be defined by the application.</summary>
+        <returns>the type of the message, which can be defined by the application.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DataFormat">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt16" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The format of the <see cref="P:Gdk.EventClient.Data" /></summary>
+        <returns>the format of the data, given as the number of bits in each data element, i.e. 8, 16, or 32.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Data">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Array" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The data.</summary>
+        <returns>If <see cref="P:Gdk.EventClient.DataFormat" /> is 8, then this array is 20 characters, if it returns 16, then the array is 10 shorts, and if it returns 32, the array is 5 longs.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -67,10 +67,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventClient" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventClient" /></returns>
+        <remarks>This constructor is internal and should not be used.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventConfigure.xml b/doc/en/Gdk/EventConfigure.xml
index 403a39dcb..0439759e4 100644
--- a/doc/en/Gdk/EventConfigure.xml
+++ b/doc/en/Gdk/EventConfigure.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The new x coordinate of the window, relative to its parent.</summary>
+        <returns>The new x coordinate of the window, relative to its parent.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The new y coordinate of the window, relative to the parent.</summary>
+        <returns>The new y coordinate of the window, relative to its parent.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Width">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The new width of the window.</summary>
+        <returns>The new width of the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Height">
@@ -67,9 +67,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The new height of the window.</summary>
+        <returns>The new height of the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -80,10 +80,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventConfigure" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">the raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventConfigure" /></returns>
+        <remarks>This constructor is internal, and should not be used.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventCrossing.xml b/doc/en/Gdk/EventCrossing.xml
index 7c16826a1..2d554b66a 100644
--- a/doc/en/Gdk/EventCrossing.xml
+++ b/doc/en/Gdk/EventCrossing.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.ModifierType" /></returns>
-        <remarks>To be added</remarks>
+        <summary>An enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</summary>
+        <returns>An enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="X">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the window.</summary>
+        <returns>The x coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -67,9 +67,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the window.</summary>
+        <returns>The y coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="XRoot">
@@ -80,9 +80,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The x coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="YRoot">
@@ -93,9 +93,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The y coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Subwindow">
@@ -106,9 +106,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Window" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The window that was entered or left.</summary>
+        <returns>The window that was entered or left.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Mode">
@@ -119,9 +119,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.CrossingMode" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The crossing mode.</summary>
+        <returns>The crossing mode.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Detail">
@@ -132,9 +132,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.NotifyType" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The kind of crossing that happened.</summary>
+        <returns>The kind of crossing that happened.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Focus">
@@ -145,9 +145,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>True if window is the focus window or an inferior.</summary>
+        <returns>True if window is the focus window or an inferior.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -158,10 +158,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventCrossing" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw managed pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventCrossing" /></returns>
+        <remarks>This constructor should never be used.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventDND.xml b/doc/en/Gdk/EventDND.xml
index 6195b0838..5f9df0ea6 100644
--- a/doc/en/Gdk/EventDND.xml
+++ b/doc/en/Gdk/EventDND.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The <see cref="T:Gdk.DragContext" /> for the current DND operation.</summary>
+        <returns>The Gdk.DragContext for the current DND operation.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Time">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="XRoot">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int16" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the root of the screen, only set for GDK_DRAG_MOTION and GDK_DROP_START (Find C# references for these).</summary>
+        <returns>The x coordinate of the pointer relative to the root of the screen, only set for GDK_DRAG_MOTION and GDK_DROP_START (Find C# references for these).</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="YRoot">
@@ -67,9 +67,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int16" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the root of the screen, only set for GDK_DRAG_MOTION and GDK_DROP_START (Find C# references for these).</summary>
+        <returns>The y coordinate of the pointer relative to the root of the screen, only set for GDK_DRAG_MOTION and GDK_DROP_START (Find C# references for these).</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -80,10 +80,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventDND" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventDND" /></returns>
+        <remarks>This constructor is internal and should not be used.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventExpose.xml b/doc/en/Gdk/EventExpose.xml
index 64c75ef9e..0d847b48b 100644
--- a/doc/en/Gdk/EventExpose.xml
+++ b/doc/en/Gdk/EventExpose.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Rectangle" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The bounding box of the <see cref="P:Gdk.EventExpose.Region" /></summary>
+        <returns>The bounding box of the <see cref="P:Gdk.EventExpose.Region" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Count">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The number of contiguous Expose Events following this one.</summary>
+        <returns>The number of contiguous Expose Events following this one.</returns>
+        <remarks>The only use for this is "exposure compression", i.e. handling all contiguous Expose events in one go, though GDK performs some exposure compression so this is not normally needed</remarks>
       </Docs>
     </Member>
     <Member MemberName="Region">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Region" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The region that needs to be redrawn.</summary>
+        <returns>The <see cref="T:Gdk.Region" /> that needs to be redrawn.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -67,10 +67,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventExpose" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventExpose" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventFocus.xml b/doc/en/Gdk/EventFocus.xml
index 1881aeaf8..d532c6fe0 100644
--- a/doc/en/Gdk/EventFocus.xml
+++ b/doc/en/Gdk/EventFocus.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>True if the window has gained the keyboard focus, false if it has lost the focus.</summary>
+        <returns>True if the window has gained the keyboard focus, false if it has lost the focus.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -41,10 +41,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventFocus" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventFocus" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventHelper.xml b/doc/en/Gdk/EventHelper.xml
index e71140a1f..ea1d910f7 100644
--- a/doc/en/Gdk/EventHelper.xml
+++ b/doc/en/Gdk/EventHelper.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 utility class that contains methods that operate on Event classes.</summary>
+    <remarks>This class contains static methods.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -29,10 +29,10 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Copies a <see cref="T:Gdk.Event" />.</summary>
+        <param name="evnt">The <see cref="T:Gdk.Event" /> to copy.</param>
+        <returns>The copied <see cref="T:Gdk.Event" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Get">
@@ -43,9 +43,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Checks all open displays for a <see cref="T:Gdk.Event" /> to process, fetching events from the windowing system if necessary. See <see cref="P:Gdk.Display.Event" />.</summary>
+        <returns>The next <see cref="T:Gdk.Event" /> to be processed, or null if no events are pending. The returned <see cref="T:Gdk.Event" /> should be freed with <see cref="M:Gdk.EventHelper.Free" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetScreen">
@@ -58,9 +58,9 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <returns>a <see cref="T:Gdk.Screen" /></returns>
+        <summary>Returns the screen for the event. The screen is typically the screen for <see cref="P:Gdk.Event.Window" />, but for events such as mouse events, it is the screen where the pointer was when the event occurs.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <returns>The <see cref="T:Gdk.Screen" /> for the event.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -72,9 +72,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <summary>If there is an event waiting in the event queue of some open display, returns a copy of it. See <see cref="M:Gdk.Display.PeekEvent" />.</summary>
+        <returns>A copy of the first <see cref="T:Gdk.Event" /> on some event queue, or null if no events are in any queues.</returns>
+        <remarks>The returned <see cref="T:Gdk.Event" /> should be freed with <see cref="M:Gdk.EventHelper.Free" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -87,10 +87,10 @@
         <Parameter Name="type" Type="Gdk.EventType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="type">a <see cref="T:Gdk.EventType" /></param>
-        <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new event of the given type. All fields are set to 0.</summary>
+        <param name="type">A <see cref="T:Gdk.EventType" /></param>
+        <returns>A <see cref="T:Gdk.Event" /></returns>
+        <remarks>The returned event should be freed with <see cref="M:Gdk.EventHelper.Free" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SendClientMessageForDisplay">
@@ -105,12 +105,13 @@
         <Parameter Name="winid" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="display">a <see cref="T:Gdk.Display" /></param>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="winid">a <see cref="T:System.UInt32" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>On X11, sends an X ClientMessage event to a given window. On Windows, sends a message registered with the name GDK_WIN32_CLIENT_MESSAGE.
+This could be used for communicating between different applications, though the amount of data is limited to 20 bytes on X11, and to just four bytes on Windows.</summary>
+        <param name="display">The <see cref="T:Gdk.Display" /> for the window where the message is to be sent.</param>
+        <param name="evnt">The <see cref="T:Gdk.Event" /> to send, which should be a <see cref="T.Gdk.EventClient" />.</param>
+        <param name="winid">The window to send the client message to.</param>
+        <returns>True on success.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Free">
@@ -123,9 +124,10 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <remarks>To be added</remarks>
+        <summary>Frees a <see cref="T:Gdk.Event" />.</summary>
+        <param name="evnt">
+          <see cref="T:Gdk.Event" /> to free.</param>
+        <remarks>This should only be called with events returned from functions such as <see cref="M:Gdk.EventHelper.Peek" />, <see cref="M:Gdk.EventHelper.Get" />, <see cref="M:Gdk.EventHelper.GetGraphicsExpose" /> and <see cref="M:Gdk.EventHelper.Copy" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SendClientmessageToall">
@@ -138,9 +140,9 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <remarks>To be added</remarks>
+        <summary>Sends an X ClientMessage event to all toplevel windows on the default <see cref="T:Gdk.Screen" />. Toplevel windows are determined by checking for the WM_STATE property, as described in the Inter-Client Communication Conventions Manual (ICCCM). If no windows are found with the WM_STATE property set, the message is sent to all children of the root window.</summary>
+        <param name="evnt">The <see cref="T:Gdk.Event" /> to send, which should be a <see cref="T:Gdk.EventClient" />.</param>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SendClientMessage">
@@ -154,11 +156,11 @@
         <Parameter Name="winid" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="winid">a <see cref="T:System.UInt32" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Sends an X ClientMessage event to a given window (which must be on the default <see cref="T:Gdk.Display" />.) This could be used for communicating between different applications, though the amount of data is limited to 20 bytes.</summary>
+        <param name="evnt">The <see cref="T:Gdk.Event" /> to send, which should be a <see cref="T:Gdk.EventClient" />.</param>
+        <param name="winid">The window to send the X ClientMessage event to.</param>
+        <returns>True on success.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetTime">
@@ -171,10 +173,10 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the time stamp from event, if there is one. Otherwise returns the current time. If event is null, returns the current time..</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <returns>Time stamp field from event.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetGraphicsExpose">
@@ -187,10 +189,10 @@
         <Parameter Name="window" Type="Gdk.Window" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="window">a <see cref="T:Gdk.Window" /></param>
-        <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Waits for a GraphicsExpose or NoExpose event from the X server. This is used in the GtkText and GtkCList widgets in Gtk# to make sure any Graphics Expose events are handled before the widget is scrolled.</summary>
+        <param name="window">The <see cref="T:Gdk.Window" /> to wait for the events for.</param>
+        <returns>A <see cref="T:Gdk.EventExpose" /> if a GraphicsExpose was received, or null if a NoExpose event was received.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetScreen">
@@ -204,10 +206,10 @@
         <Parameter Name="screen" Type="Gdk.Screen" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="screen">a <see cref="T:Gdk.Screen" /></param>
-        <remarks>To be added</remarks>
+        <summary>Sets the screen for event to screen. The event must have been allocated by GTK+, for instance, by <see cref="M:Gdk.EventHelper.Copy" />.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <param name="screen">A <see cref="T:Gdk.Screen" /></param>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Put">
@@ -220,9 +222,9 @@
         <Parameter Name="evnt" Type="Gdk.Event" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <remarks>To be added</remarks>
+        <summary>Appends a copy of the given event onto the front of the event queue for <see cref="P:Gdk.Event.Window" />'s display, or the default queue if that window is null. See <see cref="M:Gdk.Display.PutEvent" />.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -231,9 +233,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.EventHelper" /></returns>
-        <remarks>To be added</remarks>
+        <summary>This constructor is never used.</summary>
+        <returns>A new <see cref="T:Gdk.EventHelper" /></returns>
+        <remarks>This class contains only static methods, and this constructor should never be used.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetCoords">
@@ -248,12 +250,12 @@
         <Parameter Name="y_win" Type="System.Double&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="x_win">a <see cref="T:System.Double&amp;" /></param>
-        <param name="y_win">a <see cref="T:System.Double&amp;" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Extract the event window relative x/y coordinates from an event.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <param name="x_win">Event window x coordinate.</param>
+        <param name="y_win">Event window y coordinate.</param>
+        <returns>True if the event delivered event coordinates.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetState">
@@ -267,10 +269,10 @@
         <Parameter Name="state" Type="Gdk.ModifierType&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="state">a <see cref="T:Gdk.ModifierType&amp;" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
+        <summary>If the event contains a "state" field, puts that field in state. Otherwise stores an empty state (0).</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /> or null.</param>
+        <param name="state">The <see cref="T:Gdk.ModifierType" /> of the event.</param>
+        <returns>True if there was a state field in the event.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -286,12 +288,12 @@
         <Parameter Name="value" Type="System.Double&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="axis_use">a <see cref="T:Gdk.AxisUse" /></param>
-        <param name="value">a <see cref="T:System.Double&amp;" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Extract the axis value for a particular axis use from an event.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <param name="axis_use">The axis use to look for.</param>
+        <param name="value">The value found.</param>
+        <returns>True if the specified axis was found, otherwise false.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetRootCoords">
@@ -306,12 +308,12 @@
         <Parameter Name="y_root" Type="System.Double&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="evnt">a <see cref="T:Gdk.Event" /></param>
-        <param name="x_root">a <see cref="T:System.Double&amp;" /></param>
-        <param name="y_root">a <see cref="T:System.Double&amp;" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Extract the root window relative x/y coordinates from an event.</summary>
+        <param name="evnt">A <see cref="T:Gdk.Event" /></param>
+        <param name="x_root">Root window x coordinate.</param>
+        <param name="y_root">Root window y coordinate.</param>
+        <returns>True if the event delivered root window coordinates.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
diff --git a/doc/en/Gdk/EventKey.xml b/doc/en/Gdk/EventKey.xml
index a575aac13..1de22df79 100644
--- a/doc/en/Gdk/EventKey.xml
+++ b/doc/en/Gdk/EventKey.xml
@@ -27,9 +27,9 @@
         <ReturnType>Gdk.Key</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Key" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The key that was pressed or released.</summary>
+        <returns>The key that was pressed or released.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Time">
@@ -40,9 +40,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -53,9 +53,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.ModifierType" /></returns>
-        <remarks>To be added</remarks>
+        <summary>A enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</summary>
+        <returns>A enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="KeyValue">
@@ -66,9 +66,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The key that was pressed or released.</summary>
+        <returns>The key that was pressed or released.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="HardwareKeycode">
@@ -79,9 +79,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt16" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The raw code of the key that was pressed or released.</summary>
+        <returns>The raw code of the key that was pressed or released.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Group">
@@ -92,9 +92,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Byte" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The keyboard group.</summary>
+        <returns>The keyboard group.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -105,10 +105,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventKey" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventKey" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventMotion.xml b/doc/en/Gdk/EventMotion.xml
index 305dd02a3..8645404fb 100644
--- a/doc/en/Gdk/EventMotion.xml
+++ b/doc/en/Gdk/EventMotion.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.ModifierType" /></returns>
-        <remarks>To be added</remarks>
+        <summary>An enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</summary>
+        <returns>An enum representing the state of the modifier keys (e.g. Control, Shift, Alt) and the pointer buttons.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="X">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to window.</summary>
+        <returns>The x coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -67,9 +67,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the window.</summary>
+        <returns>The y coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="XRoot">
@@ -80,9 +80,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The x coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="YRoot">
@@ -93,9 +93,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The y coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="IsHint">
@@ -106,9 +106,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>True if this event is just a hint.</summary>
+        <returns>True if the event is just a hint.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Device">
@@ -119,9 +119,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Device" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The device where the event originated.</summary>
+        <returns>The device where the event originated.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Axes">
@@ -132,9 +132,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double[]" /></returns>
-        <remarks>To be added</remarks>
+        <summary>
+          <see cref="P:Gdk.EventMotion.X" />,<see cref="P:Gdk.EventMotion.Y" /> translated to the axes of <see cref="P:Gdk.EventMotion.Device" />, or null if <see cref="P:Gdk.EventMotion.Device" /> is the mouse.</summary>
+        <returns>
+          <see cref="Gdk.EventMotion.X" />,<see cref="Gdk.EventMotion.Y" /> translated to the axes of <see cref="Gdk.EventMotion.Device" />, or null if <see cref="Gdk.EventMotion.Device" /> is the mouse.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -145,10 +147,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventMotion" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventMotion" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventProperty.xml b/doc/en/Gdk/EventProperty.xml
index 2ef797de6..2c6ad944a 100644
--- a/doc/en/Gdk/EventProperty.xml
+++ b/doc/en/Gdk/EventProperty.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The property that was changed.</summary>
+        <returns>The property that was changed.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.PropertyState" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Whether the property was changed, or deleted.</summary>
+        <returns>Whether the property was changed.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Time">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event of milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -67,10 +67,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventProperty" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventProperty" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventProximity.xml b/doc/en/Gdk/EventProximity.xml
index 0d9f78d51..5657cb56c 100644
--- a/doc/en/Gdk/EventProximity.xml
+++ b/doc/en/Gdk/EventProximity.xml
@@ -37,9 +37,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Device" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The device where the event originated.</summary>
+        <returns>The device where the event originated.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Time">
@@ -50,9 +50,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -63,10 +63,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventProximity" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventProximity" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventScroll.xml b/doc/en/Gdk/EventScroll.xml
index 1129386b1..b5045d2ee 100644
--- a/doc/en/Gdk/EventScroll.xml
+++ b/doc/en/Gdk/EventScroll.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="State">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.ModifierType" /></returns>
-        <remarks>To be added</remarks>
+        <summary>An enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</summary>
+        <returns>An enum representing the state of the modifier keys (e.g. Control, Shift and Alt) and the pointer buttons.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="X">
@@ -54,9 +54,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the window.</summary>
+        <returns>The x coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -67,9 +67,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the window.</summary>
+        <returns>The y coordinate of the pointer relative to the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="XRoot">
@@ -80,9 +80,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The x coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The x coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="YRoot">
@@ -93,9 +93,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Double" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The y coordinate of the pointer relative to the root of the screen.</summary>
+        <returns>The y coordinate of the pointer relative to the root of the screen.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Direction">
@@ -106,9 +106,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.ScrollDirection" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The direction to scroll to.</summary>
+        <returns>The direction to scroll to.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Device">
@@ -119,9 +119,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Device" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The device where the event originated.</summary>
+        <returns>The device where the event originated.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -132,10 +132,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventScroll" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventScroll" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventSelection.xml b/doc/en/Gdk/EventSelection.xml
index 77f8bb60e..dd887b913 100644
--- a/doc/en/Gdk/EventSelection.xml
+++ b/doc/en/Gdk/EventSelection.xml
@@ -27,9 +27,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The property in which to place the result of the conversation.</summary>
+        <returns>The property in which to place the result of the conversion.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Selection">
@@ -40,9 +40,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The selection.</summary>
+        <returns>The selection.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Target">
@@ -53,9 +53,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Atom" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The target to which the selection should be converted.</summary>
+        <returns>The target to which the selection should be converted.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Requestor">
@@ -66,9 +66,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The native window on which to place <see cref="P:Gdk.EventSelection.Property" />.</summary>
+        <returns>The native window on which to place <see cref="P:Gdk.EventSelection.Property" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Time">
@@ -79,9 +79,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The time of the event in milliseconds.</summary>
+        <returns>The time of the event in milliseconds.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -92,10 +92,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventSelection" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventSelection" /></returns>
+        <remarks>Internal constructor, do not use.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventSetting.xml b/doc/en/Gdk/EventSetting.xml
index 20a3ce358..99744b28e 100644
--- a/doc/en/Gdk/EventSetting.xml
+++ b/doc/en/Gdk/EventSetting.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>Generated when a setting is modified.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -27,9 +27,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.SettingAction" /></returns>
-        <remarks>To be added</remarks>
+        <summary>What happened to the setting.</summary>
+        <returns>What happened to the setting.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -40,9 +40,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The name of the setting.</summary>
+        <returns>The name of the setting.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -53,10 +53,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventSetting" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventSetting" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventType.xml b/doc/en/Gdk/EventType.xml
index 8b15cad70..7126c7e0b 100644
--- a/doc/en/Gdk/EventType.xml
+++ b/doc/en/Gdk/EventType.xml
@@ -421,7 +421,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -433,7 +433,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -445,7 +445,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/EventVisibility.xml b/doc/en/Gdk/EventVisibility.xml
index bdb96b35a..62f325226 100644
--- a/doc/en/Gdk/EventVisibility.xml
+++ b/doc/en/Gdk/EventVisibility.xml
@@ -75,10 +75,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventVisibility" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventVisibility" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/EventWindowState.xml b/doc/en/Gdk/EventWindowState.xml
index f3260125e..d67ba0afd 100644
--- a/doc/en/Gdk/EventWindowState.xml
+++ b/doc/en/Gdk/EventWindowState.xml
@@ -28,9 +28,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.WindowState" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Mask specifying what flags have changed.</summary>
+        <returns>Mask specifying what flags have changed.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="NewWindowState">
@@ -41,9 +41,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.WindowState" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The new window state.</summary>
+        <returns>The new window state.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -54,10 +54,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="raw">a <see cref="T:System.IntPtr" /></param>
-        <returns>a <see cref="T:Gdk.EventWindowState" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.EventWindowState" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/ModifierType.xml b/doc/en/Gdk/ModifierType.xml
index 46d051f7b..4ce1eec04 100644
--- a/doc/en/Gdk/ModifierType.xml
+++ b/doc/en/Gdk/ModifierType.xml
@@ -10,8 +10,10 @@
   </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>An enum to indicate the state of modifier keys and mouse buttons in various event types. Typical modifier keys are Shift, Control, Meta, Super, Hyper, Alt, Compose, APple, CapsLock or ShiftLock.
+
+Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +39,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The Shift key.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +51,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A Lock Key (depending on the modifier mapping of the X server this may either be CapsLock or ShiftLock).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +63,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The Control key.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +75,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The fourth modifier key (it depends on the modifier mapping of the X server which key is interpreted as this modifer, but normally it is the Alt key).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +87,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The fifth modifier key (it depends on the modifier mapping of the X server which key is interpreted as this modifier).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +99,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The sixth modifier key (it depends on the modifier mapping of the X server which key is interpreted as this modifier).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +111,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The seventh modifier key (it depends on the modifier mapping of the X server which key is interpreted as this modifier).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +123,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The eighth modifier key (it depends on the modifier mapping of the X servier which key is interpreted as this modifier).</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -133,7 +135,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The first mouse button.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -145,7 +147,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The second mouse button.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -157,7 +159,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The third mouse button.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -169,7 +171,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The fourth mouse button.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -181,7 +183,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The fifth mouse button.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -193,7 +195,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -205,7 +207,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>None.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/NotifyType.xml b/doc/en/Gdk/NotifyType.xml
index 57e35d0f3..5afc93642 100644
--- a/doc/en/Gdk/NotifyType.xml
+++ b/doc/en/Gdk/NotifyType.xml
@@ -10,8 +10,9 @@
   </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>Specifies the kind of crossing for <see cref="T:Gdk.EventCrossing" /><para />
+See the X11 protocol specification of LeaveNotify for full details of crossing event generation.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +38,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is entered from an ancestor or left towards an ancestor.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +50,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The pointer moves between an ancestor and an inferior of the window.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +62,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is entered from an inferior or left towards an inferior.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +74,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is entered from or left towards a window which is neither an ancestor nor an inferior. </summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +86,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The pointer moves between two windows which are not ancestors of each other and the window is part of the ancestor chain between one of these windows and their least common ancestor.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +98,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>An unknown type.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/PropertyState.xml b/doc/en/Gdk/PropertyState.xml
index 5b4725072..849a7ab7f 100644
--- a/doc/en/Gdk/PropertyState.xml
+++ b/doc/en/Gdk/PropertyState.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>Specifies the type of a property change for a <see cref="T:Gdk.EventProperty" />.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The property value was changed.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The property value was deleted.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/ScrollDirection.xml b/doc/en/Gdk/ScrollDirection.xml
index a443e31da..1d4e435d8 100644
--- a/doc/en/Gdk/ScrollDirection.xml
+++ b/doc/en/Gdk/ScrollDirection.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>Specifies the direction for the <see cref="T:Gdk.EventScroll" />.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is scrolled up.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is scrolled down.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is scrolled left.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window is scrolled right.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/SettingAction.xml b/doc/en/Gdk/SettingAction.xml
index ce1b39677..475b5c2c6 100644
--- a/doc/en/Gdk/SettingAction.xml
+++ b/doc/en/Gdk/SettingAction.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>Specifies the kind of modification applied to a setting in a <see cref="T:Gdk.EventSetting" />.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A setting was added.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A setting was changed.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A setting was deleted.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Visual.xml b/doc/en/Gdk/Visual.xml
index a6f3aa4d1..0d133c5f0 100644
--- a/doc/en/Gdk/Visual.xml
+++ b/doc/en/Gdk/Visual.xml
@@ -229,9 +229,9 @@
         <ReturnType>Gdk.Screen</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Screen" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Gets the screen to which this visual belongs.</summary>
+        <returns>The <see cref="T:Gdk.Screen" /> to which this visual belongs.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -267,9 +267,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Visual" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Default constructor.</summary>
+        <returns>A new <see cref="T:Gdk.Visual" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/WindowAttr.xml b/doc/en/Gdk/WindowAttr.xml
index 06efeb04f..8edb95395 100644
--- a/doc/en/Gdk/WindowAttr.xml
+++ b/doc/en/Gdk/WindowAttr.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>Attributes to use for a newly-created window.</summary>
+    <remarks>None.</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>A zeroed structure.</summary>
+        <remarks>None.</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 'Gdk.WindowAttr'</returns>
-        <remarks>To be added</remarks>
+        <summary>Internal method.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new WindowAttr.</returns>
+        <remarks>Internal method, do not use this.</remarks>
       </Docs>
     </Member>
     <Member MemberName="colormap">
@@ -56,10 +56,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Colormap'</param>
+        <summary>Colormap for the window.</summary>
+        <param name="value">Colormap for the window.</param>
         <returns>To be added: an object of type 'Gdk.Colormap'</returns>
-        <remarks>To be added</remarks>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="visual">
@@ -71,10 +71,13 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Visual'</param>
-        <returns>To be added: an object of type 'Gdk.Visual'</returns>
-        <remarks>To be added</remarks>
+        <summary>
+          <see cref="T:Gdk.Visual" /> for the window.</summary>
+        <param name="value">
+          <see cref="T:Gdk.Visual" /> for the window.</param>
+        <returns>
+          <see cref="T:Gdk.Visual" /> for the window.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="cursor">
@@ -85,9 +88,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Cursor" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Cursor for the window (see <see cref="P:Gdk.Window.Cursor" />).</summary>
+        <returns>Cursor for the window. (see <see cref="P:Gdk.Window.Cursor" />).</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Title">
@@ -99,8 +102,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Title of the window (for toplevel windows).</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="EventMask">
@@ -112,8 +115,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Event mask.</summary>
+        <remarks>See <see cref="P:Gdk.Window.Events" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="X">
@@ -125,8 +128,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>X coordinate relative to parent window. (see <see cref="M:Gdk.Window.Move" />).</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -138,8 +141,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Y coordinate relative to parent window (see <see cref="M:Gdk.Window.Move" />).</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Width">
@@ -151,8 +154,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Width of the window.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Height">
@@ -164,8 +167,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Height of the window.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Wclass">
@@ -177,8 +180,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>InputOutput (for a normal window) or InputOnly (for a invisible window that receives events).</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="WindowType">
@@ -190,8 +193,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Type of the window.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="WmclassName">
@@ -203,8 +206,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Don't use.</summary>
+        <remarks>Don't use.</remarks>
       </Docs>
     </Member>
     <Member MemberName="WmclassClass">
@@ -216,8 +219,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Don't use.</summary>
+        <remarks>Don't use.</remarks>
       </Docs>
     </Member>
     <Member MemberName="OverrideRedirect">
@@ -229,8 +232,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>True to bypass the window manager.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/WindowAttributesType.xml b/doc/en/Gdk/WindowAttributesType.xml
index e737aeb8f..d136e71cd 100644
--- a/doc/en/Gdk/WindowAttributesType.xml
+++ b/doc/en/Gdk/WindowAttributesType.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>Used to indicate which fields in the <see cref="T:Gdk.WindowAttr" /> struct should be honored.</summary>
+    <remarks>For example, if you filled in the "cursor" and "x" fields of <see cref="T:Gdk.WindowAttr" />, pass Gdk.WindowAttributesType.X | Gdk.WindowAttributesType.Cursor to new Gdk.Window (). Fields in <see cref="T:Gdk.WindowAttr" /> not covered by a bit in this enum are required; for example, the width/height, wclass, and window_type fields are required.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the title field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the x coordinate field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the y coordinate field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the cursor field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the colormap field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the visual field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the wmclass_class and wmclass_name fields.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Honor the override_redirect field.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/WindowHints.xml b/doc/en/Gdk/WindowHints.xml
index 95faab67f..7e9ffa504 100644
--- a/doc/en/Gdk/WindowHints.xml
+++ b/doc/en/Gdk/WindowHints.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>Used to indicate which fields of a <see cref="T:Gdk.Geometry" /> struct should be paid attention to.</summary>
+    <remarks>Also, the presence/absence of Pos, UserPos, and UserSize is significant, though they don't directly refer to GdkGeometry fields. UserPos will be set automatically by GtkWindow if you call <see cref="M:Gtk.Window.Move" />. UserPos and UserSize should be set if the user specified a size/position using a --geometry command-line argument; <see cref="M:Gtk.Window.ParseGeometry" /> automatically sets these flags.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Indicates that the program has positioned the window.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Min size fields are set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Max size fields are set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Base size fields are set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Aspect ratio fields are set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Resize increment fields are set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Window gravity field is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Indicates that the window's poition was explicitly set by the user.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -133,7 +133,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Indicates that the window's size was explicitly set by the user.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>