diff --git a/doc/en/Glade/ApplyCustomPropFunc.xml b/doc/en/Glade/ApplyCustomPropFunc.xml
index 8f4a37de1..08b3d71eb 100644
--- a/doc/en/Glade/ApplyCustomPropFunc.xml
+++ b/doc/en/Glade/ApplyCustomPropFunc.xml
@@ -7,7 +7,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>Event handler.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
diff --git a/doc/en/Glade/BuildChildrenFunc.xml b/doc/en/Glade/BuildChildrenFunc.xml
index 6e439089d..8079929b3 100644
--- a/doc/en/Glade/BuildChildrenFunc.xml
+++ b/doc/en/Glade/BuildChildrenFunc.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>event handler.</summary>
+    <remarks>this delegate is used for custom methods to built the internal children of a widget.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Glade/FindInternalChildFunc.xml b/doc/en/Glade/FindInternalChildFunc.xml
index 5c6cdbce1..5d9699ef8 100644
--- a/doc/en/Glade/FindInternalChildFunc.xml
+++ b/doc/en/Glade/FindInternalChildFunc.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>Event handler.</summary>
+    <remarks>this delegate is used for custom methods to find the internal children of a widget.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Glade/Global.xml b/doc/en/Glade/Global.xml
index 7286810a7..454f5b159 100644
--- a/doc/en/Glade/Global.xml
+++ b/doc/en/Glade/Global.xml
@@ -64,7 +64,7 @@
         <summary>To be added</summary>
         <param name="version">a <see cref="T:System.Int32" /></param>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SetCustomHandler">
@@ -77,9 +77,9 @@
         <Parameter Name="handler" Type="Glade.XMLCustomWidgetHandler" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="handler">a <see cref="T:Glade.XMLCustomWidgetHandler" /></param>
-        <remarks>To be added</remarks>
+        <summary>this method allows you to override the default behaviour when a Custom widget is found in an interface.</summary>
+        <param name="handler">the <see cref="T:Glade.XMLCustomWidgetHandler" /> to use when a custom widget is found.</param>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -105,10 +105,10 @@
         <Parameter Name="apply_prop" Type="Glade.ApplyCustomPropFunc" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="type">a <see cref="T:GLib.GType" /></param>
-        <param name="prop_name">a <see cref="T:System.String" /></param>
-        <param name="apply_prop">a <see cref="T:Glade.ApplyCustomPropFunc" /></param>
+        <summary>This method provides a way to register handlers  for custom properties.</summary>
+        <param name="type">the  <see cref="T:GLib.GType" /> of the widget.</param>
+        <param name="prop_name">the name of the custom property</param>
+        <param name="apply_prop">the <see cref="T:Glade.ApplyCustomPropFunc" /> to call when the property is found.</param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -161,12 +161,12 @@
         <Parameter Name="find_internal_child" Type="Glade.FindInternalChildFunc" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="type">a <see cref="T:GLib.GType" /></param>
-        <param name="_new">a <see cref="T:Glade.NewFunc" /></param>
-        <param name="build_children">a <see cref="T:Glade.BuildChildrenFunc" /></param>
-        <param name="find_internal_child">a <see cref="T:Glade.FindInternalChildFunc" /></param>
-        <remarks>To be added</remarks>
+        <summary>this method registers new costruction methods for a widget type.</summary>
+        <param name="type">the <see cref="T:GLib.GType" /> of a widget.</param>
+        <param name="_new">the <see cref="T:Glade.NewFunc" /> used to construct the widget.</param>
+        <param name="build_children">the <see cref="T:Glade.BuildChildrenFunc" /> used to construct the children or null.</param>
+        <param name="find_internal_child">the <see cref="T:Glade.FindInternalChildFunc" /> to find the internal children or null.</param>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Glade/NewFunc.xml b/doc/en/Glade/NewFunc.xml
index 01c6a9697..f96111b60 100644
--- a/doc/en/Glade/NewFunc.xml
+++ b/doc/en/Glade/NewFunc.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>Event handler.</summary>
+    <remarks>this delegate is called used for custom methods to create widgets.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Glade/RawXMLConnectFunc.xml b/doc/en/Glade/RawXMLConnectFunc.xml
index da3ba1f83..07596952f 100644
--- a/doc/en/Glade/RawXMLConnectFunc.xml
+++ b/doc/en/Glade/RawXMLConnectFunc.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>Event handler.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
diff --git a/doc/en/Glade/XML.xml b/doc/en/Glade/XML.xml
index fbf94bd63..1d303ff98 100644
--- a/doc/en/Glade/XML.xml
+++ b/doc/en/Glade/XML.xml
@@ -734,8 +734,8 @@ public class GladeApp
         <ReturnType>Gtk.Widget</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Gtk.Widget" /></returns>
