From 4c5107d7f729181e84c1ff0bbb5434bf8f7d4a93 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Fri, 31 Dec 2004 20:09:02 +0000
Subject: [PATCH] 2004-12-31  Shane Landrum  <epicene@pobox.com>

	* en/Gtk/ArgFlags.xml
	* en/Gtk/Arg.xml: Added "Do not use" marks.
	* en/Gtk/Action.xml
	* en/Gtk/AddWidgetArgs.xml
	* en/Gtk/Alignment.xml
	* en/Gtk/AccelGroup.xml: Added docs

svn path=/trunk/gtk-sharp/; revision=38219
---
 doc/ChangeLog                |  9 ++++++++
 doc/en/Gtk/AccelGroup.xml    |  2 +-
 doc/en/Gtk/Action.xml        |  2 +-
 doc/en/Gtk/AddWidgetArgs.xml |  6 +++---
 doc/en/Gtk/Alignment.xml     | 41 ++++++++++++++++++++++++------------
 doc/en/Gtk/Arg.xml           | 20 +++++++++---------
 doc/en/Gtk/ArgFlags.xml      | 22 +++++++++----------
 7 files changed, 63 insertions(+), 39 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index c2710a831..6f1c2f7c2 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,12 @@
+2004-12-31  Shane Landrum  <epicene@pobox.com>
+
+	* en/Gtk/ArgFlags.xml
+	* en/Gtk/Arg.xml: Added "Do not use" marks.
+	* en/Gtk/Action.xml
+	* en/Gtk/AddWidgetArgs.xml
+	* en/Gtk/Alignment.xml
+	* en/Gtk/AccelGroup.xml: Added docs
+
 2004-12-31  Shane Landrum  <epicene@pobox.com>
 	
 	* en/Gtk/FileSystem.xml: Wording tweak.
diff --git a/doc/en/Gtk/AccelGroup.xml b/doc/en/Gtk/AccelGroup.xml
index 8f2e3807b..ddf9a5c31 100644
--- a/doc/en/Gtk/AccelGroup.xml
+++ b/doc/en/Gtk/AccelGroup.xml
@@ -103,7 +103,7 @@
       <Docs>
         <summary>Installs an accelerator in this group, using an
         accelerator path to look up the appropriate key and modifiers
-        (see 'gtk_accel_map_add_entry'). When the
+        (see <see cref="M:Gtk.AccelMap.AddEntry"/>). When the
         group is being activated in response to a call to <see cref="M:Gtk.AccelGroup.Activate" />, <paramref name="closure" /> will be invoked if the accel_key and
         accel_mods from <see cref="M:Gtk.AccelGroup.Activate" />
         match the key and modifiers for the path.</summary>
diff --git a/doc/en/Gtk/Action.xml b/doc/en/Gtk/Action.xml
index 33a8bbbb6..b582dc047 100644
--- a/doc/en/Gtk/Action.xml
+++ b/doc/en/Gtk/Action.xml
@@ -540,7 +540,7 @@ This does not necessarily mean effective visibility. See <see cref="P:Gtk.Action
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Event fired when this action is activated.</summary>
         <remarks></remarks>
       </Docs>
     </Member>
diff --git a/doc/en/Gtk/AddWidgetArgs.xml b/doc/en/Gtk/AddWidgetArgs.xml
index 429c87713..538515edf 100644
--- a/doc/en/Gtk/AddWidgetArgs.xml
+++ b/doc/en/Gtk/AddWidgetArgs.xml
@@ -39,10 +39,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The widget (menubar or toolbar) that was added to the UI.</summary>
         <returns>a <see cref="T:Gtk.Widget" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Alignment.xml b/doc/en/Gtk/Alignment.xml
index 2144fae09..3bc67251b 100644
--- a/doc/en/Gtk/Alignment.xml
+++ b/doc/en/Gtk/Alignment.xml
@@ -211,9 +211,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The padding to insert at the left of the child widget.</summary>
         <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="BottomPadding">
@@ -224,9 +224,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The padding to insert at the bottom of the child widget.</summary>
         <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="TopPadding">
@@ -237,9 +237,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The padding to insert at the top of the child widget.</summary>
         <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="RightPadding">
@@ -250,9 +250,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The padding to insert at the right of the child widget.</summary>
         <returns>a <see cref="T:System.UInt32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GetPadding">
@@ -268,12 +268,15 @@
         <Parameter Name="padding_right" Type="System.UInt32&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	  Gets the padding on the different sides of the widget.
+	</summary>
         <param name="padding_top">a <see cref="T:System.UInt32" /></param>
         <param name="padding_bottom">a <see cref="T:System.UInt32" /></param>
         <param name="padding_left">a <see cref="T:System.UInt32" /></param>
         <param name="padding_right">a <see cref="T:System.UInt32" /></param>
-        <remarks>To be added</remarks>
+        <remarks>This is a convenience method.
+	  See also <see cref="M:Gtk.Alignment.SetPadding"/>.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetPadding">
@@ -289,13 +292,25 @@
         <Parameter Name="padding_right" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>
+	Sets the padding on the different sides of the widget.
+	</summary>
         <param name="padding_top">a <see cref="T:System.UInt32" /></param>
         <param name="padding_bottom">a <see cref="T:System.UInt32" /></param>
         <param name="padding_left">a <see cref="T:System.UInt32" /></param>
         <param name="padding_right">a <see cref="T:System.UInt32" /></param>
-        <remarks>To be added</remarks>
+        <remarks>
+	  <para>
+	    The padding adds blank space to the vertical or horizontal sides 
+	    of the widget. For instance, this can be used to indent the child 
+	    widget towards the right by adding padding on the left.
+	  </para>
+	  <para>
+	    This is a convenience method; the properties can also
+	    be set directly.
+	  </para>
+	</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/Arg.xml b/doc/en/Gtk/Arg.xml
index ee7c0869c..8ef081b08 100644
--- a/doc/en/Gtk/Arg.xml
+++ b/doc/en/Gtk/Arg.xml
@@ -32,8 +32,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Type">
@@ -45,8 +45,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -58,8 +58,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="CharData">
@@ -71,8 +71,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -85,10 +85,10 @@
         <Parameter Name="raw" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Do not use.</summary>
         <param name="raw">a <see cref="T:System.IntPtr" /></param>
         <returns>a <see cref="T:Gtk.Arg" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gtk/ArgFlags.xml b/doc/en/Gtk/ArgFlags.xml
index 40918769a..8e8d2b19b 100644
--- a/doc/en/Gtk/ArgFlags.xml
+++ b/doc/en/Gtk/ArgFlags.xml
@@ -9,7 +9,7 @@
   </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>
+    <summary>Do not use.</summary>
     <remarks>
     </remarks>
   </Docs>
@@ -55,8 +55,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Writable">
@@ -68,8 +68,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="Construct">
@@ -81,8 +81,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ConstructOnly">
@@ -94,8 +94,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="ChildArg">
@@ -107,8 +107,8 @@
       <Parameters>
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Do not use.</summary>
+        <remarks></remarks>
       </Docs>
     </Member>
   </Members>