diff --git a/doc/en/Pango/Attr.xml b/doc/en/Pango/Attr.xml
index 26bcb1ee3..343b722db 100644
--- a/doc/en/Pango/Attr.xml
+++ b/doc/en/Pango/Attr.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>Static methods for attributes.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
diff --git a/doc/en/Pango/AttrClass.xml b/doc/en/Pango/AttrClass.xml
index c17b92123..54f22e6fd 100644
--- a/doc/en/Pango/AttrClass.xml
+++ b/doc/en/Pango/AttrClass.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>Stores the type and operations for a particular type of attribute.</summary>
+    <remarks>The functions in this structure should not be called directly. Instead, one should use the wrapper functions provided for <see cref="T:Pango.Attribute" />.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the type ID for this attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrColor.xml b/doc/en/Pango/AttrColor.xml
index acfa0613f..a3e0266a0 100644
--- a/doc/en/Pango/AttrColor.xml
+++ b/doc/en/Pango/AttrColor.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent attributes that are colors.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Color">
@@ -69,8 +69,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the PangoColor which is the value of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrFilterFunc.xml b/doc/en/Pango/AttrFilterFunc.xml
index a9ced093d..2342e1924 100644
--- a/doc/en/Pango/AttrFilterFunc.xml
+++ b/doc/en/Pango/AttrFilterFunc.xml
@@ -9,8 +9,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>used by <see cref="M:Pango.AttrList.Filter()" /> to filter out a subset of attributes for a list.</summary>
+    <remarks>Returns <see langword="true" /> if the attribute should be filtered out</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Pango/AttrFloat.xml b/doc/en/Pango/AttrFloat.xml
index c40cde199..1b7fb534f 100644
--- a/doc/en/Pango/AttrFloat.xml
+++ b/doc/en/Pango/AttrFloat.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>Used to represent attributes with a float or double value.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -69,8 +69,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the value of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrFontDesc.xml b/doc/en/Pango/AttrFontDesc.xml
index 0c69f67da..57717d5ed 100644
--- a/doc/en/Pango/AttrFontDesc.xml
+++ b/doc/en/Pango/AttrFontDesc.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to store an attribute that sets all aspects of the font description at once.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -41,10 +41,10 @@
         <Parameter Name="desc" Type="Pango.FontDescription" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="desc">To be added: an object of type 'Pango.FontDescription'</param>
-        <returns>To be added: an object of type 'Pango.AttrFontDesc'</returns>
-        <remarks>To be added</remarks>
+        <summary>Create a new <see cref="T:Pango.AttrFontDesc" /> from the provided <see cref="T:Pango.FontDescription" />.</summary>
+        <param name="desc">a <see cref="T:Pango.FontDescription" /></param>
+        <returns>a new <see cref="T:Pango.AttrFontDesc" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -72,10 +72,10 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Pango.FontDescription'</param>
-        <returns>To be added: an object of type 'Pango.FontDescription'</returns>
-        <remarks>To be added</remarks>
+        <summary>the font description which is the value of this attribute</summary>
+        <param name="value">a <see cref="T:Pango.FontDescription" /></param>
+        <returns>a <see cref="T:Pango.FontDescription" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Attr">
@@ -87,8 +87,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrInt.xml b/doc/en/Pango/AttrInt.xml
index bd522660c..8631a81fa 100644
--- a/doc/en/Pango/AttrInt.xml
+++ b/doc/en/Pango/AttrInt.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent attributes with a integer or enumeration value.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -41,7 +41,7 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>Internal constructor</summary>
+        <summary>Internal method</summary>
         <param name="raw">an object of type <see cref="T:System.IntPtr" /></param>
         <returns>an object of type <see cref="T:Pango.AttrInt" /></returns>
         <remarks>This is an internal method, and should not be used by user code.</remarks>
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -69,8 +69,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the value of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrIterator.xml b/doc/en/Pango/AttrIterator.xml
index bc6405f19..c24d6ad9a 100644
--- a/doc/en/Pango/AttrIterator.xml
+++ b/doc/en/Pango/AttrIterator.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent an iterator through a <see cref="T:Pango.List" />.</summary>
+    <remarks>A new iterator is created with <see cref="P:Pango.AttrList.Iterator" />. Once the iterator is created, it can be advanced through the style changes in the text using <see cref="M:Pango.AttrIterator.Next()" />. At each style change, the range of the current style segment and the attributes currently in effect can be queried.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -31,8 +31,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Destroy a <see cref="T:Pango.AttrIterator" /> and free all associated memory.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Next">
@@ -43,9 +43,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Advance the iterator until the next change of style.</summary>
+        <returns>
+          <see langword="false" /> if the iterator is at the end of the list, otherwise <see langword="true" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Copy">
@@ -56,9 +57,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.AttrIterator'</returns>
-        <remarks>To be added</remarks>
+        <summary>Make a copy of the iterator.</summary>
+        <returns>a <see cref="T:Pango.AttrIterator" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Get">
@@ -71,10 +72,10 @@
         <Parameter Name="type" Type="Pango.AttrType" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="type">To be added: an object of type 'Pango.AttrType'</param>
