From 992d9506d19237b9b7ed8dbcc940a61c53aa4c19 Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Tue, 29 Jun 2004 14:15:37 +0000
Subject: [PATCH] From Todd Berman

svn path=/trunk/gtk-sharp/; revision=30513
---
 doc/en/Gdk/Atom.xml              |  6 ++---
 doc/en/Gdk/Bitmap.xml            | 20 ++++++++--------
 doc/en/Gdk/CapStyle.xml          | 12 +++++-----
 doc/en/Gdk/ClosedArgs.xml        |  6 ++---
 doc/en/Gdk/CursorType.xml        |  4 ++--
 doc/en/Gdk/DestroyNotify.xml     |  4 ++--
 doc/en/Gdk/Display.xml           | 10 ++++----
 doc/en/Gdk/DisplayManager.xml    | 40 ++++++++++++++++----------------
 doc/en/Gdk/DisplayOpenedArgs.xml |  6 ++---
 doc/en/Gdk/Fill.xml              | 12 +++++-----
 doc/en/Gdk/FillRule.xml          |  8 +++----
 doc/en/Gdk/FilterReturn.xml      | 10 ++++----
 doc/en/Gdk/Function.xml          | 36 ++++++++++++++--------------
 doc/en/Gdk/GCValuesMask.xml      | 40 ++++++++++++++++----------------
 doc/en/Gdk/GrabStatus.xml        | 14 +++++------
 doc/en/Gdk/Gravity.xml           | 24 +++++++++----------
 doc/en/Gdk/ImageType.xml         | 10 ++++----
 doc/en/Gdk/InputMode.xml         |  2 +-
 doc/en/Gdk/InputSource.xml       |  3 +--
 doc/en/Gdk/OverlapType.xml       | 10 ++++----
 doc/en/Gdk/PropMode.xml          | 10 ++++----
 doc/en/Gdk/RgbDither.xml         | 10 ++++----
 doc/en/Gdk/SubwindowMode.xml     |  8 +++----
 doc/en/Gdk/WMFunction.xml        | 16 ++++++-------
 24 files changed, 159 insertions(+), 162 deletions(-)

diff --git a/doc/en/Gdk/Atom.xml b/doc/en/Gdk/Atom.xml
index bbf9bc42b..9db02fe54 100644
--- a/doc/en/Gdk/Atom.xml
+++ b/doc/en/Gdk/Atom.xml
@@ -66,9 +66,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Determines the string corresponding to an atom.</summary>
+        <returns>A newly-allocated string containing the string corresponding to the atom.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/Bitmap.xml b/doc/en/Gdk/Bitmap.xml
index 913028046..11b4fdfba 100644
--- a/doc/en/Gdk/Bitmap.xml
+++ b/doc/en/Gdk/Bitmap.xml
@@ -67,13 +67,13 @@
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="drawable">a <see cref="T:Gdk.Drawable" /></param>
-        <param name="data">a <see cref="T:System.String" /></param>
-        <param name="width">a <see cref="T:System.Int32" /></param>
-        <param name="height">a <see cref="T:System.Int32" /></param>
-        <returns>a <see cref="T:Gdk.Bitmap" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new bitmap from data in XBM format.</summary>
+        <param name="drawable">A <see cref="T:Gdk.Drawable" />, used to determine default values for the new pixmap. Can be null, in which case the root window is used.</param>
+        <param name="data">A string representing the XBM data.</param>
+        <param name="width">The width of the new pixmap in pixels.</param>
+        <param name="height">The height of the new pixmap in pixels.</param>
+        <returns>The <see cref="T:Gdk.Bitmap" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -96,9 +96,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Bitmap" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Default constructor.</summary>
+        <returns>A new <see cref="T:Gdk.Bitmap" /></returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/CapStyle.xml b/doc/en/Gdk/CapStyle.xml
index 3766b9560..62f80d5d8 100644
--- a/doc/en/Gdk/CapStyle.xml
+++ b/doc/en/Gdk/CapStyle.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>Determines how the end of lines are drawn.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The same as Butt for lines of non-zero width. For zero width lines, the final point on the line will not be drawn.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The ends of the lines are drawn squared off and extending to the coordinates of the end point.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The ends of the lines are drawn as semicircles with the diameter equal to the line width and centered at the end point.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The ends of the lines are drawn squared off and extending half the width of the line beyond the end point.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/ClosedArgs.xml b/doc/en/Gdk/ClosedArgs.xml
index 2c02c3b56..2343c5376 100644
--- a/doc/en/Gdk/ClosedArgs.xml
+++ b/doc/en/Gdk/ClosedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Returns true if the display was closed due to an error.</summary>
+        <returns>True if the display was closed due to an error.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/CursorType.xml b/doc/en/Gdk/CursorType.xml
index b4d0098fe..9abe3865b 100644
--- a/doc/en/Gdk/CursorType.xml
+++ b/doc/en/Gdk/CursorType.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>The standard cursors available.</summary>
+    <remarks>These do not document very well currently. If you look at the GDK api docs for GdkCursorType, you can see pictures that correspond to these different cursor types.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
diff --git a/doc/en/Gdk/DestroyNotify.xml b/doc/en/Gdk/DestroyNotify.xml
index c411de002..da999a2e7 100644
--- a/doc/en/Gdk/DestroyNotify.xml
+++ b/doc/en/Gdk/DestroyNotify.xml
@@ -7,8 +7,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>A callback function called when a piece of user data is no longer being stored by GDK.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Gdk/Display.xml b/doc/en/Gdk/Display.xml
index 9bbe4f22b..eddaa849b 100644
--- a/doc/en/Gdk/Display.xml
+++ b/doc/en/Gdk/Display.xml
@@ -326,10 +326,8 @@
         <ReturnType>Gdk.Device</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>
