From 7d124df67a18bb0c4224f65e4e4a45b4ab32cf07 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Sun, 22 Aug 2004 05:31:56 +0000
Subject: [PATCH] 2004-08-22  Shane Landrum <epicene@pobox.com>

	* en/Gtk/RowActivatedArgs.xml
	* en/Gtk/RowCollapsedArgs.xml
	* en/Gtk/RowExpandedArgs.xml
	* en/Gtk/TestCollapseRowArgs.xml
	* en/Gtk/TestExpandRowArgs.xml: Event argument delegate docs.
	* en/Gtk/TreeView.xml: Event docs.
	* en/Gtk/TreeViewColumnDropFunc.xml
	* en/Gtk/TreeViewMappingFunc.xml
	* en/Gtk/TreeViewSearchEqualFunc.xml: delegate docs for TreeView

svn path=/trunk/gtk-sharp/; revision=32651
---
 doc/ChangeLog                          | 12 ++++++++++++
 doc/en/Gtk/RowActivatedArgs.xml        | 14 +++++++-------
 doc/en/Gtk/RowCollapsedArgs.xml        | 14 +++++++-------
 doc/en/Gtk/RowExpandedArgs.xml         | 15 ++++++++-------
 doc/en/Gtk/TestCollapseRowArgs.xml     | 14 +++++++-------
 doc/en/Gtk/TestExpandRowArgs.xml       | 14 +++++++-------
 doc/en/Gtk/TreeView.xml                | 14 +++++++-------
 doc/en/Gtk/TreeViewColumnDropFunc.xml  |  8 +++++---
 doc/en/Gtk/TreeViewMappingFunc.xml     |  8 +++++---
 doc/en/Gtk/TreeViewSearchEqualFunc.xml |  8 +++++---
 10 files changed, 70 insertions(+), 51 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 0e6f68255..bed2b3479 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,15 @@
+2004-08-22  Shane Landrum <epicene@pobox.com>
+
+	* en/Gtk/RowActivatedArgs.xml
+	* en/Gtk/RowCollapsedArgs.xml
+	* en/Gtk/RowExpandedArgs.xml
+	* en/Gtk/TestCollapseRowArgs.xml
+	* en/Gtk/TestExpandRowArgs.xml: Event argument delegate docs.
+	* en/Gtk/TreeView.xml: Event docs.
+	* en/Gtk/TreeViewColumnDropFunc.xml
+	* en/Gtk/TreeViewMappingFunc.xml
+	* en/Gtk/TreeViewSearchEqualFunc.xml: delegate docs for TreeView
+	
 2004-08-20  Mike Kestner  <mkestner@ximian.com>
 
 	* en/Atk/Relation.xml : update ctor to new sig.
diff --git a/doc/en/Gtk/RowActivatedArgs.xml b/doc/en/Gtk/RowActivatedArgs.xml
index f12463309..4fb5ce9a9 100644
--- a/doc/en/Gtk/RowActivatedArgs.xml
+++ b/doc/en/Gtk/RowActivatedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gtk.TreeViewColumn</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreeViewColumn'</returns>
-        <remarks>To be added</remarks>
+        <summary>The column that was clicked on as part of the row activation event.</summary>
+        <returns>A <see cref="T:Gtk.TreeViewColumn"/></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Path">
@@ -51,10 +51,10 @@
         <ReturnType>Gtk.TreePath</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreePath'</returns>
-        <remarks>To be added</remarks>
+        <summary>The path of the row that was activated.</summary>
+        <returns>A <see cref="T:Gtk.TreePath"/></returns>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/RowCollapsedArgs.xml b/doc/en/Gtk/RowCollapsedArgs.xml
index 18d6167ba..1f93c48bb 100644
--- a/doc/en/Gtk/RowCollapsedArgs.xml
+++ b/doc/en/Gtk/RowCollapsedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gtk.TreePath</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreePath'</returns>
-        <remarks>To be added</remarks>
+        <summary>The path of the row that was expanded.</summary>
+        <returns>A <see cref="T:Gtk.TreePath"/></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Iter">
@@ -51,10 +51,10 @@
         <ReturnType>Gtk.TreeIter</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreeIter'</returns>
-        <remarks>To be added</remarks>
+        <summary>The row that was collapsed.</summary>
+        <returns>A <see cref="T:Gtk.TreeIter"/></returns>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/RowExpandedArgs.xml b/doc/en/Gtk/RowExpandedArgs.xml
index fdffced7b..b71ccaf3e 100644
--- a/doc/en/Gtk/RowExpandedArgs.xml
+++ b/doc/en/Gtk/RowExpandedArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gtk.TreePath</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreePath'</returns>
-        <remarks>To be added</remarks>
+        <summary>The path of the row that was expanded.</summary>
+        <returns>A <see cref="T:Gtk.TreePath"/></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Iter">
@@ -51,10 +51,11 @@
         <ReturnType>Gtk.TreeIter</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreeIter'</returns>