-        <returns>To be added: an object of type 'Pango.Attribute'</returns>
-        <remarks>To be added</remarks>
+        <summary>Find the current attribute of a particular type at the iterator location.</summary>
+        <param name="type"> the type of attribute to find.</param>
+        <returns> the current attribute of the given type, or <see langword="null" />  if no attribute of that type applies to the current location.</returns>
+        <remarks>When multiple attributes of the same type overlap, the attribute whose range starts closest to the current location is used.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -104,10 +105,10 @@
         <Parameter Name="end" Type="System.Int32&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="start">a <see cref="T:System.Int32&amp;" /></param>
-        <param name="end">a <see cref="T:System.Int32&amp;" /></param>
-        <remarks>To be added</remarks>
+        <summary>Get the range of the current segment.</summary>
+        <param name="start"> location to store the start of the range</param>
+        <param name="end"> location to store the end of the range</param>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Attrs">
@@ -118,9 +119,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Gets a list all attributes a the current position of the iterator.</summary>
         <returns>a <see cref="T:Pango.Attribute[]" /></returns>
-        <remarks>To be added</remarks>
+        <remarks> a list of all attributes for the current range.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetFont">
@@ -135,11 +136,11 @@
         <Parameter Name="extra_attrs" Type="Pango.Attribute[]&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="desc">a <see cref="T:Pango.FontDescription" /></param>
-        <param name="language">a <see cref="T:Pango.Language" /></param>
-        <param name="extra_attrs">a <see cref="T:Pango.Attribute[]" /></param>
-        <remarks>To be added</remarks>
+        <summary>Get the font and other attributes at the current iterator position.</summary>
+        <param name="desc"> a <see cref="T:Pango.FontDescription" /> to fill in with the current values. The family name in this structure will be set using <see cref="M:Pango.FontDescription.SetFamilyStatic()" /> using values from an attribute in the <see cref="T:Pango.AttrList" /> associated with the iterator, so if you plan to keep it around, you must call: <see cref="T:Pango.FontDescription.SetFamily (desc, pango_font_description_get_family (desc))" />.</param>
+        <param name="language"> if non-<see langword="null" />, location to store language tag for item, or <see langword="null" />  if non is found.</param>
+        <param name="extra_attrs"> if non-<see langword="null" />, location in which to store a list of non-font attributes at the the current position; only the highest priority value of each attribute will be added to this list.</param>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrLanguage.xml b/doc/en/Pango/AttrLanguage.xml
index cc535d6d8..058ed9a91 100644
--- a/doc/en/Pango/AttrLanguage.xml
+++ b/doc/en/Pango/AttrLanguage.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent attributes that are languages.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -41,10 +41,10 @@
         <Parameter Name="language" Type="Pango.Language" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="language">To be added: an object of type 'Pango.Language'</param>
