2004-08-17 Mike Kestner <mkestner@ximian.com>

* pango/Pango.metadata : metadata for the pango audit.
	* pango/*.custom : customizations to fix audited API.
	* doc/en/* : docs for some api changes and additions.
	* glib/Marshaller.cs : some gunichar marshal-fu.
	* glib/glue/unichar.c : a new glue method.

svn path=/trunk/gtk-sharp/; revision=32462

ChangeLog

@@ -1,3 +1,11 @@
+2004-08-17  Mike Kestner  <mkestner@ximian.com>
+
+	* pango/Pango.metadata : metadata for the pango audit.
+	* pango/*.custom : customizations to fix audited API.
+	* doc/en/* : docs for some api changes and additions.
+	* glib/Marshaller.cs : some gunichar marshal-fu.
+	* glib/glue/unichar.c : a new glue method.
+
 2004-08-13  John Luke  <john.luke@gmail.com>
 
 	* gtk/Gtk.metadata: mark Gtk.StockManager.Lookup param as ref

doc/en/Atk/EditableText.xml

@@ -14,12 +14,10 @@
     <remarks>
       <para>
         <see cref="T:Atk.EditableText" /> should be implemented by UI components which
-        contain text which the user can edit, via the <see
+        contain text which the user can edit, via the <see cref="T:Atk.Object" /> corresponding to that component (see <see cref="T:Atk.Object" />).
-        cref="T:Atk.Object" /> corresponding to that component (see <see cref="T:Atk.Object" />).
       </para>
       <para>
-        <see cref="T:Atk.EditableText" /> is a subclass of <see
+        <see cref="T:Atk.EditableText" /> is a subclass of <see cref="T:Atk.Text" />, and as such, an
-        cref="T:Atk.Text" />, and as such, an
         object which implements AtkEditableText is by definition an
         <see cref="T:Atk.Text" /> implementor as well.
       </para>
@@ -49,8 +47,7 @@
         <param name="end_pos">end position</param>
         <remarks>
           <para>
-            This only deletes text up to, but not including <paramref
+            This only deletes text up to, but not including <paramref name="end_pos" />. </para>
-            name="end_pos" />. </para>
         </remarks>
       </Docs>
     </Member>
@@ -85,8 +82,7 @@
         <param name="end_pos">end position</param>
         <remarks>
           <para>
-            This method only cuts the text up to <paremref
+            This method only cuts the text up to <paremref name="end_pos" />, it does not include the text at that position.
-            name="end_pos" />, it does not include the text at that position.
           </para>
         </remarks>
       </Docs>
@@ -107,8 +103,7 @@
         <param name="end_pos">end position</param>
         <remarks>
           <para>
-            This method only copies the text up to <paremref
+            This method only copies the text up to <paremref name="end_pos" />, it does not include the text at that position.
-            name="end_pos" />, it does not include the text at that position.
           </para>
         </remarks>
       </Docs>
@@ -131,8 +126,7 @@
         <param name="end_offset">end of range in which to set attributes</param>
         <returns>
           <see langword="true" /> if attributes successfully set for
-          the specified range, otherwise <see langword="false"/>
+          the specified range, otherwise <see langword="false" /></returns>
-        </returns>
         <remarks>
           <para>
             Sets the attributes for a specified range. See the
@@ -173,8 +167,7 @@
         <summary>Insert text at a given position.</summary>
         <param name="str1ng">the text to insert</param>
         <returns>the position after the text has been inserted</returns>.
-        <remarks />
+        <remarks /></Docs>
-      </Docs>
     </Member>
   </Members>
 </Type>

doc/en/Atk/Image.xml

@@ -18,8 +18,7 @@
     </summary>
     <remarks>
       <para>
-        <see cref="T:Atk.Image" /> should be implemented by <see
+        <see cref="T:Atk.Image" /> should be implemented by <see cref="T:Atk.Object" /> subtypes on behalf
-        cref="T:Atk.Object" /> subtypes on behalf
         of components which display image/pixmap information onscreen,
         and which provide information (other than just widget borders,
         etc.) via that image content. For instance, icons, buttons
@@ -56,7 +55,8 @@
       <Docs>
         <summary>Sets the textual description for this image.</summary>
         <param name="description">a description to set for image</param>
-        <returns><see langword="true" />, or <see langword="false" /> if operation could not be completed.</returns>
+        <returns>
+          <see langword="true" />, or <see langword="false" /> if operation could not be completed.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -85,16 +85,15 @@
       </Parameters>
       <Docs>
         <summary>Gets the position of the image in the form of a point specifying the images top-left corner.</summary>
-          <param name="x">x coordinate position</param>
+        <param name="x">x coordinate position</param>
-          <param name="y">y coordinate position</param>
+        <param name="y">y coordinate position</param>
-          <param name="coord_type">
+        <param name="coord_type">
             specifies whether the coordinates are relative to the
             screen or to the components top level window
           </param>
         <remarks>
           <para>
-            The values of <paramref name="x" /> and <paramref name="y"
+            The values of <paramref name="x" /> and <paramref name="y" />are returned as -1 if the values cannot be obtained.
-            />are returned as -1 if the values cannot be obtained.
           </para>
         </remarks>
       </Docs>

doc/en/GLib/Marshaller.xml

@@ -133,5 +133,37 @@
         <remarks>To be added</remarks>
       </Docs>
     </Member>
+    <Member MemberName="GUnicharToChar">
+      <MemberSignature Language="C#" Value="public static char GUnicharToChar (uint ucs4_char);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>System.Char</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="ucs4_char" Type="System.UInt32" />
+      </Parameters>
+      <Docs>
+        <summary>Marshals a UCS4 character represented as an uint to a UTF16 char.</summary>
+        <param name="ucs4_char">a <see cref="T:System.UInt32" /></param>
+        <returns>a <see cref="T:System.Char" /></returns>
+        <remarks></remarks>
+      </Docs>
+    </Member>
+    <Member MemberName="CharToGUnichar">
+      <MemberSignature Language="C#" Value="public static uint CharToGUnichar (char c);" />
+      <MemberType>Method</MemberType>
+      <ReturnValue>
+        <ReturnType>System.UInt32</ReturnType>
+      </ReturnValue>
+      <Parameters>
+        <Parameter Name="c" Type="System.Char" />
+      </Parameters>
+      <Docs>
+        <summary>Marshals a UTF16 char to a UCS4 character represented as an uint.</summary>
+        <param name="c">a <see cref="T:System.Char" /></param>
+        <returns>a <see cref="T:System.UInt32" /></returns>
+        <remarks></remarks>
+      </Docs>
+    </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Accel.xml

@@ -294,4 +294,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelChangedArgs.xml

@@ -69,4 +69,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelFlags.xml

@@ -91,4 +91,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelGroup.xml

@@ -210,7 +210,7 @@
       <Docs>
         <summary>Default public constructor.</summary>
         <returns>A new <see cref="T:Gtk.AccelGroup" />.</returns>
-        <remarks/>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="AccelChanged">
@@ -309,4 +309,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelGroupEntry.xml

@@ -74,4 +74,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelKey.xml

@@ -83,7 +83,7 @@
       </Parameters>
       <Docs>
         <summary>The main keyboard key to use for this AccelKey.</summary>
-        <remarks>Useful values are <see cref="T:System.Int32" /> enumerated in <see cref='T:Gdk.Key' />.</remarks>
+        <remarks>Useful values are <see cref="T:System.Int32" /> enumerated in <see cref="T:Gdk.Key" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -97,12 +97,12 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="key">a <see cref="T:System.Int32" /> enumerated in <see cref='T:Gdk.Key' /></param>
+        <param name="key">a <see cref="T:System.Int32" /> enumerated in <see cref="T:Gdk.Key" /></param>
-        <param name="mods">a <see cref="T:System.Int32" /> enumerated in <see cref='T:Gdk.ModifierType' />, the modifiers (shift, ctrl, etc) that apply for this AccelKey</param>
+        <param name="mods">a <see cref="T:System.Int32" /> enumerated in <see cref="T:Gdk.ModifierType" />, the modifiers (shift, ctrl, etc) that apply for this AccelKey</param>
-        <param name="flags">a <see cref="T:System.Int32" /> enumerated in <see cref='T:Gdk.AccelFlags' /> for whether this AccelKey should be displayed in the menu</param>
+        <param name="flags">a <see cref="T:System.Int32" /> enumerated in <see cref="T:Gdk.AccelFlags" /> for whether this AccelKey should be displayed in the menu</param>
         <returns>a <see cref="T:Gtk.AccelKey" /></returns>
         <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/AccelLabel.xml

@@ -183,4 +183,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Bin.xml

@@ -225,4 +225,4 @@ class Y {
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Box.xml

@@ -283,4 +283,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ButtonPressEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ButtonReleaseEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/CellEditable.xml

@@ -98,4 +98,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/CellRenderer.xml

@@ -421,7 +421,7 @@
         <Parameter Name="flags" Type="Gtk.CellRendererState" />
       </Parameters>
       <Docs>
-        <summary>Invokes the virtual render function of the <see cref="M:CellRenderer" />. The three passed-in rectangles are areas of window. Most renderers will draw within <paramref name="cell_area"/>; the xalign, yalign, xpad, and ypad fields of the <see cref="M:CellRenderer" /> should be honored with respect to <paramref name="cell_area"/>. <paramref name="background_area"/> includes the blank space around the cell, and also the area containing the tree expander; so the <paramref name="background_area"/> rectangles for all cells tile to cover the entire window. <paramref name="expose_area" /> is a clip rectangle.</summary>
+        <summary>Invokes the virtual render function of the <see cref="M:CellRenderer" />. The three passed-in rectangles are areas of window. Most renderers will draw within <paramref name="cell_area" />; the xalign, yalign, xpad, and ypad fields of the <see cref="M:CellRenderer" /> should be honored with respect to <paramref name="cell_area" />. <paramref name="background_area" /> includes the blank space around the cell, and also the area containing the tree expander; so the <paramref name="background_area" /> rectangles for all cells tile to cover the entire window. <paramref name="expose_area" /> is a clip rectangle.</summary>
         <param name="window">a <see cref="T:Gdk.Drawable" /> to render to</param>
         <param name="widget">a <see cref="T:Gtk.Widget" />, the widget that owns <paramref name="window" /></param>
         <param name="background_area">a <see cref="T:Gdk.Rectangle" />,  entire cell area (including tree expanders and maybe padding on the sides)</param>
@@ -458,4 +458,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ColorSelection.xml

@@ -177,8 +177,8 @@
       </Parameters>
       <Docs>
         <summary>The color that was selected before the current one.</summary>
-        <param name="value">An object of type <see cref='M:Gdk.Color' /></param>
+        <param name="value">An object of type <see cref="M:Gdk.Color" /></param>
-        <returns>a <see cref='M:Gdk.Color' /></returns>
+        <returns>a <see cref="M:Gdk.Color" /></returns>
         <remarks />
       </Docs>
     </Member>
@@ -269,4 +269,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/CurrentParagraphAlignmentChangedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/CurrentParagraphIndentationChangedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Curve.xml

@@ -315,4 +315,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragBeginArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragDataDeleteArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragDataGetArgs.xml

@@ -77,8 +77,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragDataReceivedArgs.xml

@@ -65,7 +65,7 @@
       <Docs>
         <summary>The data from the drag-and-drop selection that was dropped as part of the event.</summary>
         <returns>a <see cref="T:Gtk.SelectionData" />object.</returns>
-	<remarks />
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Y">
@@ -101,8 +101,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragDropArgs.xml

@@ -77,8 +77,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragEndArgs.xml

@@ -41,8 +41,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragLeaveArgs.xml

@@ -53,8 +53,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/DragMotionArgs.xml

@@ -77,8 +77,8 @@
       <Docs>
         <summary>The context of this drag.</summary>
         <returns>a <see cref="T:Gdk.DragContext" /></returns>
-        <remarks /> 
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Editable.xml

@@ -68,7 +68,6 @@
         <Parameter Name="end_pos" Type="System.Int32" />
       </Parameters>
       <Docs>
-
         <summary>Deletes a sequence of characters. The characters that are deleted are those characters at positions from <paramref name="start_pos" /> up to, but not including <paramref name="end_pos" />. If <paramref name="end_pos" /> is negative, then the the characters deleted will be those characters from  <paramref name="start_pos" /> to the end of the text.</summary>
         <param name="start_pos">An integer; the start position</param>
         <param name="end_pos">An integer; the end position</param>
@@ -225,4 +224,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/FileSelection.xml

@@ -477,4 +477,4 @@ class FileSelectionSample
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/FocusOutEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/HTML.xml

@@ -260,7 +260,8 @@ namespace HtmlTest
       <Parameters />
       <Docs>
         <summary>Selects a paragraph.</summary>
-        <remarks></remarks>
+        <remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ZoomReset">
@@ -2084,4 +2085,4 @@ class X {
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/HTMLCommandType.xml

@@ -2006,4 +2006,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/HTMLFontStyle.xml

@@ -75,7 +75,7 @@
         <ReturnType>Gtk.HTMLFontStyle</ReturnType>
       </ReturnValue>
       <Parameters />
-      <Docs> 
+      <Docs>
         <summary>A medium-small text size.</summary>
         <remarks>
         </remarks>
@@ -251,4 +251,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/HTMLParagraphAlignment.xml

@@ -82,4 +82,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/HTMLSaveReceiverFn.xml

@@ -30,4 +30,4 @@
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/HelpShownArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/IMContext.xml

@@ -416,4 +416,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/IconSet.xml

@@ -236,4 +236,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/IconSize.xml

@@ -132,4 +132,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/IconSource.xml

@@ -382,4 +382,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/IframeCreatedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ImageIconSetData.xml

@@ -56,11 +56,11 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>The underlying <see cref='T:Gtk.IconSet' /> in this data.</summary>
+        <summary>The underlying <see cref="T:Gtk.IconSet" /> in this data.</summary>
-        <param name="value">a  <see cref='T:Gtk.IconSet' /></param>
+        <param name="value">a  <see cref="T:Gtk.IconSet" /></param>
-        <returns>an object of type  <see cref='T:Gtk.IconSet' /></returns>
+        <returns>an object of type  <see cref="T:Gtk.IconSet" /></returns>
         <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/InsertAtCursorArgs.xml

@@ -59,4 +59,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/InsertionColorChangedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/InsertionFontStyleChangedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/KeyPressEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/KeyReleaseEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Layout.xml

@@ -288,4 +288,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/MnemonicActivatedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Rc.xml

@@ -29,7 +29,7 @@
         <Parameter Name="widget" Type="Gtk.Widget" />
       </Parameters>
       <Docs>
-        <summary>Finds all matching RC styles for a given widget, composites them together, and then creates a <see cref="T:Gtk.Style" /> representing the composite appearance.</summary> 
+        <summary>Finds all matching RC styles for a given widget, composites them together, and then creates a <see cref="T:Gtk.Style" /> representing the composite appearance.</summary>
         <param name="widget">a <see cref="T:Gtk.Widget" /></param>
         <returns>a <see cref="T:Gtk.Style" /></returns>
         <remarks>(GTK+ actually keeps a cache of previously created styles, so a new style may not be created.)</remarks>
@@ -226,4 +226,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/RcProperty.xml

@@ -57,7 +57,8 @@
       </Parameters>
       <Docs>
         <summary>The type of this property.</summary>
-        <remarks></remarks>
+        <remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="PropertyName">
@@ -100,4 +101,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/RcPropertyParser.xml

@@ -28,4 +28,4 @@
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/RcStyle.xml

@@ -106,4 +106,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/RcTokenType.xml

@@ -537,4 +537,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ScrollArgs.xml

@@ -41,7 +41,7 @@
       <Docs>
         <summary>The position of the scroller.</summary>
         <returns>a <see cref="T:System.Single" /></returns>
-	<remarks />
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ScrollType">
@@ -69,4 +69,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ScrollEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/SettingsPropertyValue.xml

@@ -38,4 +38,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/StockItem.xml

@@ -141,4 +141,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/StockManager.xml

@@ -78,9 +78,9 @@
         <summary>Looks up a <see cref="T:Gtk.StockItem" /></summary>
         <param name="stock_id">the StockId of the <see cref="T:Gtk.StockItem" /> to return.</param>
         <param name="item">the <see cref="T:Gtk.StockItem" /> if found</param>
-        <returns>returns <see langword="true"/> if a <see cref="T:Gtk.StockItem" />with the <paramref name="stock_id"/>  exists, else returns <see langword="false"/>.</returns>
+        <returns>returns <see langword="true" /> if a <see cref="T:Gtk.StockItem" />with the <paramref name="stock_id" />  exists, else returns <see langword="false" />.</returns>
-        <remarks/>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Style.xml

@@ -216,7 +216,8 @@
       </Parameters>
       <Docs>
         <summary>Attaches a style to a window; this process allocates the colors and creates the GCs (graphics components) for the style - it specializes it to a particular visual and colormap. The process may involve the creation of a new style if the style has already been attached to a window with a different style and colormap.</summary>
-        <param name="window"><see cref="T:Gdk.Window" />, the window to attach the style to</param>
+        <param name="window">
+          <see cref="T:Gdk.Window" />, the window to attach the style to</param>
         <returns> Either <paramref name="style" />, or a newly-created <see cref="T:Gtk.Style" />. If the style is newly created, the style parameter will be dereferenced, and the new style will have a reference count belonging to the caller.</returns>
         <remarks />
       </Docs>
@@ -1257,4 +1258,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Text.xml

@@ -47,4 +47,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextAppearance.xml

@@ -130,4 +130,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextAttributes.xml

@@ -327,4 +327,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextDeletedArgs.xml

@@ -76,4 +76,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextInsertedArgs.xml

@@ -88,4 +88,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextIter.xml

@@ -1167,4 +1167,4 @@ If the GTK_TEXT_SEARCH_VISIBLE_ONLY flag is present, the match may have invisibl
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextMark.xml

@@ -210,4 +210,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextMarkBody.xml

@@ -40,4 +40,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextTag.xml

@@ -743,4 +743,4 @@ Default value: 400
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TextView.xml

@@ -920,7 +920,7 @@ class TextViewSample
       <Parameters />
       <Docs>
         <summary>Fired whenever an anchor (e.g. <see cref="M:Gtk.TextChildAnchor" />) is set within the TextView. </summary>
-        <remarks/>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="MoveCursor">
@@ -932,7 +932,7 @@ class TextViewSample
       <Parameters />
       <Docs>
         <summary>Fired whenever the cursor is moved.</summary>
-        <remarks/>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="PopulatePopup">
@@ -1339,4 +1339,4 @@ class TextViewSample
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ThemeEngine.xml

@@ -122,4 +122,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TitleChangedArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/ToggledArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Toolbar.xml

@@ -369,16 +369,16 @@
       </Parameters>
       <Docs>
         <summary>
-	  <para>
+          <para>
 	    This method is deprecated and should not be used in new code.
 	  </para>
-	  <para>
+          <para>
 	    Adds a new button to the beginning of the toolbar (left or top, depending on toolbar orientation).
 	  </para>
-	  <para>
+          <para>
 If type == <see cref="T:Gtk.ToolbarChildType.Widget" />, widget is used as the new element. If type ==  <see cref="T:Gtk.ToolbarChildType.Radiobutton" />, widget is used to determine the radio group for the new element. In all other cases, widget must be NULL.
 	  </para>
-	</summary>
+        </summary>
         <param name="type">a <see cref="T:Gtk.ToolbarChildType" />, the type of widget to add</param>
         <param name="widget">a <see cref="T:Gtk.Widget" />, the widget itself</param>
         <param name="text">a <see cref="T:System.String" />, a label for the widget</param>
@@ -408,16 +408,16 @@ If type == <see cref="T:Gtk.ToolbarChildType.Widget" />, widget is used as the n
       </Parameters>
       <Docs>
         <summary>
-	  <para>
+          <para>
 	    This method is deprecated and should not be used in new code.
 	  </para>
-	  <para>
+          <para>
 	    Adds a new button to the beginning of the toolbar (left or top, depending on toolbar orientation).
 	  </para>
-	  <para>
+          <para>
 If type == <see cref="T:Gtk.ToolbarChildType.Widget" />, widget is used as the new element. If type ==  <see cref="T:Gtk.ToolbarChildType.Radiobutton" />, widget is used to determine the radio group for the new element. In all other cases, widget must be NULL.
 	  </para>
-	</summary>
+        </summary>
         <param name="type">a <see cref="T:Gtk.ToolbarChildType" />, the type of widget to add</param>
         <param name="widget">a <see cref="T:Gtk.Widget" />, the widget itself</param>
         <param name="text">a <see cref="T:System.String" />, a label for the widget</param>
@@ -425,7 +425,6 @@ If type == <see cref="T:Gtk.ToolbarChildType.Widget" />, widget is used as the n
         <param name="tooltip_private_text">a <see cref="T:System.String" />, context-sensitive detailed help</param>
         <param name="icon">a <see cref="T:Gtk.Widget" />, the icon to use for this widget</param>
         <param name="cb">a <see cref="T:Gtk.SignalFunc" />, a callback function to use when the new widget is touched.</param>
-
         <param name="user_data">a <see cref="T:System.IntPtr" />, data to pass to the callback.</param>
         <param name="position">a <see cref="T:System.Int32" />, the number of toolbar widgets to insert this element after.</param>
         <returns>a <see cref="T:Gtk.Widget" />, the new toolbar element.</returns>
@@ -577,4 +576,4 @@ If type == <see cref="T:Gtk.ToolbarChildType.Widget" />, widget is used as the n
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Tooltips.xml

@@ -204,4 +204,4 @@ class ToolTipsExample
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TooltipsData.xml

@@ -127,4 +127,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Tree.xml

@@ -78,4 +78,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeCellDataFunc.xml

@@ -32,4 +32,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/TreeDataList.xml

@@ -95,4 +95,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeDestroyCountFunc.xml

@@ -31,4 +31,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/TreeDragDest.xml

@@ -35,8 +35,8 @@
         <summary>
 	  Determines whether a drop is possible before the given <paramref name="dest" />, at the same depth as <paramref name="dest" />. i.e., can we drop the data in <paramref name="selection_data" /> at that location. <paramref name="dest" /> does not have to exist; the return value will almost certainly be FALSE if the parent of <paramref name="dest" /> doesn't exist, though.
 </summary>
-        <param name="dest">a <see cref='M:Gtk.TreePath' />, the potential drop target</param>
+        <param name="dest">a <see cref="M:Gtk.TreePath" />, the potential drop target</param>
-        <param name="selection_data">a <see cref='M:Gtk.SelectionData' />, the data to drop</param>
+        <param name="selection_data">a <see cref="M:Gtk.SelectionData" />, the data to drop</param>
         <returns>A boolean for whether the drop is possible.</returns>
         <remarks />
       </Docs>
@@ -55,13 +55,11 @@
         <summary>
 	  Asks the TreeDragDest to insert a row before the given <paramref name="dest_path" />, deriving the contents of the row from the given <see cref="M:Gtk.SelectionData" />.
 	</summary>
-        <param name="dest_path">a <see cref='M:Gtk.TreePath' />, where to drop the data</param>
+        <param name="dest_path">a <see cref="M:Gtk.TreePath" />, where to drop the data</param>
-        <param name="selection_data"> a  <see cref='M:Gtk.SelectionData' />, the data to drop</param>
+        <param name="selection_data"> a  <see cref="M:Gtk.SelectionData" />, the data to drop</param>
         <returns>A boolean for whether the row was dropped successfully.</returns>
         <remarks>If dest_path is outside the tree so that inserting before it is impossible, FALSE will be returned. Also, FALSE may be returned if the new row cannot be created for some model-specific reason. Should robustly handle a destination path no longer found in the model.</remarks>
-
-
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeDragSource.xml

@@ -36,7 +36,7 @@
         <param name="path">a <see cref="M:Gtk.TreePath" /></param>
         <param name="selection_data">a <see cref="M:Gtk.SelectionData" /> object to fill with data</param>
         <returns>A boolean; true if data of the required type was provided.</returns>
-        <remarks>FIXME: the original doc says, "selection_data->target gives the required type of the data.", but there doesn't seem to be a parallel in Gtk#. Check this.</remarks>
+        <remarks>FIXME: the original doc says, "selection_data-&gt;target gives the required type of the data.", but there doesn't seem to be a parallel in Gtk#. Check this.</remarks>
       </Docs>
     </Member>
     <Member MemberName="RowDraggable">
@@ -74,4 +74,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeIter.xml

@@ -142,4 +142,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeIterCompareFunc.xml

@@ -31,4 +31,4 @@
   <ReturnValue>
     <ReturnType>System.Int32</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/TreeModel.xml

@@ -712,4 +712,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeModelForeachFunc.xml

@@ -32,4 +32,4 @@ as parameters to <see cref="M:Gtk.TreeModel.Foreach()" />.</remarks>
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/TreeModelSort.xml

@@ -1085,4 +1085,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreePath.xml

@@ -12,7 +12,6 @@
   <Docs>
     <summary>Represents a particular node of a <see cref="T:Gtk.TreeView" />.</summary>
     <remarks>A TreePath can be converted into either an array of unsigned integers or a string. The string form is a list of numbers separated by a colon. Each number refers to the offset at that level. Thus, the path "0" refers to the root node and the path "2:4" refers to the fifth child of the third node.</remarks>
-
   </Docs>
   <Base>
     <BaseTypeName>GLib.Opaque</BaseTypeName>
@@ -283,4 +282,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeSelection.xml

@@ -528,4 +528,4 @@ class TreeSelectionSample
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeSelectionFunc.xml

@@ -8,7 +8,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>A delegate for specifying the shape of functions passed as parameters to <see cref="F:Gtk.TreeSelection.SetSelectFunction()" />.</summary>
-    <remarks>This function will get called on select and unselect of widget text. It should return <see langword='true' /> if the state of the tree node may be toggled and <see langword="false" /> if the state of the node should not be changed.</remarks>
+    <remarks>This function will get called on select and unselect of widget text. It should return <see langword="true" /> if the state of the tree node may be toggled and <see langword="false" /> if the state of the node should not be changed.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -32,4 +32,4 @@
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/TreeSortable.xml

@@ -134,4 +134,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/TreeView.xml

@@ -1191,9 +1191,9 @@ tree_view.AppendColumn ("title", text, "text", 0);
         <param name="focus_cell">a <see cref="T:Gtk.CellRenderer" /></param>
         <param name="start_editing">a <see cref="T:System.Boolean" /></param>
         <remarks>
-	  <para>If focus_column is not null, then focus is given to the column specified by it. If focus_column and focus_cell are not null, and focus_column contains 2 or more editable or activatable cells, then focus is given to the cell specified by focus_cell. Additionally, if focus_column is specified, and start_editing is null, then editing should be started in the specified cell.</para>
+          <para>If focus_column is not null, then focus is given to the column specified by it. If focus_column and focus_cell are not null, and focus_column contains 2 or more editable or activatable cells, then focus is given to the cell specified by focus_cell. Additionally, if focus_column is specified, and start_editing is null, then editing should be started in the specified cell.</para>
-	  <para>This function is often followed by<see cref="T:Gtk.Widget.GrabFocus" />(tree_view_obj) in order to give keyboard focus to the widget. Please note that editing can only happen when the widget is realized.</para>
+          <para>This function is often followed by<see cref="T:Gtk.Widget.GrabFocus" />(tree_view_obj) in order to give keyboard focus to the widget. Please note that editing can only happen when the widget is realized.</para>
-	</remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ExpandToPath">
@@ -1711,9 +1711,9 @@ tree_view.AppendColumn ("title", text, "text", 0);
         <param name="cell_y">a <see cref="T:System.Int32" /> to fill with the y coordinate relative to the cell background.</param>
         <returns>a <see cref="T:System.Boolean" />, true if a row exists at (x,y).</returns>
         <remarks>
-	  <para>x and y must come from an event on the tree_view only where the event's window is the same as the window this TreeView renders to. It is primarily for things like popup menus. If path is non-null, then it will be filled with the GtkTreePath at that point. This path should be freed with <see cref="T:Gtk.TreePath.Free" />. If column is non-NULL, then it will be filled with the column at that point.</para>
+          <para>x and y must come from an event on the tree_view only where the event's window is the same as the window this TreeView renders to. It is primarily for things like popup menus. If path is non-null, then it will be filled with the GtkTreePath at that point. This path should be freed with <see cref="T:Gtk.TreePath.Free" />. If column is non-NULL, then it will be filled with the column at that point.</para>
-	  <para>cell_x and cell_y return the coordinates relative to the cell background (i.e. the background_area passed to <see cref="T:Gtk.CellRenderer.Render" />). This function is only meaningful if the TreeView object is realized.</para>
+          <para>cell_x and cell_y return the coordinates relative to the cell background (i.e. the background_area passed to <see cref="T:Gtk.CellRenderer.Render" />). This function is only meaningful if the TreeView object is realized.</para>
-	</remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetPathAtPos">
@@ -1739,4 +1739,4 @@ tree_view.AppendColumn ("title", text, "text", 0);
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/UnmapEventArgs.xml

@@ -46,4 +46,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/UnmapEventHandler.xml

@@ -34,4 +34,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
+</Type>

doc/en/Gtk/UrlRequestedArgs.xml

@@ -57,4 +57,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/VScrollbar.xml

@@ -74,7 +74,8 @@
         <summary>Creates a new vertical scrollbar.</summary>
         <param name="adjustment">The <see cref="T:Gtk.Adjustment" /> to use, or <see langword="null" /> to create a new adjustment.</param>
         <returns>The new <see cref="T:Gtk.VScrollbar" /></returns>
-        <remarks></remarks>
+        <remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -105,4 +106,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/Visibility.xml

@@ -82,4 +82,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

doc/en/Gtk/VisibilityNotifyEventArgs.xml

@@ -45,4 +45,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>