-        <remarks>To be added</remarks>
+        <summary>The row that was expanded.</summary>
+        <returns>A <see cref="T:Gtk.TreeIter"/></returns>
+        <remarks />
+
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TestCollapseRowArgs.xml b/doc/en/Gtk/TestCollapseRowArgs.xml
index 8db939a35..ed022afbe 100644
--- a/doc/en/Gtk/TestCollapseRowArgs.xml
+++ b/doc/en/Gtk/TestCollapseRowArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gtk.TreePath</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreePath'</returns>
-        <remarks>To be added</remarks>
+        <summary>The path of the row being tested for collapsability.</summary>
+        <returns>A <see cref="T:Gtk.TreePath"/></returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Iter">
@@ -51,10 +51,10 @@
         <ReturnType>Gtk.TreeIter</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreeIter'</returns>
-        <remarks>To be added</remarks>
+        <summary>The row being tested for collapsability.</summary>
+        <returns>A <see cref="T:Gtk.TreeIter"/></returns>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TestExpandRowArgs.xml b/doc/en/Gtk/TestExpandRowArgs.xml
index 94132793d..946a5b633 100644
--- a/doc/en/Gtk/TestExpandRowArgs.xml
+++ b/doc/en/Gtk/TestExpandRowArgs.xml
@@ -39,9 +39,9 @@
         <ReturnType>Gtk.TreePath</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreePath'</returns>
-        <remarks>To be added</remarks>
+        <summary>The path of the row being tested for expandability.</summary>
+        <returns>A <see cref="T:Gtk.TreePath"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Iter">
@@ -51,10 +51,10 @@
         <ReturnType>Gtk.TreeIter</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.TreeIter'</returns>
-        <remarks>To be added</remarks>
+        <summary>The row being tested for expandability.</summary>
+        <returns>A <see cref="T:Gtk.TreeIter"/></returns>
+        <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TreeView.xml b/doc/en/Gtk/TreeView.xml
index 45a10ab9b..a18670c41 100644
--- a/doc/en/Gtk/TreeView.xml
+++ b/doc/en/Gtk/TreeView.xml
@@ -476,7 +476,7 @@ public class TreeViewDemo {
       </Parameters>
       <Docs>
         <summary>Sets the compare function for the interactive search capabilities.</summary>
-        <param name="path">The <see cref="T:Gtk.TreePath" /> wich represents the node</param>
+        <param name="path">The <see cref="T:Gtk.TreePath" /> representing the node</param>
         <param name="search_user_data">an object of type <see cref="T:System.IntPtr" /></param>
         <param name="search_destroy">an object of type <see cref="T:Gtk.DestroyNotify" /></param>
         <remarks>
@@ -931,7 +931,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the widget wants to find out whether a row can be expanded or not.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -967,7 +967,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the columns of this tree change.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -979,7 +979,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the row where the cursor is is expanded or collapsed.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -991,7 +991,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when a row is activated; see <see cref="M:Gtk.TreeView.ActivateRow" />.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -1003,7 +1003,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Fired when the system wants to know whether a particular row can be collapsed.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -1015,7 +1015,7 @@ public class TreeViewDemo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>To be added.</summary>
         <remarks />
       </Docs>
     </Member>
diff --git a/doc/en/Gtk/TreeViewColumnDropFunc.xml b/doc/en/Gtk/TreeViewColumnDropFunc.xml
index 8437b0c03..3816a9885 100644
--- a/doc/en/Gtk/TreeViewColumnDropFunc.xml
+++ b/doc/en/Gtk/TreeViewColumnDropFunc.xml
@@ -7,8 +7,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>A delegate type to specify a function signature for saying
+      where a dragged column may be dropped.</summary>
+    <remarks>See <see cref="M:Gtk.TreeView.SetColumnDragFunction"/> for
+    more details on how this delegate should be used.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -32,4 +34,4 @@
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TreeViewMappingFunc.xml b/doc/en/Gtk/TreeViewMappingFunc.xml
index 73b61ba44..7385e6a7a 100644
--- a/doc/en/Gtk/TreeViewMappingFunc.xml
+++ b/doc/en/Gtk/TreeViewMappingFunc.xml
@@ -7,8 +7,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>A delegate to specify the signature of a function to be called on
+a set of <see cref="T:Gtk.TreeView"/> rows that are expanded.</summary>
+    <remarks>See <see cref="M:Gtk.TreeView.MapExpandedRows"/> for when and
+      how a function of this shape gets called.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -30,4 +32,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/TreeViewSearchEqualFunc.xml b/doc/en/Gtk/TreeViewSearchEqualFunc.xml
index 8afaf639f..24d297a58 100644
--- a/doc/en/Gtk/TreeViewSearchEqualFunc.xml
+++ b/doc/en/Gtk/TreeViewSearchEqualFunc.xml
@@ -7,8 +7,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>A delegate to specify a compare function for interactive
+    searching.</summary>
+    <remarks>See <see cref="M:Gtk.TreeView.SetSearchEqualFunc"/> for more
+      context about how this delegate is used.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -32,4 +34,4 @@
   <ReturnValue>
     <ReturnType>System.Boolean</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>