-        <returns>To be added: an object of type 'Pango.AttrLanguage'</returns>
-        <remarks>To be added</remarks>
+        <summary>Create a new <see cref="T:Pango.AttrLanguage" /> from the provided <see cref="T:Pango.Language" /></summary>
+        <param name="language">a <see cref="T:Pango.Language" /></param>
+        <returns>a new <see cref="T:Pango.AttrLanguage" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -72,9 +72,9 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Pango.Language'</param>
-        <returns>To be added: an object of type 'Pango.Language'</returns>
+        <summary>the PangoLanguage which is the value of the attribute</summary>
+        <param name="value">a <see cref="T:Pango.Language" /></param>
+        <returns>a <see cref="T:Pango.Language" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -87,8 +87,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrList.xml b/doc/en/Pango/AttrList.xml
index b587f3988..c80364c8c 100644
--- a/doc/en/Pango/AttrList.xml
+++ b/doc/en/Pango/AttrList.xml
@@ -10,8 +10,10 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Represents a list of attributes that apply to a section of text.</summary>
+    <remarks>The attributes are, in general, allowed to overlap in an arbitrary fashion, however, if the attributes are manipulated only through <see cref="M:Pango.AttrList.Change()" />, the overlap between properties will meet stricter criteria.
+<para>Since the <see cref="T:Pango.AttrList" /> is stored as a linear list, it is not suitable for storing attributes for large amounts of text. In general, you should not use a single <see cref="T:Pango.AttrList" /> for more than one paragraph of text.
+</para></remarks>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -31,9 +33,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.AttrList'</returns>
-        <remarks>To be added</remarks>
+        <summary>Copy list and return an identical, new list.</summary>
+        <returns>a new <see cref="T:Pango.AttrList" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Change">
@@ -46,9 +48,13 @@
         <Parameter Name="attr" Type="Pango.Attribute" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="attr">To be added: an object of type 'Pango.Attribute'</param>
-        <remarks>To be added</remarks>
+        <summary>Insert the given attribute into the list.</summary>
+        <param name="attr">a <see cref="T:Pango.Attribute" /></param>
+        <remarks>It will replace any attributes of the same type on that segment and be merged with any adjoining attributes that are identical.  
+<block subset="none" type="note">
+            <para>This function is slower than <see cref="M:Pango.AttrList.Insert()" /> for creating a attribute list in order (potentially much slower for large lists). However, <see cref="M:Pango.AttrList.Insert()" /> is not suitable for continually changing a set of attributes since it never removes or combines existing attributes.
+  </para>
+          </block></remarks>
       </Docs>
     </Member>
     <Member MemberName="InsertBefore">
@@ -61,9 +67,9 @@
         <Parameter Name="attr" Type="Pango.Attribute" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="attr">To be added: an object of type 'Pango.Attribute'</param>
-        <remarks>To be added</remarks>
+        <summary>Insert the given attribute into the list.</summary>
+        <param name="attr"> the attribute to insert.</param>
+        <remarks>It will be inserted before all other attributes with a matching start_index.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Unref">
@@ -74,8 +80,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Decrease the reference count of the given attribute list by one.</summary>
+        <remarks>If the result is zero, free the attribute list and the attributes it contains.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Splice">
@@ -90,11 +96,12 @@
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="other">To be added: an object of type 'Pango.AttrList'</param>
-        <param name="pos">To be added: an object of type 'int'</param>
-        <param name="len">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <summary>This function splices attribute list <paramref name="other" /> into list.</summary>
+        <param name="other">another <see cref="T:Pango.AttrList" /></param>
+        <param name="pos"> the position at which to insert <paramref name="other" /></param>
+        <param name="len">the length of the spliced segment.</param>
+        <remarks>This operation is equivalent to stretching every attribute applies at position <paramref name="pos" /> in list by an amount <paramref name="len" />, and then calling <see cref="M:Pango.AttrList.Change()" /> with a copy of each attributes in other in sequence (offset in position by <paramref name="pos" />).
+This operation proves useful for, for instance, inserting a pre-edit string in the middle of an edit buffer.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Ref">
@@ -105,8 +112,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Increase the reference count of the given attribute list by one.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Insert">
@@ -119,9 +126,9 @@
         <Parameter Name="attr" Type="Pango.Attribute" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="attr">To be added: an object of type 'Pango.Attribute'</param>