-	      To be added
-        </summary>
-        <returns>a <see cref="T:Gdk.Device" /></returns>
+        <summary>Returns the core pointer device for the given display.</summary>
+        <returns>The core pointer <see cref="T:Gdk.Device" /> for the display.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -366,8 +364,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Gets the next <see cref="T:Gdk.Event" /> to be processed for display, fetching events from the windowing system if necessary.</summary>
-        <remarks>To be added</remarks>
+        <summary>This event is emitted when the connect to the windowing system is closed.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetPointer">
diff --git a/doc/en/Gdk/DisplayManager.xml b/doc/en/Gdk/DisplayManager.xml
index b6225431a..efd5bd353 100644
--- a/doc/en/Gdk/DisplayManager.xml
+++ b/doc/en/Gdk/DisplayManager.xml
@@ -10,7 +10,7 @@
   </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>
+    <summary>The purpose of this class is to offer notification when displays appear or disappear or the default display changes.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
@@ -34,9 +34,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DisplayManager" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the global DisplayManager instance.</summary>
+        <returns>The global <see cref="T:Gdk.DisplayManager" /> instance.</returns>
+        <remarks>This is the only valid way to access this class.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -59,10 +59,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.DisplayManager" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor.</summary>
+        <param name="raw">raw unmanaged pointer.</param>
+        <returns>A new <see cref="T:Gdk.DisplayManager" /></returns>
+        <remarks>This constructor is internal and should not be used.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DefaultDisplay">
@@ -74,10 +74,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">a <see cref="T:Gdk.Display" /></param>
-        <returns>a <see cref="T:Gdk.Display" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Access and modify the default display.</summary>
+        <param name="value">Sets the <see cref="T:Gdk.Display" /> as the default display.</param>
+        <returns>The default <see cref="T:Gdk.Display" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="DisplayOpened">
@@ -88,8 +88,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Event emitted when a display is opened.</summary>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -142,9 +142,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Display[]" /></returns>
-        <remarks>To be added</remarks>
+        <summary>List all currently open displays.</summary>
+        <returns>The currently open displays as an array of <see cref="T:Gdk.Display" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -153,9 +153,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.DisplayManager" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <returns>A useless <see cref="T:Gdk.DisplayManager" /></returns>
+        <remarks>This object is a singleton object, and should be accessed through <see cref="M:Gdk.DisplayManager.Get" /> instead of creating a new instance.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/DisplayOpenedArgs.xml b/doc/en/Gdk/DisplayOpenedArgs.xml
index 08e9eb5db..786a05b43 100644
--- a/doc/en/Gdk/DisplayOpenedArgs.xml
+++ b/doc/en/Gdk/DisplayOpenedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gdk.Display</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gdk.Display" /></returns>
-        <remarks>To be added</remarks>
+        <summary>The opened display.</summary>
+        <returns>The newly opened <see cref="T:Gdk.Display" />.</returns>
+        <remarks>None.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gdk/Fill.xml b/doc/en/Gdk/Fill.xml
index c24158a39..bbeca35b0 100644
--- a/doc/en/Gdk/Fill.xml
+++ b/doc/en/Gdk/Fill.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>Determines how primitives are drawn.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw with the foreground color.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw with a tiled pixmap.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw using the stipple bitmap. Pixels corresponding to bits in the stipple bitmap that are set will be drawn in he foreground color; pixels corresponding to bits that are not set will be left untouched.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw using the stipple bitmap. Pixels corresponding to bits in the stipple bitmap that are set will be drawn in the foreground color; pixels corresponding to bits that are not set will be drawn with the background color.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/FillRule.xml b/doc/en/Gdk/FillRule.xml
index 1b650355e..6a9fb621d 100644
--- a/doc/en/Gdk/FillRule.xml
+++ b/doc/en/Gdk/FillRule.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>The method for determining which pixels are included in a region, when creating a <see cref="T:Gdk.Region" /> from a polygon.</summary>
+    <remarks>The fill rule is only relevant for polygons which overlap themselves.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Areas which are overlapped an odd number of times are included in the region, while areas overlapped an even number of times are not.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Overlapping areas are always included.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/FilterReturn.xml b/doc/en/Gdk/FilterReturn.xml
index 83665f1fe..114a30a01 100644
--- a/doc/en/Gdk/FilterReturn.xml
+++ b/doc/en/Gdk/FilterReturn.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 result of applying a <see cref="T:Gdk.FilterFunc" /> to a native event.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Event not handled, continue processing.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Native event translated into a GDK event and tored in the event structure that was passed in.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Event handled, terminate processing.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Function.xml b/doc/en/Gdk/Function.xml
index 2648f4b25..de34bdf20 100644
--- a/doc/en/Gdk/Function.xml
+++ b/doc/en/Gdk/Function.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>Determines how bit values for the source pixels are combine with the bit values for destination pixels to produce the final result.</summary>
+    <remarks>The sixteen values here correspond to the 16 different possible 2x2 truth tables. Only a couple of these values are usually useful; for colored images, only Copy, Xor and Invert are generally useful. For bitmaps, And and Or are also useful.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Copy</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Invert</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Xor</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Clear</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>And</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>And Reverse</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>And Invert</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>No op</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -133,7 +133,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Or</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -145,7 +145,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Equiv</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -157,7 +157,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Or Reverse</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -169,7 +169,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Copy Invert</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -181,7 +181,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Or Invert</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -193,7 +193,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>N And</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -205,7 +205,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Nor</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -217,7 +217,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Set</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/GCValuesMask.xml b/doc/en/Gdk/GCValuesMask.xml
index dab1f4984..7243e5fbd 100644
--- a/doc/en/Gdk/GCValuesMask.xml
+++ b/doc/en/Gdk/GCValuesMask.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 set of flags used to indicate which fields <see cref="T:Gdk.GCValues" /> structure are set.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.Foreground" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.Background" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="P:Gdk.GCValues.font" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.Function" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.Fill" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="P:Gdk.GCValues.tile" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="P:Gdk.GCValues.Stipple" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="P:Gdk.GCValues.clip_mask" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -133,7 +133,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.SubwindowMode" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -145,7 +145,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.TsXOrigin" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -157,7 +157,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.TsYOrigin" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -169,7 +169,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.ClipXOrigin" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -181,7 +181,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.ClipYOrigin" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -193,7 +193,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.GraphicsExposures" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -205,7 +205,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.LineWidth" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -217,7 +217,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.LineStyle" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -229,7 +229,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.CapStyle" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -241,7 +241,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The <see cref="F:Gdk.GCValues.JoinStyle" /> is set.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/GrabStatus.xml b/doc/en/Gdk/GrabStatus.xml
index dbee0d857..0b1b89322 100644
--- a/doc/en/Gdk/GrabStatus.xml
+++ b/doc/en/Gdk/GrabStatus.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>Returned by <see cref="M:Gdk.Pointer.Grab" /> and <see cref="M:Gdk.Keyboard.Grab" /> to indicate success or the reason for the failure of the grab event.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The resource was successfully grabbed.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The resource is actively grabbed by another client.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The resource was grabbed more recently than the specified time.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The grab window or the confine_to window are not viewable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The resource is frozen by an active grab of another client.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/Gravity.xml b/doc/en/Gdk/Gravity.xml
index 470cd2b5a..b0db838cd 100644
--- a/doc/en/Gdk/Gravity.xml
+++ b/doc/en/Gdk/Gravity.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>Defines the reference point of a window and the meaning of coordinates passed to <see cref="M:Gtk.Window.Move" />.</summary>
+    <remarks>See <see cref="M:Gtk.Window.Move" /></remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the top left corner.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is in the middle of the top edge.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the top right corner.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the middle of the left edge.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the center of the window.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the middle of the right edge.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -109,7 +109,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the lower left corner.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -121,7 +121,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the middle of the lower edge.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -133,7 +133,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the lower right corner.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -145,7 +145,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The reference point is at the top left corner of the window itself, ignoring window manager decorations.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/ImageType.xml b/doc/en/Gdk/ImageType.xml
index 5ccc6b4c7..9d011537a 100644
--- a/doc/en/Gdk/ImageType.xml
+++ b/doc/en/Gdk/ImageType.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 <see cref="T:Gdk.Image" />.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The original X image type, which is quite slow since the image has to be transferred from the client to the server to display it.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>A faster image type, which uses shared memory to transfer the image data between the client and server. However this will only be available if the client and server are on the same machine and the shared memory extension is supported by the server.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Specifies that Shared should be tried first, and if that fails, then Normal will be used.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/InputMode.xml b/doc/en/Gdk/InputMode.xml
index bf95d10dd..114f1619e 100644
--- a/doc/en/Gdk/InputMode.xml
+++ b/doc/en/Gdk/InputMode.xml
@@ -11,7 +11,7 @@
   <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>An enumeration that describes the mode of an input device.</summary>
