From 91f351d46d2df3f9f2a30f6ab1b974c930831e1b Mon Sep 17 00:00:00 2001
From: John Luke <jluke@mono-cvs.ximian.com>
Date: Sun, 12 Oct 2003 08:06:42 +0000
Subject: [PATCH] 2003-10-12  John Luke  <jluke@cfl.rr.com>

	* en/Gtk/HTML.xml:  call begin before Editable = true, update links, normalize

svn path=/trunk/gtk-sharp/; revision=18906
---
 doc/ChangeLog       |   4 ++
 doc/en/Gtk/HTML.xml | 136 ++++++++++++++++++++++----------------------
 2 files changed, 72 insertions(+), 68 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a3b10c65f..0f6b0104e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2003-10-12  John Luke  <jluke@cfl.rr.com>
+
+	* en/Gtk/HTML.xml:  call begin before Editable = true, update links, normalize
+	
 2003-10-09  John Luke  <jluke@cfl.rr.com>
 
 	* en/Gnome/About.xml: add note about destroy on close event
diff --git a/doc/en/Gtk/HTML.xml b/doc/en/Gtk/HTML.xml
index 71724b254..aa4af4a40 100644
--- a/doc/en/Gtk/HTML.xml
+++ b/doc/en/Gtk/HTML.xml
@@ -10,16 +10,16 @@
     <summary>Lightweight HTML rendering widget.</summary>
     <remarks>
       <para>
-	Gtk.HTML is a lightweight HTML rendering widget, as well as as
+	<see cref="T:Gtk.HTML" /> is a lightweight HTML rendering widget, as well as as
 	simple graphical HTML editor.
       </para>
       <para>
-	Developers can also be used as a widget container (<see cref="T:Gtk.Container" />).  It is an easy way for viewing HTML
+	Developers can also use it as a widget container (<see cref="T:Gtk.Container" />).  It is an easy way for viewing HTML
 	documents in your application and for layout UI of your
 	application throught HTML.
       </para>
       <para>
-	Gtk.HTML does not have support for CSS or JavaScript.
+	<see cref="T:Gtk.HTML" /> does not have support for CSS or JavaScript.
       </para>
       <para>
 	The following sample is a very minimal web browser.
@@ -171,9 +171,9 @@ namespace HtmlTest
       </Parameters>
       <Docs>
         <summary>Constructs an instance of a Gtk.HTML widget</summary>
-        <param name="html">A Gtk.HTML derivative object.</param>
+        <param name="html">A <see cref="T:Gtk.HTML" /> derivative object.</param>
         <remarks>This is a low-level routine, and should only be used
