From ad11cfb1283f67ddd23107676eea4052815661a8 Mon Sep 17 00:00:00 2001
From: John Luke <jluke@mono-cvs.ximian.com>
Date: Thu, 12 Jun 2003 04:17:57 +0000
Subject: [PATCH] * en/Gtk/Image.xml: add parameter and returns references,
 Methods * en/Gtk/Window.xml: add parameter and returns references *
 en/Gtk/TreeView.xml: add RulesHint * en/Gtk/Stock.xml: add returns references
 * en/Gtk/Plug.xml: add first draft

svn path=/trunk/gtk-sharp/; revision=15335
---
 doc/ChangeLog           |  11 +-
 doc/en/Gtk/Image.xml    | 109 +++++++++++---------
 doc/en/Gtk/Plug.xml     |  49 +++++----
 doc/en/Gtk/Stock.xml    | 144 +++++++++++++-------------
 doc/en/Gtk/TreeView.xml |  32 +++---
 doc/en/Gtk/Window.xml   | 218 ++++++++++++++++++++--------------------
 6 files changed, 297 insertions(+), 266 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a3bd474f8..48d6a7740 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,11 +1,14 @@
+2003-06-12  John Luke  <jluke@cfl.rr.com>
+	* en/Gtk/Image.xml: add parameter and returns references, Methods
+	* en/Gtk/Window.xml: add parameter and returns references
+	* en/Gtk/TreeView.xml: add RulesHint
+	* en/Gtk/Stock.xml: add returns references
+	* en/Gtk/Plug.xml: add first draft
+
 2003-06-06  John Luke  <jluke@cfl.rr.com>
 	* en/GConf/*.xml: add
 	* en/GConf.PropertyEditors/*.xml: add
 
-2003-06-04  John Luke  <jluke@cfl.rr.com>
-	* en/Gtk/Image.xml: add parameter and returns references
-	* en/Gtk/Window.xml: add parameter and returns references
-
 2003-06-03  John Luke  <jluke@cfl.rr.com>
 	* README: update instructions to compile and install docs
 
diff --git a/doc/en/Gtk/Image.xml b/doc/en/Gtk/Image.xml
index 8d639334b..66beb2aef 100644
--- a/doc/en/Gtk/Image.xml
+++ b/doc/en/Gtk/Image.xml
@@ -9,12 +9,13 @@
   </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>This <see cref="T:Gtk.Widget" /> is used to display an
-  image. It can be used as a container for a <see cref="Gdk.Pixbuf" />
-  or a <see cref="Gdk.PixbufAnimation" /> to get custom interfaces.
-  <see cref="Gtk.Image" /> cannot launch events, it's neccessary to
-  include it inside a <see cref="Gtk.EventBox" /> for that purpose.</summary>
-    <remarks />
+    <summary><see cref="T:Gtk.Widget" /> used to display an image. </summary>
+    <remarks>
+		<see cref="T:Gtk.Image"/> can be used as a container for a <see cref="Gdk.Pixbuf" />
+  		or a <see cref="Gdk.PixbufAnimation" /> to get custom interfaces.
+  		<see cref="Gtk.Image" /> cannot launch events, it is neccessary to
+  		include it inside a <see cref="Gtk.EventBox" /> for that purpose.
+		</remarks>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.Misc</BaseTypeName>
@@ -46,10 +47,16 @@
         <Parameter Name="size" Type="Gtk.IconSize" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="icon_set">To be added: an object of type 'Gtk.IconSet'</param>
-        <param name="size">To be added: an object of type 'Gtk.IconSize'</param>
-        <remarks>To be added</remarks>
+        <summary>Creates a <see cref="T:Gtk.Image"/> displaying an <see cref="T:Gtk.IconSet"/>.</summary>
+        <param name="icon_set">an object of type <see cref="T:Gtk.IconSet"/></param>
+        <param name="size">an object of type <see cref="T:Gtk.IconSize"/></param>
+        <remarks>
+					Creates a <see cref="T:Gtk.Image"/> displaying an <see cref="T:Gtk.IconSet"/>.
+					Sample stock sizes are <see cref="F:Gtk.IconSize.Menu"/>, <see cref="F:Gtk.IconSize.SmallToolbar"/>.
+					Instead of using this function, usually it's better to create a <see cref="T:Gtk.IconFactory"/>, put your <see cref="T:Gtk.IconSet"/> in the <see cref="T:Gtk.IconFactory"/>,
+					add the <see cref="T:Gtk.IconFactory"/> to the list of default factories with <see cref="M:Gtk.IconFactory.AddDefault()"/>, and then use <see cref="M:Gtk.Image.SetFromStock(System.String,Gtk.IconSize)"/>.
+					This will allow themes to override the icon you ship with your application.
+				</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetFromImage">
@@ -63,10 +70,13 @@
         <Parameter Name="mask" Type="Gdk.Bitmap" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gdk_image">To be added: an object of type 'Gdk.Image'</param>
-        <param name="mask">To be added: an object of type 'Gdk.Bitmap'</param>
-        <remarks>To be added</remarks>
+        <summary>Creates a <see cref="T:Gtk.Image"/> widget displaying an image with a mask.</summary>
+        <param name="gdk_image">an object of type <see cref="T:Gdk.Image"/></param>
+        <param name="mask">an object of type <see cref="T:Gdk.Bitmap"/></param>
+        <remarks>
+					Creates a <see cref="T:Gtk.Image"/> widget displaying an image with a mask.
+					A <see cref="T:Gdk.Image"/> is a client-side image buffer in the pixel format of the current display.
+				</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetFromStock">
@@ -80,10 +90,16 @@
         <Parameter Name="size" Type="Gtk.IconSize" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="stock_id">To be added: an object of type 'string'</param>
-        <param name="size">To be added: an object of type 'Gtk.IconSize'</param>
-        <remarks>To be added</remarks>
+        <summary>Creates a <see cref="T:Gtk.Image"/> displaying a stock icon.</summary>
+        <param name="stock_id">an object of type <see cref="T:System.String"/></param>
+        <param name="size">an object of type <see cref="T:Gtk.IconSize"/></param>
+        <remarks>
+					Creates a <see cref="T:Gtk.Image"/> displaying a stock icon.
+					Sample stock icon names are <see cref="P:Gtk.Stock.Open"/>, <see cref="P:Gtk.Stock.Ok"/>.
+					Sample stock sizes are <see cref="F:Gtk.IconSize.Menu"/>, <see cref="F:Gtk.IconSize.SmallToolbar"/>.
+					If the stock icon name isn't known, a "broken image" icon will be displayed instead.
+					You can register your own stock icon names, see <see cref="M:Gtk.IconFactory.AddDefault()"/> and <see cref="M:Gtk.IconFactory.Add()"/>.
+				</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetFromPixmap">
@@ -97,10 +113,13 @@
         <Parameter Name="mask" Type="Gdk.Bitmap" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="pixmap">To be added: an object of type 'Gdk.Pixmap'</param>
-        <param name="mask">To be added: an object of type 'Gdk.Bitmap'</param>
-        <remarks>To be added</remarks>
+        <summary>Creates a <see cref="T:Gtk.Image"/> widget displaying an image with a mask.</summary>
+        <param name="pixmap">an object of type <see cref="T:Gdk.Pixmap"/></param>
+        <param name="mask">an object of type <see cref="T:Gdk.Bitmap"/></param>
+        <remarks>
+					Creates a <see cref="T:Gtk.Image"/> widget displaying an image with a mask.
+					A <see cref="T:Gdk.Image"/> is a client-side image buffer in the pixel format of the current display.
+				</remarks>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -279,8 +298,8 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The GLib Type for Gtk.Image</summary>
-        <returns>The GLib Type for the Gtk.Image class.</returns>
+        <summary>The <see cref="T:GLib.Type"/> for <see cref="T:Gtk.Image"/></summary>
+        <returns>The <see cref="T:GLib.Type"/> for the <see cref="T:Gtk.Image"/> class.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -294,10 +313,10 @@
         <Parameter Name="value" Type="Gdk.Pixbuf" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Pixbuf'</param>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a <see cref="T:Gtk.Image"/> displaying <see cref="T:Gdk.Pixbuf"/>.</summary>
+        <param name="value">an object of type <see cref="T:Gdk.Pixbuf"/></param>
+        <returns>an object of type <see cref="T:Gdk.Pixbuf"/></returns>
+        <remarks>Creates a <see cref="T:Gtk.Image"/> displaying <see cref="T:Gdk.Pixbuf"/>.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Animation">
@@ -308,7 +327,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gdk.PixbufAnimation'</returns>
+        <returns>an object of type <see cref="T:Gdk.PixbufAnimation"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -323,8 +342,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.PixbufAnimation'</param>
-        <returns>To be added: an object of type 'Gdk.PixbufAnimation'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.PixbufAnimation"/></param>
+        <returns>an object of type <see cref="T:Gdk.PixbufAnimation"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -339,8 +358,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -355,8 +374,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -389,8 +408,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <param name="value">an object of type <see cref="T:System.Int32"/></param>
+        <returns>an object of type <see cref="T:System.Int32"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -405,8 +424,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -418,7 +437,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.ImageType'</returns>
+        <returns>an object of type <see cref="T:Gtk.ImageType"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -469,8 +488,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Pixmap'</param>
-        <returns>To be added: an object of type 'Gdk.Pixmap'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.Pixmap"/></param>
+        <returns>an object of type <see cref="T:Gdk.Pixmap"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -510,8 +529,8 @@
         <remarks />
 
               <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Image'</param>
-        <returns>To be added: an object of type 'Gdk.Image'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.Image"/></param>
+        <returns>an object of type <see cref="T:Gdk.Image"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -532,4 +551,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Plug.xml b/doc/en/Gtk/Plug.xml
index 0811e5bee..fe443dfd2 100644
--- a/doc/en/Gtk/Plug.xml
+++ b/doc/en/Gtk/Plug.xml
@@ -1,5 +1,5 @@
 <Type Name="Plug" FullName="Gtk.Plug">
-  <TypeSignature Language="C#" Value="public class Plug : Gtk.Window, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="auto" />
+  <TypeSignature Language="C#" Value="public class Plug : Gtk.Window, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="John Luke" />
   <AssemblyInfo>
     <AssemblyName>gtk-sharp</AssemblyName>
     <AssemblyVersion>0.0.0.0</AssemblyVersion>
@@ -7,8 +7,12 @@
   </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>Toplevel for embedding into other processes.</summary>
+    <remarks>
+			Together with <see cref="T:Gtk.Socket"/>, <see cref="T:Gtk.Plug "/> provides the ability to embed widgets from one process into another process in a fashion that is transparent to the user.
+			One process creates a <see cref="T:Gtk.Socket"/> widget and, passes the ID of that widgets window to the other process, which then creates a <see cref="T:Gtk.Plug "/> with that window ID.
+			Any widgets contained in the <see cref="T:Gtk.Plug"/> then will appear inside the first applications window.
+		</remarks>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.Window</BaseTypeName>
@@ -39,9 +43,10 @@
         <Parameter Name="socket_id" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="socket_id">To be added: an object of type 'uint'</param>
-        <remarks>To be added</remarks>
+        <summary>Finish the initialization of <see cref="T:Gtk.Plug"/> for a given <see cref="T:Gtk.Socket"/> identified by socket_id.</summary>
+        <param name="socket_id">an object of type <see cref="T:System.UInt32"/></param>
+        <remarks>Finish the initialization of <see cref="T:Gtk.Plug"/> for a given <see cref="T:Gtk.Socket"/> identified by socket_id which is currently displayed on display.
+				This method will generally only be used by classes deriving from <see cref="T:Gtk.Plug"/>.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -80,10 +85,13 @@
         <Parameter Name="socket_id" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="socket_id">To be added: an object of type 'uint'</param>
-        <returns>To be added: an object of type 'Gtk.Plug'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new <see cref="T:Gtk.Plug"/> widget inside the <see cref="T:Gtk.Socket"/> identified by socket_id.</summary>
+        <param name="socket_id">an object of type <see cref="System.UInt32"/></param>
+        <returns>an object of type <see cref="T:Gtk.Plug"/></returns>
+        <remarks>
+					Creates a new <see cref="T:Gtk.Plug"/> widget inside the <see cref="T:Gtk.Socket"/> identified by socket_id.
+					If socket_id is 0, the <see cref="T:Gtk.Plug"/> is left "unplugged" and can later be plugged into a <see cref="T:Gtk.Socket"/> by <see cref="M:Gtk.Socket.AddId(System.UInt32)"/>.
+				</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -92,9 +100,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.Plug'</returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor</summary>
+        <returns>an object of type <see cref="T:Gtk.Plug"/></returns>
+        <remarks>This is a constructor used by derivative types of <see cref="T:Gtk.Plug" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -104,8 +112,8 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The GLib Type for Gtk.Plug</summary>
-        <returns>The GLib Type for the Gtk.Plug class.</returns>
+        <summary>The <see cref="T:GLib.Type"/> for <see cref="T:Gtk.Plug"/> class.</summary>
+        <returns>The <see cref="T:GLib.Type"/> for the <see cref="T:Gtk.Plug"/> class.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -116,9 +124,10 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'uint'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets the window ID of a <see cref="T:Gtk.Plug"/> widget.</summary>
+        <returns>an object of type <see cref="T:System.UInt32"/></returns>
+        <remarks>Gets the window ID of a <see cref="T:Gtk.Plug"/> widget, which can then be used to embed this window inside another window,
+				for instance with <see cref="M:Gtk.Socket.AddId(System.UInt32)"/>.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Embedded">
@@ -141,11 +150,11 @@
       <Docs>
         <summary>Internal constructor</summary>
         <param name="gtype">GLib type for the type</param>
-        <returns>Creates a new instance of Plug, using the GLib-provided type</returns>
+        <returns>Creates a new instance of <see cref="T:Gtk.Plug"/>, using the GLib-provided type</returns>
         <remarks>
           <para>This is a constructor used by derivative types of <see cref="T:Gtk.Plug" /> that would have their own GLib type assigned to it.  This is not typically used by C# code.</para>
         </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Stock.xml b/doc/en/Gtk/Stock.xml
index 730326f05..fcd32f963 100644
--- a/doc/en/Gtk/Stock.xml
+++ b/doc/en/Gtk/Stock.xml
@@ -23,7 +23,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.Stock'</returns>
+        <returns>an object of type <see cref="T:Gtk.Stock"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -35,7 +35,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -47,7 +47,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -59,7 +59,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -71,7 +71,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -83,7 +83,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -95,7 +95,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -107,7 +107,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -119,7 +119,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -131,7 +131,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -143,7 +143,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -155,7 +155,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -167,7 +167,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -179,7 +179,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -191,7 +191,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -203,7 +203,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -215,7 +215,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -227,7 +227,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>Tan object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -239,7 +239,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -251,7 +251,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -263,7 +263,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -275,7 +275,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -287,7 +287,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -299,7 +299,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -311,7 +311,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -323,7 +323,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -335,7 +335,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -347,7 +347,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -359,7 +359,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -371,7 +371,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -383,7 +383,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -395,7 +395,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -407,7 +407,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -419,7 +419,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -431,7 +431,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -443,7 +443,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -455,7 +455,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -467,7 +467,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -479,7 +479,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -491,7 +491,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -503,7 +503,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -515,7 +515,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -527,7 +527,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -539,7 +539,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -551,7 +551,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -563,7 +563,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -575,7 +575,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -587,7 +587,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -599,7 +599,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -611,7 +611,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -623,7 +623,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -635,7 +635,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -647,7 +647,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -659,7 +659,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -671,7 +671,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -683,7 +683,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -695,7 +695,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -707,7 +707,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -719,7 +719,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -731,7 +731,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -743,7 +743,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -755,7 +755,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -767,7 +767,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -779,7 +779,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -791,7 +791,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -803,7 +803,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -815,7 +815,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -827,7 +827,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -839,7 +839,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -851,7 +851,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -863,9 +863,9 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TreeView.xml b/doc/en/Gtk/TreeView.xml
index 8c19be1f7..871a491cd 100644
--- a/doc/en/Gtk/TreeView.xml
+++ b/doc/en/Gtk/TreeView.xml
@@ -826,10 +826,10 @@ namespace Samples {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">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>Whether to display alternating, shaded rows in the <see cref="Gtk.TreeView"/>.</summary>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
+        <remarks>Setting <see cref="P:Gtk.TreeView.RulesHint"/> to <see langword="true"/> enables alternating, shaded rows in the <see cref="T:Gtk.TreeView"/>.</remarks>
       </Docs>
     </Member>
     <Member MemberName="EnableSearch">
@@ -843,8 +843,8 @@ namespace Samples {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -859,8 +859,8 @@ namespace Samples {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -891,8 +891,8 @@ namespace Samples {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -923,8 +923,8 @@ namespace Samples {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1154,7 +1154,7 @@ namespace Samples {
         <param name="y">To be added: an object of type 'int'</param>
         <param name="path">To be added: an object of type 'Gtk.TreePath&amp;'</param>
         <param name="column">To be added: an object of type 'Gtk.TreeViewColumn'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1174,7 +1174,7 @@ namespace Samples {
         <param name="x">To be added: an object of type 'int'</param>
         <param name="y">To be added: an object of type 'int'</param>
         <param name="path">To be added: an object of type 'Gtk.TreePath&amp;'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1200,7 +1200,7 @@ namespace Samples {
         <param name="column">To be added: an object of type 'Gtk.TreeViewColumn'</param>
         <param name="cell_x">To be added: an object of type 'int&amp;'</param>
         <param name="cell_y">To be added: an object of type 'int&amp;'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1226,4 +1226,4 @@ namespace Samples {
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Window.xml b/doc/en/Gtk/Window.xml
index d058141c4..a2cb0d2ca 100644
--- a/doc/en/Gtk/Window.xml
+++ b/doc/en/Gtk/Window.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>Toplevel widget that can contain other widgets</summary>
+    <remarks>Toplevel widget that can contain other widgets</remarks>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.Bin</BaseTypeName>
@@ -38,7 +38,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'GLib.List'</returns>
+        <returns>an object of type <see cref="T:GLib.List"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -56,10 +56,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="button">To be added: an object of type 'int'</param>
-        <param name="root_x">To be added: an object of type 'int'</param>
-        <param name="root_y">To be added: an object of type 'int'</param>
-        <param name="timestamp">To be added: an object of type 'uint'</param>
+        <param name="button">an object of type <see cref="T:System.Int32"/></param>
+        <param name="root_x">an object of type <see cref="T:System.Int32"/></param>
+        <param name="root_y">an object of type <see cref="T:System.Int32"/></param>
+        <param name="timestamp">an object of type <see cref="T:System.UInt32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -77,10 +77,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="left">To be added: an object of type 'int&amp;'</param>
-        <param name="top">To be added: an object of type 'int&amp;'</param>
-        <param name="right">To be added: an object of type 'int&amp;'</param>
-        <param name="bottom">To be added: an object of type 'int&amp;'</param>
+        <param name="left">an object of type <see cref="T:System.Int32"/></param>
+        <param name="top">an object of type <see cref="T:System.Int32"/></param>
+        <param name="right">an object of type <see cref="T:System.Int32"/></param>
+        <param name="bottom">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -132,8 +132,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="width">To be added: an object of type 'int&amp;'</param>
-        <param name="height">To be added: an object of type 'int&amp;'</param>
+        <param name="width">an object of type <see cref="T:System.Int32"/></param>
+        <param name="height">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -149,8 +149,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="width">To be added: an object of type 'int&amp;'</param>
-        <param name="height">To be added: an object of type 'int&amp;'</param>
+        <param name="width">an object of type <see cref="T:System.Int32"/></param>
+        <param name="height">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -166,8 +166,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
+        <param name="width">an object of type <see cref="T:System.Int32"/></param>
+        <param name="height">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -180,7 +180,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -195,8 +195,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="geometry">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="geometry">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -211,7 +211,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="accel_group">To be added: an object of type 'Gtk.AccelGroup'</param>
+        <param name="accel_group">an object of type <see cref="T:Gtk.AccelGroup"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -241,10 +241,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="left">To be added: an object of type 'int'</param>
-        <param name="top">To be added: an object of type 'int'</param>
-        <param name="right">To be added: an object of type 'int'</param>
-        <param name="bottom">To be added: an object of type 'int'</param>
+        <param name="left">an object of type <see cref="T:System.Int32"/></param>
+        <param name="top">an object of type <see cref="T:System.Int32"/></param>
+        <param name="right">an object of type <see cref="T:System.Int32"/></param>
+        <param name="bottom">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -260,8 +260,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="keyval">To be added: an object of type 'uint'</param>
-        <param name="target">To be added: an object of type 'Gtk.Widget'</param>
+        <param name="keyval">an object of type <see cref="T:System.UInt32"/></param>
+        <param name="target">an object of type <see cref="T:System.Widget"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -280,11 +280,11 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="edge">To be added: an object of type 'Gdk.WindowEdge'</param>
-        <param name="button">To be added: an object of type 'int'</param>
-        <param name="root_x">To be added: an object of type 'int'</param>
-        <param name="root_y">To be added: an object of type 'int'</param>
-        <param name="timestamp">To be added: an object of type 'uint'</param>
+        <param name="edge">an object of type <see cref="T:Gdk.WindowEdge"/></param>
+        <param name="button">an object of type <see cref="T:System.Int32"/></param>
+        <param name="root_x">an object of type <see cref="T:System.Int32"/></param>
+        <param name="root_y">an object of type <see cref="T:System.Int32"/></param>
+        <param name="timestamp">an object of type <see cref="T:System.UInt32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -300,8 +300,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="root_x">To be added: an object of type 'int&amp;'</param>
-        <param name="root_y">To be added: an object of type 'int&amp;'</param>
+        <param name="root_x">an object of type <see cref="T:System.Int32"/></param>
+        <param name="root_y">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -329,9 +329,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="keyval">To be added: an object of type 'uint'</param>
-        <param name="modifier">To be added: an object of type 'Gdk.ModifierType'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="keyval">an object of type <see cref="T:System.UInt32"/></param>
+        <param name="modifier">an object of type <see cref="T:Gdk.ModifierType"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -344,7 +344,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -372,8 +372,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="keyval">To be added: an object of type 'uint'</param>
-        <param name="target">To be added: an object of type 'Gtk.Widget'</param>
+        <param name="keyval">an object of type <see cref="T:System.UInt32"/></param>
+        <param name="target">an object of type <see cref="T:Gtk.Widget"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -388,7 +388,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="xid">To be added: an object of type 'uint'</param>
+        <param name="xid">an object of type <see cref="T:System.UInt32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -404,8 +404,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="wmclass_name">To be added: an object of type 'string'</param>
-        <param name="wmclass_class">To be added: an object of type 'string'</param>
+        <param name="wmclass_name">an object of type <see cref="T:System.String"/></param>
+        <param name="wmclass_class">an object of type <see cref="T:System.String"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -420,7 +420,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="xid">To be added: an object of type 'uint'</param>
+        <param name="xid">an object of type <see cref="T:System.UInt32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -436,8 +436,8 @@
       </Parameters>
       <Docs>
         <summary>Sets the default size of an object, with the specified width and height arguments.</summary>
-        <param name="width">To be added: an object of type 'int'</param>
-        <param name="height">To be added: an object of type 'int'</param>
+        <param name="width">an object of type <see cref="T:System.Int32"/></param>
+        <param name="height">an object of type <see cref="T:System.Int32"/></param>
         <remarks>
           <para>
             It is used for setting the default size an object will have. The first argument, 
@@ -487,8 +487,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="x">To be added: an object of type 'int'</param>
-        <param name="y">To be added: an object of type 'int'</param>
+        <param name="x">an object of type <see cref="T:System.Int32"/></param>
+        <param name="y">an object of type <see cref="T:System.Int32"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -522,7 +522,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="accel_group">To be added: an object of type 'Gtk.AccelGroup'</param>
+        <param name="accel_group">an object of type <see cref="T:Gtk.AccelGroup"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -539,9 +539,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="geometry_widget">To be added: an object of type 'Gtk.Widget'</param>
-        <param name="geometry">To be added: an object of type 'Gdk.Geometry'</param>
-        <param name="geom_mask">To be added: an object of type 'Gdk.WindowHints'</param>
+        <param name="geometry_widget">an object of type <see cref="T:Gtk.Widget"/></param>
+        <param name="geometry">an object of type <see cref="T:Gdk.Geometry"/></param>
+        <param name="geom_mask">an object of type <see cref="T:Gdk.WindowHints"/></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -582,8 +582,8 @@
       </Parameters>
       <Docs>
         <summary>Creates a new Window object, based on the Gtk.WindowType type argument.</summary>
-        <param name="type">To be added: an object of type 'Gtk.WindowType'</param>
-        <returns>To be added: an object of type 'Gtk.Window'</returns>
+        <param name="type">an object of type <see cref="T:Gtk.WindowType"/></param>
+        <returns>an object of type <see cref="T:Gtk.Window"/></returns>
         <remarks>
           <para>
             Creates a new Window object, wich can be of type TopLevel ( most of the cases )
@@ -599,9 +599,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.Window'</returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor</summary>
+        <returns>an object of type <see cref="T:Gtk.Window"/></returns>
+        <remarks>This is an internal constructor, and should not be used by user code.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -613,8 +613,8 @@
       </Parameters>
       <Docs>
         <summary>Creates a new TopLevel Window object, with the specified string argument as the title.</summary>
-        <param name="title">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gtk.Window'</returns>
+        <param name="title">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:Gtk.Window"/></returns>
         <remarks>
           <para>
             Creates a new TopLevel Window object, using the string title argument to specify the Window title.
@@ -635,8 +635,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'GLib.List'</param>
-        <returns>To be added: an object of type 'GLib.List'</returns>
+        <param name="value">an object of type <see cref="T:GLib.List"/></param>
+        <returns>an object of type <see cref="T:GLib.List"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -647,8 +647,8 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The GLib Type for Gtk.Window</summary>
-        <returns>The GLib Type for the Gtk.Window class.</returns>
+        <summary>The <see cref="T:GLib.Type"/> for <see cref="T:Gtk.Window"/></summary>
+        <returns>The <see cref="T:GLib.Type"/> for the <see cref="T:Gtk.Window"/> class.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -663,8 +663,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.Widget'</param>
-        <returns>To be added: an object of type 'Gtk.Widget'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.Widget"/></param>
+        <returns>an object of type <see cref="T:Gtk.Windget"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -679,8 +679,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -695,8 +695,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Gravity'</param>
-        <returns>To be added: an object of type 'Gdk.Gravity'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.Gravity"/></param>
+        <returns>an object of type <see cref="T:Gdk.Gravity"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -711,8 +711,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.ModifierType'</param>
-        <returns>To be added: an object of type 'Gdk.ModifierType'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.ModifierType"/></param>
+        <returns>an object of type <see cref="T:Gdk.ModifierType"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -727,8 +727,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.WindowTypeHint'</param>
-        <returns>To be added: an object of type 'Gdk.WindowTypeHint'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.WindowTypeHint"/></param>
+        <returns>an object of type <see cref="T:Gdk.WindowTypeHint"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -743,8 +743,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.Window'</param>
-        <returns>To be added: an object of type 'Gtk.Window'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.Window"/></param>
+        <returns>an object of type <see cref="T:Gtk.Window"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -759,8 +759,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.Widget'</param>
-        <returns>To be added: an object of type 'Gtk.Widget'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.Widget"/></param>
+        <returns>an object of type <see cref="T:Gtk.Widget"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -775,8 +775,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'GLib.List'</param>
-        <returns>To be added: an object of type 'GLib.List'</returns>
+        <param name="value">an object of type <see cref="T:GLib.List"/></param>
+        <returns>an object of type <see cref="T:GLib.List"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -791,8 +791,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -807,8 +807,8 @@
       </Parameters>
       <Docs>
         <summary>Sets if a Window will be decorated or not ( borderless ).</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>
           <para>With this property you control if a window will be decorated or not.</para>
           <para>
@@ -830,8 +830,8 @@
       </Parameters>
       <Docs>
         <summary>Sets if a Window will be resizable by the user or not.</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>
           <para>
             By default, windows are resizable, so you can change the size of them. But if you set this property
@@ -851,8 +851,8 @@
       </Parameters>
       <Docs>
         <summary>Property used for setting/getting the window position.</summary>
-        <param name="value">To be added: an object of type 'Gtk.WindowPosition'</param>
-        <returns>To be added: an object of type 'Gtk.WindowPosition'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.WindowPosition"/></param>
+        <returns>an object of type <see cref="T:Gtk.WindowPosition"/></returns>
         <remarks>
           <para>
             This property will alow you to define where a Window must be displayed on the screen.
@@ -872,8 +872,8 @@
       </Parameters>
       <Docs>
         <summary>Property used for defining the default height of a window.</summary>
-        <param name="value">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <param name="value">an object of type <see cref="T:System.Int32"/></param>
+        <returns>an object of type <see cref="T:System.Int32"/></returns>
         <remarks>
           <para>
             This property will allow you to define the default height for your Window.
@@ -894,8 +894,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Int32"/></param>
+        <returns>an object of type <see cref="T:System.Int32"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -910,8 +910,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -926,8 +926,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -942,8 +942,8 @@
       </Parameters>
       <Docs>
         <summary>Property used for setting the Window Title.</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String"/></param>
+        <returns>an object of type <see cref="T:System.String"/></returns>
         <remarks>
           <para>
             This property will allow you to set the Window Title. The Title of a window
@@ -963,7 +963,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.WindowType'</returns>
+        <returns>an object of type <see cref="T:Gtk.WindowType"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -978,8 +978,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <param name="value">an object of type <see cref="T:System.Int32"/></param>
+        <returns>an object of type <see cref="T:System.Int32"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -994,8 +994,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Pixbuf'</param>
-        <returns>To be added: an object of type 'Gdk.Pixbuf'</returns>
+        <param name="value">an object of type <see cref="T:Gdk.Pixbuf"/></param>
+        <returns>an object of type <see cref="T:Gdk.Pixbuf"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1010,8 +1010,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean"/></param>
+        <returns>an object of type <see cref="T:System.Boolean"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1083,7 +1083,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Drawing.Size'</returns>
+        <returns>an object of type <see cref="T:System.Drawing.Size"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1095,7 +1095,7 @@
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'Drawing.Size'</returns>
+        <returns>an object of type <see cref="T:System.Drawing.Size"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1110,8 +1110,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Drawing.Size'</param>
-        <returns>To be added: an object of type 'Drawing.Size'</returns>
+        <param name="value">an object of type <see cref="T:System.Drawing.Size"/></param>
+        <returns>an object of type <see cref="T:System.Drawing.Size"/></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1132,4 +1132,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>