-    <remarks>To be added</remarks>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
diff --git a/doc/en/Gdk/InputSource.xml b/doc/en/Gdk/InputSource.xml
index 6f8a2fca2..1c73e5b81 100644
--- a/doc/en/Gdk/InputSource.xml
+++ b/doc/en/Gdk/InputSource.xml
@@ -11,8 +11,7 @@
   <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>Describes the type of input device</summary>
-    <remarks>
-    None
+    <remarks>None.
     </remarks>
   </Docs>
   <Base>
diff --git a/doc/en/Gdk/OverlapType.xml b/doc/en/Gdk/OverlapType.xml
index 87cc99234..55fec791f 100644
--- a/doc/en/Gdk/OverlapType.xml
+++ b/doc/en/Gdk/OverlapType.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 possible values returned by <see cref="M:Gdk.Region.RectIn" />.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>If the rectangle is inside the <see cref="T:Gdk.Region" />.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>If the rectangle is outside the <see cref="T:Gdk.Region" />.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>If the rectangle is partly inside the <see cref="T:Gdk.Region" />.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/PropMode.xml b/doc/en/Gdk/PropMode.xml
index 0aa0a2249..9ca3cc989 100644
--- a/doc/en/Gdk/PropMode.xml
+++ b/doc/en/Gdk/PropMode.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>Describes how existing data is combined with new 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 new data replaces the existing data.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The new data is prepended to the existing data.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The new data is appended to the existing data.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/RgbDither.xml b/doc/en/Gdk/RgbDither.xml
index 394e26f05..f71f527b8 100644
--- a/doc/en/Gdk/RgbDither.xml
+++ b/doc/en/Gdk/RgbDither.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>Selects whether or not <see cref="T:Gdk.Rgb" /> applies dithering to the image on display.</summary>
+    <remarks>Since <see cref="T:Gdk.Rgb" /> currently only handles images with 8 bits per component, dithering on 24 bit per pixel displays is a moot point.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Never use dithering.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Use dithering in 8 bits per pixel (and below) only.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Use dithering in 16 bits per pixel and below.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/SubwindowMode.xml b/doc/en/Gdk/SubwindowMode.xml
index 1d3badae7..3c76db833 100644
--- a/doc/en/Gdk/SubwindowMode.xml
+++ b/doc/en/Gdk/SubwindowMode.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>Determines how drawing onto a window will affect child windows of that window.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Only draw onto the window itself.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Draw onto the window and child windows.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gdk/WMFunction.xml b/doc/en/Gdk/WMFunction.xml
index 129f3131a..ec6ed8547 100644
--- a/doc/en/Gdk/WMFunction.xml
+++ b/doc/en/Gdk/WMFunction.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>These are hints originally defined by the Motif toolkit. The window manager can use them when determining the functions to offer for the window. The hint must be set before mapping the window.</summary>
+    <remarks>None.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -37,7 +37,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>All functions should be offered.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -49,7 +49,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window should be resizable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -61,7 +61,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window should be movable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -73,7 +73,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window should be minimizable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -85,7 +85,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window should be maximizable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -97,7 +97,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The window should be closable.</summary>
         <remarks>To be added</remarks>
       </Docs>
     </Member>