-        to initialize an instance of a Gtk.HTML derivative class.</remarks>
+        to initialize an instance of a <see cref="T:Gtk.HTML" /> derivative class.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetObjectById">
@@ -204,9 +204,9 @@ namespace HtmlTest
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="type">To be added: an object of type 'string'</param>
-        <param name="receiver">To be added: an object of type 'Gtk.HTMLSaveReceiverFn'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="type">an object of type <see cref="T:System.String" /></param>
+        <param name="receiver">an object of type <see cref="T:Gtk.HTMLSaveReceiverFn" /></param>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -245,7 +245,7 @@ namespace HtmlTest
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="style">To be added: an object of type 'Gtk.HTMLFontStyle'</param>
+        <param name="style">an object of type <see cref="T:Gtk.HTMLFontStyle" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -286,9 +286,9 @@ namespace HtmlTest
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="handle">To be added: an object of type 'Gtk.HTMLStream'</param>
-        <param name="buffer">To be added: an object of type 'string'</param>
-        <param name="size">To be added: an object of type 'int'</param>
+        <param name="handle">an object of type <see cref="T:Gtk.HTMLStream" /></param>
+        <param name="buffer">an object of type <see cref="T:System.String" /></param>
+        <param name="size">an object of type <see cref="T:System.Int32" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -456,7 +456,7 @@ class X {
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -545,7 +545,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="html_src">To be added: an object of type 'string'</param>
+        <param name="html_src">an object of type <see cref="T:System.String" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -598,10 +598,10 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="target_frame">To be added: an object of type 'string'</param>
-        <param name="content_type">To be added: an object of type 'string'</param>
-        <param name="flags">To be added: an object of type 'Gtk.HTMLBeginFlags'</param>
-        <returns>To be added: an object of type 'Gtk.HTMLStream'</returns>
+        <param name="target_frame">an object of type <see cref="T:System.String" /></param>
+        <param name="content_type">an object of type <see cref="T:System.String" /></param>
+        <param name="flags">an object of type <see cref="T:Gtk.HTMLBeginFlags" /></param>
+        <returns>an object of type <see cref="T:Gtk.HTMLStream" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -616,7 +616,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="debug">To be added: an object of type 'bool'</param>
+        <param name="debug">an object of type <see cref="T:System.Boolean" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -629,7 +629,7 @@ class X {
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -645,8 +645,8 @@ class X {
       </Parameters>
       <Docs>
         <summary>Unsupported in Gtk#.  Installs hooks for the editor.</summary>
-        <param name="api">To be added: an object of type 'Gtk.HTMLEditorAPI'</param>
-        <param name="data">To be added: an object of type 'IntPtr'</param>
+        <param name="api">an object of type <see cref="T:Gtk.HTMLEditorAPI" /></param>
+        <param name="data">an object of type <see cref="T:System.IntPtr" /></param>
         <remarks>This API is currently not supported.</remarks>
       </Docs>
     </Member>
@@ -661,7 +661,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="to_be_destroyed">To be added: an object of type 'Gtk.HTML'</param>
+        <param name="to_be_destroyed">an object of type <see cref="T:Gtk.HTML" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -688,7 +688,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="html_src">To be added: an object of type 'string'</param>
+        <param name="html_src">an object of type <see cref="T:System.String" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -704,8 +704,8 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="and_mask">To be added: an object of type 'Gtk.HTMLFontStyle'</param>
-        <param name="or_mask">To be added: an object of type 'Gtk.HTMLFontStyle'</param>
+        <param name="and_mask">an object of type <see cref="T:Gtk.HTMLFontStyle" /></param>
+        <param name="or_mask">an object of type <see cref="T:Gtk.HTMLFontStyle" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -720,7 +720,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="url">To be added: an object of type 'string'</param>
+        <param name="url">an object of type <see cref="T:System.String" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -735,7 +735,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="url">To be added: an object of type 'string'</param>
+        <param name="url">an object of type <see cref="T:System.String" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -767,7 +767,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="url">To be added: an object of type 'string'</param>
+        <param name="url">an object of type <see cref="T:System.String" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -785,11 +785,11 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="selection">To be added: an object of type 'Gdk.Atom'</param>
-        <param name="type">To be added: an object of type 'int'</param>
-        <param name="time">To be added: an object of type 'int'</param>
-        <param name="as_cite">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <param name="selection">an object of type <see cref="T:Gdk.Atom" /></param>
+        <param name="type">an object of type <see cref="T:System.Int32" /></param>
+        <param name="time">an object of type <see cref="T:System.Int32" /></param>
+        <param name="as_cite">an object of type <see cref="T:System.Boolean" /></param>
+        <returns>an object of type <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -816,8 +816,8 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="receiver">To be added: an object of type 'Gtk.HTMLSaveReceiverFn'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="receiver">an object of type <see cref="T:Gtk.HTMLSaveReceiverFn" /></param>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -894,7 +894,7 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="allow">To be added: an object of type 'bool'</param>
+        <param name="allow">an object of type <see cref="T:System.Boolean" /></param>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -945,8 +945,8 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="command_name">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="command_name">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -984,7 +984,7 @@ class X {
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>Creates an empty GtkHTML widget.</summary>
+        <summary>Creates an empty <see cref="T:Gtk.HTML" /> widget.</summary>
         <returns>The new constructed <see cref="T:Gtk.HTML" /> widget.</returns>
         <remarks>
           <para>
@@ -1001,8 +1001,8 @@ class X {
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The GLib Type for Gtk.HTML</summary>
-        <returns>The GLib Type for the Gtk.HTML class.</returns>
+        <summary>The <see cref="T:GLib.Type" /> for <see cref="T:Gtk.HTML" /></summary>
+        <returns>The <see cref="T:GLib.Type" /> for the <see cref="T:Gtk.HTML" /> class.</returns>
         <remarks />
       </Docs>
     </Member>
@@ -1020,8 +1020,8 @@ class X {
           <see langword="true" /> if the contents are editable,
         <see langword="false" />otherwise. </returns>
         <remarks>
-	  Whether this Gtk.HTML instance can be used as an HTML
-	  editor.
+	  Whether this <see cref="T:Gtk.HTML" /> instance can be used as an HTML
+	  editor.  Note:  <see cref="M:Gtk.HTML.Begin" /> must be called before this can be set = <see langword="true" />.
 	</remarks>
       </Docs>
     </Member>
@@ -1033,7 +1033,7 @@ class X {
       </ReturnValue>
       <Docs>
         <summary>To be added</summary>
-        <returns>To be added: an object of type 'uint'</returns>
+        <returns>an object of type <see cref="T:System.UInt32" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1046,8 +1046,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1060,8 +1060,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1074,8 +1074,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1088,8 +1088,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.HTMLParagraphStyle'</param>
-        <returns>To be added: an object of type 'Gtk.HTMLParagraphStyle'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.HTMLParagraphStyle" /></param>
+        <returns>an object of type <see cref="T:Gtk.HTMLParagraphStyle" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1102,8 +1102,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean" /></param>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1116,8 +1116,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'double'</param>
-        <returns>To be added: an object of type 'double'</returns>
+        <param name="value">an object of type <see cref="T:System.Double" /></param>
+        <returns>an object of type <see cref="T:System.Double" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1130,8 +1130,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.HTMLParagraphAlignment'</param>
-        <returns>To be added: an object of type 'Gtk.HTMLParagraphAlignment'</returns>
+        <param name="value">an object of type <see cref="T:Gtk.HTMLParagraphAlignment" /></param>
+        <returns>an object of type <see cref="T:Gtk.HTMLParagraphAlignment" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1144,8 +1144,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <param name="value">an object of type <see cref="T:System.Boolean" /></param>
+        <returns>an object of type <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1574,8 +1574,8 @@ class X {
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="Astr">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gtk.HTML'</returns>
+        <param name="Astr">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:Gtk.HTML" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1588,8 +1588,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1602,8 +1602,8 @@ class X {
       <Parameters></Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
+        <param name="value">an object of type <see cref="T:System.String" /></param>
+        <returns>an object of type <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1664,4 +1664,4 @@ class X {
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>