-        <remarks>To be added</remarks>
+        <summary>Insert the given attribute to the list</summary>
+        <param name="attr"> the attribute to insert.</param>
+        <remarks>It will be inserted after all other attributes with a matching start_index.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -146,9 +153,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.AttrList'</returns>
-        <remarks>To be added</remarks>
+        <summary>Default constructor</summary>
+        <returns>a new <see cref="T:Pango.AttrList" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Iterator">
@@ -158,9 +165,9 @@
         <ReturnType>Pango.AttrIterator</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.AttrIterator'</returns>
-        <remarks>To be added</remarks>
+        <summary>Create a iterator initialized to the beginning of the list.</summary>
+        <returns>a new <see cref="T:Pango.AttrIterator" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Filter">
@@ -173,10 +180,10 @@
         <Parameter Name="func" Type="Pango.AttrFilterFunc" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Given a callback function, removes any elements of list for which <paramref name="func" /> returns <see langword="true" /> and inserts them into a new list.</summary>
         <param name="func">a <see cref="T:Pango.AttrFilterFunc" /></param>
         <returns>a <see cref="T:Pango.AttrList" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="GType">
diff --git a/doc/en/Pango/AttrShape.xml b/doc/en/Pango/AttrShape.xml
index 14daef28c..2264846d8 100644
--- a/doc/en/Pango/AttrShape.xml
+++ b/doc/en/Pango/AttrShape.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent attributes which impose shape restrictions.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -42,11 +42,11 @@
         <Parameter Name="logical_rect" Type="Pango.Rectangle" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="ink_rect">To be added: an object of type 'Pango.Rectangle'</param>
-        <param name="logical_rect">To be added: an object of type 'Pango.Rectangle'</param>
-        <returns>To be added: an object of type 'Pango.AttrShape'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new <see cref="T:Pango.AttrShape" /> from the provided <see cref="T:Pango.Rectangle" />s.</summary>
+        <param name="ink_rect">the ink rectangle to restrict to</param>
+        <param name="logical_rect">the logical rectangle to restrict to</param>
+        <returns>a new <see cref="T:Pango.AttrShape" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -74,8 +74,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="InkRect">
@@ -87,8 +87,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the ink rectangle to restrict to</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="LogicalRect">
@@ -100,8 +100,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the logical rectangle to restrict to</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/AttrString.xml b/doc/en/Pango/AttrString.xml
index ffce5e3a1..6b1dbb7e4 100644
--- a/doc/en/Pango/AttrString.xml
+++ b/doc/en/Pango/AttrString.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>Used to represent attributes with a string value.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
@@ -56,8 +56,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the common portion of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -69,8 +69,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the string which is the value of the attribute</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/Attribute.xml b/doc/en/Pango/Attribute.xml
index f554380fa..576de2063 100644
--- a/doc/en/Pango/Attribute.xml
+++ b/doc/en/Pango/Attribute.xml
@@ -57,10 +57,11 @@
         <Parameter Name="attr2" Type="Pango.Attribute" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="attr2">To be added: an object of type 'Pango.Attribute'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Compare two attributes for equality.</summary>
