Contributions from Todd Berman

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

doc/en/Gtk/Notebook.xml

@@ -1058,10 +1058,11 @@ class NotebookSample
         <Parameter Name="child" Type="Gtk.Widget" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns the page number that a child <see cref="T:Gtk.Widget" /> exists on.</summary>
-        <param name="child">a <see cref="T:Gtk.Widget" /></param>
+        <param name="child">
-        <returns>a <see cref="T:System.Int32" /></returns>
+          <see cref="T:Gtk.Widget" /> to look for.</param>
-        <remarks>To be added</remarks>
+        <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>

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
+      <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>
-        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>
     </remarks>
   </Docs>
   <Base>

doc/en/Gtk/TextIter.xml

@@ -141,8 +141,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Moves the iterator backward one line</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <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>
+        <summary>Moves the iterator back a number of lines.</summary>
-        <param name="count">To be added: an object of type 'int'</param>
+        <param name="count">number of lines to move backwards.</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <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>
+        <summary>Returns true if the iterator is at the end of a line.</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <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>
+        <summary>Moves the iterator back a number of characters.</summary>
-        <param name="count">To be added: an object of type 'int'</param>
+        <param name="count">number of characters to move backwards.</param>
-        <returns>To be added: an object of type 'bool'</returns>
+        <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>
+        <summary>Moves the iterator back one character</summary>
-        <returns>To be added: an object of type 'bool'</returns>
+        <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>
+        <summary>Line number the iterator is currently on.</summary>
-        <param name="value">To be added: an object of type 'int'</param>
+        <param name="value">Moves the iterator to this line number.</param>
-        <returns>To be added: an object of type 'int'</returns>
+        <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>
+        <summary>Obtains the buffer the iter is in</summary>
-        <returns>To be added: an object of type 'Gtk.TextBuffer'</returns>
+        <returns>containing buffer</returns>
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -1034,8 +1034,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns true if the iterator is at the end of the parent <see cref="T:Gtk.TextBuffer" /></summary>
-        <returns>a <see cref="T:System.Boolean" /></returns>
+        <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>