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

@@ -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

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">

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>
+</Type>

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>
+</Type>

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>
+</Type>

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>
+</Type>