+        <param name="attr2">a <see cref="T:Pango.Attribute" /> to be tested for equality.</param>
+        <returns>
+          <see langword="true" /> if the two attributes have the same value.</returns>
+        <remarks>This compares only the actual value of the two attributes and not the ranges that the attributes apply to.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Destroy">
@@ -71,8 +72,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Destroy a <see cref="T:Pango.Attribute" /> and free all associated memory.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Copy">
@@ -83,9 +84,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.Attribute'</returns>
-        <remarks>To be added</remarks>
+        <summary>Make a copy of an attribute.</summary>
+        <returns>a new <see cref="T:Pango.Attribute" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="klass">
diff --git a/doc/en/Pango/Color.xml b/doc/en/Pango/Color.xml
index 5dda8745a..abee556d4 100644
--- a/doc/en/Pango/Color.xml
+++ b/doc/en/Pango/Color.xml
@@ -72,8 +72,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Frees a color allocated by <see cref="M:Pango.Color.Copy()" />.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Copy">
diff --git a/doc/en/Pango/EngineLang.xml b/doc/en/Pango/EngineLang.xml
index 7e0e4a055..a286341db 100644
--- a/doc/en/Pango/EngineLang.xml
+++ b/doc/en/Pango/EngineLang.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>Rendering-system independent script engines</summary>
+    <remarks>The <see cref="T:Pango.EngineLang" /> is implemented by engines that customize the rendering-system independent part of the Pango pipeline for a particular script or language. For instance, a custom <see cref="T:Pango.EngineLang" /> could be provided for Thai to implement the dictionary-based word boundary lookups needed for that language.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
diff --git a/doc/en/Pango/EngineShape.xml b/doc/en/Pango/EngineShape.xml
index d187af57d..1b466b0c4 100644
--- a/doc/en/Pango/EngineShape.xml
+++ b/doc/en/Pango/EngineShape.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> Rendering-system dependent script engines</summary>
+    <remarks>The <see cref="T:Pango.EngineShape" /> class is implemented by engines that customize the rendering-system dependent part of the Pango pipeline for a particular script or language. A <see cref="T:Pango.EngineShape" /> implementation is then specific to both a particular rendering system or group of rendering systems and to a particular script. For instance, there is one <see cref="T:Pango.EngineShape" /> implementation to handling shaping Arabic for Fontconfig-based backends.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
diff --git a/doc/en/Pango/FT2FontMap.xml b/doc/en/Pango/FT2FontMap.xml
index 0b788d1fa..a4d9895cf 100644
--- a/doc/en/Pango/FT2FontMap.xml
+++ b/doc/en/Pango/FT2FontMap.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 <see cref="T:Pango.FT2FontMap" /> is the <see cref="T:Pango.FontMap" /> implementation for FreeType fonts.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
@@ -34,9 +34,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns a <see cref="T:Pango.FT2FontMap" />.</summary>
         <returns>a <see cref="T:Pango.FontMap" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>Use of the global PangoFT2 fontmap is deprecated.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SubstituteChanged">
@@ -47,8 +47,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Call this any time the results of the default substitution function set with <see cref="M:Pango.FT2FontMap.SetDefaultSubstitute()" /> changes.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="SetResolution">
@@ -62,10 +62,10 @@
         <Parameter Name="dpi_y" Type="System.Double" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="dpi_x">a <see cref="T:System.Double" /></param>
-        <param name="dpi_y">a <see cref="T:System.Double" /></param>
-        <remarks>To be added</remarks>
+        <summary>Sets the horizontal and vertical resolutions for the fontmap.</summary>
+        <param name="dpi_x"> dots per inch in the X direction</param>
+        <param name="dpi_y"> dots per inch in the Y direction</param>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="CreateContext">
@@ -76,9 +76,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:Pango.Context" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Create a <see cref="T:Pango.Context" /> for the given fontmap.</summary>
+        <returns>a new <see cref="T:Pango.Context" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -89,8 +89,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Disposes the resources associated with the object.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -101,10 +101,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Internal constructor</summary>
         <param name="raw">a <see cref="T:System.IntPtr" /></param>
         <returns>a <see cref="T:Pango.FT2FontMap" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>This is an internal constructor, and should not be used by user code.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -113,9 +113,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Default constructor</summary>
         <returns>a <see cref="T:Pango.FT2FontMap" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="GType">
