From 6032cbafcbe6a9f53b654fb9ca31f88f8ebb06d8 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Sun, 29 Aug 2004 08:53:41 +0000
Subject: [PATCH] 2004-08-29 Shane Landrum <epicene@pobox.com>

	* Menu.xml
	* MenuDetachFunc.xml
	* MenuItem.xml
	* MenuPositionFunc.xml
	* MenuShell.xml: Docs for menu-related classes.

svn path=/trunk/gtk-sharp/; revision=32983
---
 doc/ChangeLog                   |  8 ++++++++
 doc/en/Gtk/Menu.xml             |  8 ++++----
 doc/en/Gtk/MenuDetachFunc.xml   |  6 +++---
 doc/en/Gtk/MenuItem.xml         |  6 +++---
 doc/en/Gtk/MenuPositionFunc.xml |  6 +++---
 doc/en/Gtk/MenuShell.xml        | 16 +++++++++++-----
 6 files changed, 32 insertions(+), 18 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 0a7a6f27c..8a3470569 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,11 @@
+2004-08-29 Shane Landrum <epicene@pobox.com>
+
+	* Menu.xml
+	* MenuDetachFunc.xml
+	* MenuItem.xml
+	* MenuPositionFunc.xml
+	* MenuShell.xml: Docs for menu-related classes.	
+
 2004-08-29 Shane Landrum <epicene@pobox.com>
 	
 	* en/Gtk/TextSegCheckFunc.xml
diff --git a/doc/en/Gtk/Menu.xml b/doc/en/Gtk/Menu.xml
index 0580a0173..1109b0eb2 100644
--- a/doc/en/Gtk/Menu.xml
+++ b/doc/en/Gtk/Menu.xml
@@ -422,10 +422,10 @@ class PopupSample
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>The title of this menu when it is torn off</summary>
         <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>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Screen">
@@ -437,10 +437,10 @@ class PopupSample
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>The physical screen this menu is placed on.</summary>
         <param name="value">a <see cref="T:Gdk.Screen" /></param>
         <returns>a <see cref="T:Gdk.Screen" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetActive">
diff --git a/doc/en/Gtk/MenuDetachFunc.xml b/doc/en/Gtk/MenuDetachFunc.xml
index f2086e7ca..2c8ad0317 100644
--- a/doc/en/Gtk/MenuDetachFunc.xml
+++ b/doc/en/Gtk/MenuDetachFunc.xml
@@ -7,8 +7,8 @@
   </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 for a function that will be called when the user invokes <see cref="M:Gtk.Menu.Detach" />.</summary>
+    <remarks>(TODO: examples.)</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -30,4 +30,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/MenuItem.xml b/doc/en/Gtk/MenuItem.xml
index 4f1340395..526f61d39 100644
--- a/doc/en/Gtk/MenuItem.xml
+++ b/doc/en/Gtk/MenuItem.xml
@@ -157,8 +157,8 @@
       <Docs>
         <summary>Creates a new MenuItem containing a label.</summary>
         <param name="label">The label text on the menu item, with an underscore in front of the mnemonic character.</param>
-        <returns>To be added: an object of type 'Gtk.MenuItem'</returns>
-        <remarks>To be added</remarks>
+        <returns>A <see cref="T:Gtk.MenuItem"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Submenu">
@@ -353,4 +353,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/MenuPositionFunc.xml b/doc/en/Gtk/MenuPositionFunc.xml
index 92f3fae0a..ced8261ca 100644
--- a/doc/en/Gtk/MenuPositionFunc.xml
+++ b/doc/en/Gtk/MenuPositionFunc.xml
@@ -7,8 +7,8 @@
   </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 function for positioning a popup menu.</summary>
+    <remarks>Gets invoked by <see cref="M:Gtk.Menu.Popup"/>.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Delegate</BaseTypeName>
@@ -32,4 +32,4 @@
   <ReturnValue>
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/MenuShell.xml b/doc/en/Gtk/MenuShell.xml
index 04e316d04..c1729d0c1 100644
--- a/doc/en/Gtk/MenuShell.xml
+++ b/doc/en/Gtk/MenuShell.xml
@@ -264,9 +264,15 @@
         <Parameter Name="search_sensitive" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Select the first visible or selectable child of the menu shell;
+	  don't select tearoff items unless the only item is a tearoff item.
+	</summary>
         <param name="search_sensitive">a <see cref="T:System.Boolean" /></param>
-        <remarks>To be added</remarks>
+        <remarks>If <paramref name="search_sensitive"/> is  true, 
+	  search for the first selectable menu item, otherwise select nothing if
+	  the first item isn't sensitive. This  should be false if the 
+	  menu is being popped up initially.
+	</remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -368,10 +374,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Protected constructor.</summary>
         <returns>a <see cref="T:Gtk.MenuShell" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>