+        <summary>returns a widget created from the glade xml file. </summary>
+        <returns>a <see cref="T:Gtk.Widget" /> or null when the the widget with taht name is't found.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Glade/XMLConnectFunc.xml b/doc/en/Glade/XMLConnectFunc.xml
index ec6fad617..5049550ee 100644
--- a/doc/en/Glade/XMLConnectFunc.xml
+++ b/doc/en/Glade/XMLConnectFunc.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>Event handler.</summary>
+    <remarks>this delegate is used for custom methods to connect the signals to methods.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Glade/XMLCustomWidgetHandler.xml b/doc/en/Glade/XMLCustomWidgetHandler.xml
index abe701de8..cc1fe7146 100644
--- a/doc/en/Glade/XMLCustomWidgetHandler.xml
+++ b/doc/en/Glade/XMLCustomWidgetHandler.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>Event handler.</summary>
+    <remarks>this delegate is used for custom methods to call when a custom widget is found.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Gtk/Notebook.xml b/doc/en/Gtk/Notebook.xml
index ce125bd31..f8155c367 100644
--- a/doc/en/Gtk/Notebook.xml
+++ b/doc/en/Gtk/Notebook.xml
@@ -256,7 +256,15 @@ class NotebookSample
         used as the label for the page, or <see langword="null" /> to
         use the default label, 'page N'.</param>
         <remarks>
-	  Appends a page to notebook.  The tab widget is the <paramref name="tab_label" /> and the content is <paramref name="child" /></remarks>
+          <para>
+
+	 Appends a page to notebook.  The tab widget is the <paramref name="tab_label" /> and the content is <paramref name="child" />.
+
+</para>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="AppendPageMenu">
@@ -289,6 +297,9 @@ class NotebookSample
         <remarks>
           <para>Appends a page to notebook, specifying the
         widget to use as the label in the popup menu.</para>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
         </remarks>
       </Docs>
     </Member>
@@ -318,8 +329,11 @@ class NotebookSample
 	</param>
         <remarks>
           <para>
-	    Insert a page into the notebook at the given position
+	    Insert a page into the notebook at the given position.
 	  </para>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
         </remarks>
       </Docs>
     </Member>
@@ -430,7 +444,11 @@ the label of a menu doesn't have to be a <see cref="T:Gtk.Label" />. it can be a
         <summary>prepends a page.</summary>
         <param name="child">a <see cref="T:Gtk.Widget" /> t use as content of the page.</param>
         <param name="tab_label">the <see cref="T:Gtk.Widget" /> to use as the tab label. use null to use the default label.</param>
-        <remarks />
+        <remarks>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="NextPage">
@@ -470,7 +488,11 @@ the label of a menu doesn't have to be a <see cref="T:Gtk.Label" />. it can be a
         <param name="child">the <see cref="T:Gtk.Widget" /> to use as contents of the page.</param>
         <param name="tab_label">the <see cref="T:Gtk.Widget" /> to use as tab label. use null to use the default label.</param>
         <param name="menu_label">the  <see cref="T:Gtk.Widget" /> to use as menu label. use null to get the same label as the tab label, this only works if the tab label is a <see cref="T:Gtk.Label" /></param>
-        <remarks>To be added</remarks>
+        <remarks>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetMenuLabel">
@@ -814,7 +836,11 @@ the label of a menu doesn't have to be a <see cref="T:Gtk.Label" />. it can be a
         <param name="tab_label">the<see cref="T:Gtk.Widget" /> to use as a label. use null for the default label.</param>
         <param name="menu_label">the  <see cref="T:Gtk.Widget" /> to use as menu label. use null to get the same label as the tab label, this only works if the tab label is a <see cref="T:Gtk.Label" /></param>
         <param name="position">the zero-based position to insert the page. use -1 make it the last page.</param>
-        <remarks />
+        <remarks>
+          <para>
+Don't forget to call the Show method on the widget or else the new page will not be shown.
+</para>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="SetTabLabel">