From 7b754779204e98f9dcc2114ef318afb5e2c70193 Mon Sep 17 00:00:00 2001
From: Jaime Anguiano Olarra <jaime@mono-cvs.ximian.com>
Date: Wed, 14 May 2003 12:14:31 +0000
Subject: [PATCH] Added some more info.

svn path=/trunk/gtk-sharp/; revision=14573
---
 doc/en/Gtk/Button.xml | 128 +++++++++++++++++++++++-------------------
 1 file changed, 70 insertions(+), 58 deletions(-)

diff --git a/doc/en/Gtk/Button.xml b/doc/en/Gtk/Button.xml
index e2148fe5b..74c969e28 100644
--- a/doc/en/Gtk/Button.xml
+++ b/doc/en/Gtk/Button.xml
@@ -43,9 +43,10 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'uint'</returns>
-        <remarks>To be added</remarks>
+        <summary>The GLib type for Gtk.Button.</summary>
+        <returns>The GLib type for the Gtk.Button <see
+  langword="class" />.</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="UseStock">
@@ -58,10 +59,16 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets or sets if wether the Button should use a <see
+  cref="T:Gtk.Stock" /> or not.</summary>
+        <param name="value">Boolean value to select if the
+  Button uses a <see cref="T:Gtk.Stock" /> or not.</param>
+        <returns>Gets a value indicating if the Button uses a <see
+  cref="T:Gtk.Stock" />.</returns>
+        <remarks>It's possible to create a Button from <see
+  cref="T:Gtk.Stock" />, which is recommended for consistency in Gnome
+  apps. They also provide a <see cref="T:Gtk.Label" /> and a key shortcut. 
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="UseUnderline">
@@ -74,10 +81,14 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets or sets if the Button uses or not an embedded
+  underline in the Button <see cref="T:Gtk.Label" /> indicating if a
+  mnemonic is associated to the Button.</summary>
+        <param name="value">Boolean value to select if the Button uses
+	underline or not.</param>
+        <returns>Gets a value indicating if the Button uses underline
+  or not.</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Relief">
@@ -90,10 +101,12 @@
         <Parameter Name="value" Type="Gtk.ReliefStyle" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gtk.ReliefStyle'</param>
-        <returns>To be added: an object of type 'Gtk.ReliefStyle'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets or sets the <see cref="T:Gtk.ReliefStyle" /> for the Button.</summary>
+        <param name="value">The <see cref="T:Gtk.ReliefStyle" /> for
+  the Button.</param>
+        <returns>An instance of <see cref="T:Gtk.ReliefStyle" /> that
+  represents the relief style of the Button.</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Label">
@@ -106,10 +119,13 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string'</returns>
-        <remarks>To be added</remarks>
+        <summary>Gets or sets the <see langword="string" /> used to be
+	represented with a <see cref="T:Gtk.Label" /> contained by the
+	Button.</summary>
+        <param name="value">A <see langword="string" /> to be used for
+  the Button's <see cref="T:Gtk.Label" /></param>
+        <returns>The <see langword="string" /> contained by the Button.</returns>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Activated">
@@ -118,8 +134,8 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the button is activated.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Clicked">
@@ -128,8 +144,8 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the button is clicked.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Left">
@@ -138,8 +154,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the cursor
+  leaves the button area.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Pressed">
@@ -148,8 +165,8 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the button is pressed.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Released">
@@ -158,8 +175,8 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the button is released.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="Entered">
@@ -168,8 +185,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary><see langword="event" /> launched when the cursor
+  enters the button area.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName="ActionGetType">
@@ -285,8 +303,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Disposes the resources associated with this object.</summary>
+        <remarks />
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -297,24 +315,13 @@
         <Parameter Name="gtype" Type="GLib.Type" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="gtype">To be added: an object of type 'GLib.Type'</param>
-        <returns>To be added: an object of type 'Gtk.Button'</returns>
-        <remarks>To be added</remarks>
-      </Docs>
-    </Member>
-    <Member MemberName=".ctor">
-      <MemberSignature Language="C#" Value="public Button (IntPtr raw);" />
-      <MemberType>Constructor</MemberType>
-      <ReturnValue />
-      <Parameters>
-        <Parameter Name="raw" Type="System.IntPtr" />
-      </Parameters>
-      <Docs>
-        <summary>To be added</summary>
-        <param name="raw">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'Gtk.Button'</returns>
-        <remarks>To be added</remarks>
+        <summary>Internal constructor</summary>
+        <param name="gtype">GLib type for the type.</param>
+        <returns>Creates a new instance of Button, using the GLib
+  provided type.</returns>
+        <remarks>This is a constructor used by derivative types of
+  <see cref="T:Gtk.Button" /> that would have their own GLib type
+  assigned to it. This is not typically used by C# code.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -323,9 +330,10 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.Button'</returns>
-        <remarks>To be added</remarks>
+        <summary>Default parameterless constructor.</summary>
+        <returns>An instance of type Gtk.Button.</returns>
+        <remarks>This is the default constructor for the Gtk.Button
+  <see langword="class" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -336,10 +344,14 @@
         <Parameter Name="label" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="label">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gtk.Button'</returns>
-        <remarks>To be added</remarks>
+        <summary>Constructor that creates a labeled Button. The label
+  shows the string passed as parameter.</summary>
+        <param name="label">A <see langword="string" /> that will be
+  used to create a <see cref="T:Gtk.Label" /> for the Gtk.Button</param>
+        <returns>A Gtk.Button containing a <see cref="T:Gtk.Label" />
+  with the <see langword="string">string</see> passed.</returns>
+        <remarks>Constructor that creates a labeled button. The label
+  shows the string passed as parameter.</remarks>
       </Docs>
     </Member>
   </Members>