From fb74f1f04d6f760cdb0c12a346e49ce9d59de2de Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Mon, 12 Apr 2004 14:16:11 +0000
Subject: [PATCH] Contributions from Todd Berman

svn path=/trunk/gtk-sharp/; revision=25364
---
 doc/en/Gtk/Notebook.xml     |  9 ++++----
 doc/en/Gtk/NotebookPage.xml |  9 ++------
 doc/en/Gtk/TextIter.xml     | 44 ++++++++++++++++++-------------------
 3 files changed, 29 insertions(+), 33 deletions(-)

diff --git a/doc/en/Gtk/Notebook.xml b/doc/en/Gtk/Notebook.xml
index 16cb0db10..5db70babf 100644
--- a/doc/en/Gtk/Notebook.xml
+++ b/doc/en/Gtk/Notebook.xml
@@ -1058,10 +1058,11 @@ class NotebookSample
         <Parameter Name="child" Type="Gtk.Widget" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="child">a <see cref="T:Gtk.Widget" /></param>
-        <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the page number that a child <see cref="T:Gtk.Widget" /> exists on.</summary>
+        <param name="child">
+          <see cref="T:Gtk.Widget" /> to look for.</param>
+        <returns>Page number that the widget exists on, -1 if the widget isn't in the notebook.</returns>
+        <remarks>This function returns -1 if the <see cref="T:Gtk.Widget" /> is not a direct child of the notebook.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gtk/NotebookPage.xml b/doc/en/Gtk/NotebookPage.xml
index a4e8416ed..658589d42 100644
--- a/doc/en/Gtk/NotebookPage.xml
+++ b/doc/en/Gtk/NotebookPage.xml
@@ -10,14 +10,9 @@
   </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>Notebook page</summary>
+    <summary>This class has been deprecated.</summary>
     <remarks>
-      <para>The Notebook page is a widget used to store and
-        represent a single page of a <see cref="T:Gtk.Notebook" />
-	Usually it will contain a <see cref="T:Gtk.Label" /> but it
-	can contain other widgets giving the developer the possibility
-	to use custom widgets.
-      </para>
+      <para>This class has been deprecated. The PageNum function that used to exist here is now <see cref="M:Gtk.Notebook.PageNum(Gtk.Widget)" /></para>
     </remarks>
   </Docs>
   <Base>
diff --git a/doc/en/Gtk/TextIter.xml b/doc/en/Gtk/TextIter.xml
index 0babe2d6d..d0c4eee47 100644
--- a/doc/en/Gtk/TextIter.xml
+++ b/doc/en/Gtk/TextIter.xml
@@ -141,8 +141,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <summary>Moves the iterator backward one line</summary>
+        <returns>true if the operation succeeded.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -263,9 +263,9 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="count">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <summary>Moves the iterator back a number of lines.</summary>
+        <param name="count">number of lines to move backwards.</param>
+        <returns>true if the operation succeeded.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -277,8 +277,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <summary>Returns true if the iterator is at the end of a line.</summary>
+        <returns>true if the iterator is at the end of a line.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -529,9 +529,9 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="count">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <summary>Moves the iterator back a number of characters.</summary>
+        <param name="count">number of characters to move backwards.</param>
+        <returns>true if the operation succeeded</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -688,8 +688,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <summary>Moves the iterator back one character</summary>
+        <returns>true if the operation succeeded</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -852,9 +852,9 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <summary>Line number the iterator is currently on.</summary>
+        <param name="value">Moves the iterator to this line number.</param>
+        <returns>The line number the iterator is currently on.</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -973,8 +973,8 @@
         <ReturnType>Gtk.TextBuffer</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TextBuffer'</returns>
+        <summary>Obtains the buffer the iter is in</summary>
+        <returns>containing buffer</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1034,8 +1034,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
+        <summary>Returns true if the iterator is at the end of the parent <see cref="T:Gtk.TextBuffer" /></summary>
+        <returns>true if the iterator is equal to Buffer.EndIter</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1060,9 +1060,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>returns true if the iter is at the caret</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>returns true if this iterator equals the iterator returned by Buffer.GetIterAtMark (Buffer.InsertMark)</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -1121,4 +1121,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file