From 7c6f78cff15d666ce15c8e00621e7818716b59a4 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Tue, 4 Jan 2005 02:20:03 +0000
Subject: [PATCH] 2005-01-03  Shane Landrum  <epicene@pobox.com>

	* en/Gtk/HButtonBox.xml
	* en/Gtk/Global.xml
	* en/Gtk/FontButton.xml: Add docs.


svn path=/trunk/gtk-sharp/; revision=38298
---
 doc/ChangeLog             |  6 +++++
 doc/en/Gtk/FontButton.xml | 55 +++++++++++++++++++++------------------
 doc/en/Gtk/Global.xml     | 18 ++++++-------
 doc/en/Gtk/HButtonBox.xml | 10 +++----
 4 files changed, 49 insertions(+), 40 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 975707ebd..97af708d1 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2005-01-03  Shane Landrum  <epicene@pobox.com>
+
+	* en/Gtk/HButtonBox.xml
+	* en/Gtk/Global.xml
+	* en/Gtk/FontButton.xml: Add docs.
+	
 2005-01-03  Mike Kestner  <mkestner@novell.com>
 	
 	* en/Gtk/TreeNodeAttribute.xml : document ListOnly and add example.
diff --git a/doc/en/Gtk/FontButton.xml b/doc/en/Gtk/FontButton.xml
index 8eeed0c5e..b1b6c1d5c 100644
--- a/doc/en/Gtk/FontButton.xml
+++ b/doc/en/Gtk/FontButton.xml
@@ -9,8 +9,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 button to launch a font selection dialog.</summary>
+    <remarks></remarks>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.Button</BaseTypeName>
@@ -87,9 +87,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Public constructor.</summary>
         <returns>a <see cref="T:Gtk.FontButton" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -100,10 +100,10 @@
         <Parameter Name="fontname" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="fontname">a <see cref="T:System.String" /></param>
+        <summary>Public constructor with a font name.</summary>
+        <param name="fontname">a <see cref="T:System.String" />, name of font to display in font selection dialog.</param>
         <returns>a <see cref="T:Gtk.FontButton" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -127,9 +127,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>If this property is <see langword="true"/>, the font size will be displayed along with the name of the selected font.</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="UseSize">
@@ -140,9 +140,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	  If this property is set to <see langword="true"/>, the selected font size will be shown in the label. 
+	</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>For a more WYSIWYG way to show the selected size, see the <see cref="P:Gtk.FontButton.UseSize"/> property.</remarks>
       </Docs>
     </Member>
     <Member MemberName="FontName">
@@ -153,9 +155,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Retrieves the name of the currently selected font.</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="UseFont">
@@ -166,9 +168,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Whether the label is drawn in the selected font.</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Title">
@@ -179,9 +181,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The title of the font dialog.</summary>
         <returns>a <see cref="T:System.String" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ShowStyle">
@@ -192,9 +194,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns whether the name of the font style will be shown in the label.</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="FontSet">
@@ -205,8 +207,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Event fired when the font is set.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="SetFontName">
@@ -219,11 +221,12 @@
         <Parameter Name="fontname" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="fontname">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <summary>Sets or updates the currently-displayed font in font picker dialog.</summary>
+        <param name="fontname">a <see cref="T:System.String" />, name of font to display in font selection dialog</param>
+        <returns>A string containing the font name if the
+	  font selection dialog exists, otherwise <see langword="false"/>.</returns>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Global.xml b/doc/en/Gtk/Global.xml
index 73a58ac49..5e52a8dcc 100644
--- a/doc/en/Gtk/Global.xml
+++ b/doc/en/Gtk/Global.xml
@@ -253,17 +253,17 @@
         <Parameter Name="str1ng" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Deprecated. Do not use.</summary>
         <param name="style">a <see cref="T:Gtk.Style" /></param>
         <param name="window">a <see cref="T:Gdk.Window" /></param>
-        <param name="state_type">a <see cref="T:System.Int32" /></param>
-        <param name="area">a <see cref="T:Gdk.Rectangle" /></param>
-        <param name="widget">a <see cref="T:Gtk.Widget" /></param>
-        <param name="detail">a <see cref="T:System.String" /></param>
-        <param name="x">a <see cref="T:System.Int32" /></param>
-        <param name="y">a <see cref="T:System.Int32" /></param>
-        <param name="str1ng">a <see cref="T:System.String" /></param>
-        <remarks>To be added</remarks>
+        <param name="state_type">a <see cref="T:System.Int32" />, a state</param>
+        <param name="area">a <see cref="T:Gdk.Rectangle" />, a clip rectangle</param>
+        <param name="widget">a <see cref="T:Gtk.Widget" />, the widget</param>
+        <param name="detail">a <see cref="T:System.String" />, a style detail</param>
+        <param name="x">a <see cref="T:System.Int32" />, Y origin</param>
+        <param name="y">a <see cref="T:System.Int32" />, Y origin</param>
+        <param name="str1ng">a <see cref="T:System.String" />, the string to draw</param>
+        <remarks>Draws a text string on <paramref name="window"/> with the given parameters.</remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gtk/HButtonBox.xml b/doc/en/Gtk/HButtonBox.xml
index 06e6e7663..70b683a0b 100644
--- a/doc/en/Gtk/HButtonBox.xml
+++ b/doc/en/Gtk/HButtonBox.xml
@@ -109,9 +109,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The default layout style for horizontal button boxes.</summary>
         <returns>a <see cref="T:Gtk.ButtonBoxStyle" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="SpacingDefault">
@@ -122,10 +122,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The default spacing (in pixels) for horizontal button boxes.</summary>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>