diff --git a/doc/en/Pango/FT2SubstituteFunc.xml b/doc/en/Pango/FT2SubstituteFunc.xml
index ee356b58f..993c7e44b 100644
--- a/doc/en/Pango/FT2SubstituteFunc.xml
+++ b/doc/en/Pango/FT2SubstituteFunc.xml
@@ -9,8 +9,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>For doing final config tweaking on prepared FcPatterns.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
diff --git a/doc/en/Pango/Global.xml b/doc/en/Pango/Global.xml
index 22a7e9bb9..128c223a2 100644
--- a/doc/en/Pango/Global.xml
+++ b/doc/en/Pango/Global.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>Global API elements for <see cref="N:Pango" /></summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
diff --git a/doc/en/Pango/GlyphItem.xml b/doc/en/Pango/GlyphItem.xml
index 462c0e86c..2f1c3812a 100644
--- a/doc/en/Pango/GlyphItem.xml
+++ b/doc/en/Pango/GlyphItem.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 pair of a <see cref="T:Pango.Item" /> and the glyphs resulting from shaping the text corresponding to an item.</summary>
+    <remarks>As an example of the usage of <see cref="T:Pango.GlyphItem" />, the results of shaping text with <see cref="T:Pango.Layout" /> is a list of <see cref="T:Pango.LayoutLine" />, each of which contains a list of <see cref="T:Pango.GlyphItem" />.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -58,11 +58,15 @@
         <Parameter Name="split_index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="text">a <see cref="T:System.String" /></param>
-        <param name="split_index">a <see cref="T:System.Int32" /></param>
-        <returns>a <see cref="T:Pango.GlyphItem" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Splits an Item</summary>
+        <param name="text"> text to which positions in orig apply.</param>
+        <param name="split_index"> byte index of position to split item, relative to the start of the item</param>
+        <returns>a <see cref="T:Pango.GlyphItem" /> representing the text before <paramref name="split_index" /></returns>
+        <remarks>
+          <para>
+Modifies orig to cover only the text after <paramref name="split_index" />, and returns a new item that covers the text before <paramref name="split_index" /> that used to be in orig. You can think of <paramref name="split_index" /> as the length of the returned item. <paramref name="split_index" /> may not be 0, and it may not be greater than or equal to the length of orig (that is, there must be at least one byte assigned to each item, you cannot create a zero-length item).
+</para>
+This function is similar in function to <see cref="M:Pango.Item.Split()" /> (and uses it internally)</remarks>
       </Docs>
     </Member>
     <Member MemberName="glyphs">
@@ -72,9 +76,9 @@
         <ReturnType>Pango.GlyphString</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
+        <summary>the glyphs obtained by shaping the text corresponding to item.</summary>
         <returns>a <see cref="T:Pango.GlyphString" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="item">
@@ -84,9 +88,9 @@
         <ReturnType>Pango.Item</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
+        <summary>a <see cref="T:Pango.Item" /> that provides information about a segment of text.</summary>
         <returns>a <see cref="T:Pango.Item" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ApplyAttrs">
@@ -100,11 +104,18 @@
         <Parameter Name="list" Type="Pango.AttrList" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Splits a shaped item (<see cref="T:Pango.GlyphItem" />) into multiple items based on an attribute list.</summary>
         <param name="text">a <see cref="T:System.String" /></param>
         <param name="list">a <see cref="T:Pango.AttrList" /></param>
         <returns>a <see cref="T:Pango.GlyphItem[]" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>
+          <para>
+The idea is that if you have attributes that do not affect shaping, such as color or underline, to avoid affecting shaping, you filter them out (<see cref="M:Pango.AttrList.Filter()" />), apply the shaping process and then re-apply them to the result using this function.
+</para>
+          <para>
+All attributes that start or end inside a cluster are applied to that cluster; for instance, if half of a cluster is underlined and the other-half strikethough, then the cluster will end up with both underline and strikethrough attributes. In these cases, it may happen that item-&gt;extra_attrs for some of the result items can have multiple attributes of the same type. 
+</para>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/Item.xml b/doc/en/Pango/Item.xml
index c797caa30..8ab93a1db 100644
--- a/doc/en/Pango/Item.xml
+++ b/doc/en/Pango/Item.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>Stores information about a segment of text.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -39,9 +39,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.Item'</returns>
-        <remarks>To be added</remarks>
+        <summary>Creates a new Item</summary>
+        <returns>a new <see cref="T:Pango.Item" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -68,8 +68,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Free a <see cref="T:Pango.Item" /> and all associated memory.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Copy">
@@ -80,9 +80,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Pango.Item'</returns>
-        <remarks>To be added</remarks>
+        <summary>Copy an existing <see cref="T:Pango.Item" /> structure.</summary>
+        <returns>a new <see cref="T:Pango.Item" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Split">
@@ -96,11 +96,11 @@
         <Parameter Name="split_offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="split_index">To be added: an object of type 'int'</param>
-        <param name="split_offset">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'Pango.Item'</returns>
-        <remarks>To be added</remarks>
+        <summary>Modifies orig to cover only the text after <paramref name="split_index" />, and returns a new item that covers the text before <paramref name="split_index" /> that used to be in orig.</summary>
+        <param name="split_index"> byte index of position to split item, relative to the start of the item</param>
+        <param name="split_offset"> number of chars between start of orig and <paramref name="split_index" /></param>
+        <returns> new item representing text before <paramref name="split_index" /></returns>
+        <remarks>You can think of <paramref name="split_index" /> as the length of the returned item. <paramref name="split_index" /> may not be 0, and it may not be greater than or equal to the length of orig (that is, there must be at least one byte assigned to each item, you cannot create a zero-length item). <paramref name="split_offset" /> is the length of the first item in chars, and must be provided because the text used to generate the item is not available, so <see cref="M:Pango.Item.Split()" /> cannot count the char length of the split items itself.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Offset">
@@ -112,8 +112,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the offset of the segment from the beginning of the string in bytes.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -125,8 +125,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the length of the segment in bytes.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="NumChars">
@@ -138,8 +138,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the length of the segment in characters.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Analysis">
@@ -151,8 +151,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>the properties of the segment.</summary>
+        <remarks />
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Pango/Language.xml b/doc/en/Pango/Language.xml
index 211acb231..9e3e56973 100644
--- a/doc/en/Pango/Language.xml
+++ b/doc/en/Pango/Language.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Used to represent a language.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -33,10 +33,10 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="language">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Pango.Language'</returns>
-        <remarks>To be added</remarks>
+        <summary>Take a RFC-3066 format language tag as a string and convert it to a <see cref="T:Pango.Language" /></summary>
+        <param name="language"> a string representing a language tag</param>
+        <returns>a <see cref="T:Pango.Language" /></returns>
+        <remarks>This function first canonicalizes the string by converting it to lowercase, mapping '_' to '-', and stripping all characters other than letters and '-'.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Matches">
@@ -49,10 +49,11 @@
         <Parameter Name="range_list" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="range_list">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Checks if a language tag matches one of the elements in a list of language ranges.</summary>
+        <param name="range_list"> a list of language ranges, separated by ';' characters. each element must either be '*', or a RFC 3066 language range canonicalized as by <see cref="M:Pango.LanguageFromString()" />.</param>
+        <returns>
+          <see langword="true" /> if a match was found.</returns>
+        <remarks>A language tag is considered to match a range in the list if the range is '*', the range is exactly the tag, or the range is a prefix of the tag, and the character after the tag is '-'.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -78,9 +79,9 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'string'</returns>
-        <remarks>To be added</remarks>
+        <summary>A sample </summary>
+        <returns>a <see cref="T:System.String" /></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="GType">
diff --git a/doc/en/Pango/LogAttr.xml b/doc/en/Pango/LogAttr.xml
index d90b15ade..5c59fa91d 100644
--- a/doc/en/Pango/LogAttr.xml
+++ b/doc/en/Pango/LogAttr.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>Stores information about the attributes of a single character.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
diff --git a/doc/en/Pango/Win32FontCache.xml b/doc/en/Pango/Win32FontCache.xml
index d45d2d760..d2c6eb465 100644
--- a/doc/en/Pango/Win32FontCache.xml
+++ b/doc/en/Pango/Win32FontCache.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>Caches HFONTs by their LOGFONT descriptions.</summary>
+    <remarks />
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -31,8 +31,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Frees a <see cref="T:Pango.Win32FontCache" /> and all associated memory.</summary>
+        <remarks>All fonts loaded through this font cache will be freed along with the cache.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -57,9 +57,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Default constructor</summary>
         <returns>an object of type <see cref="T:Pango.Win32FontCache" /></returns>
-        <remarks>To be added</remarks>
+        <remarks />
       </Docs>
     </Member>
   </Members>