From 05172d9599b10eb24d84586eecc4d330800b936c Mon Sep 17 00:00:00 2001
From: Duncan Mak <duncan@mono-cvs.ximian.com>
Date: Tue, 22 Jul 2003 04:38:13 +0000
Subject: [PATCH] * en/Gtk/FSButton.xml: Removed the constructor, per the
 custom file update and added documentation.

* gtk/FileSelection.custom (FSButton): Mark the constructor as
'internal', instead of 'public'.

svn path=/trunk/gtk-sharp/; revision=16513
---
 ChangeLog                |  5 +++++
 doc/ChangeLog            |  5 +++++
 doc/en/Gtk/FSButton.xml  | 47 ++++++++++++++++++++--------------------
 gtk/FileSelection.custom |  2 +-
 4 files changed, 35 insertions(+), 24 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a57c49f03..f9096e161 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2003-07-22  Duncan Mak  <duncan@ximian.com>
+
+	* gtk/FileSelection.custom (FSButton): Mark the constructor as
+	'internal', instead of 'public'.
+
 2003-07-15  Duncan Mak  <duncan@ximian.com>
 
 	* sources/makefile (get-source-code): make it go a bit faster by
diff --git a/doc/ChangeLog b/doc/ChangeLog
index e56eda42f..e40e9358c 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2003-07-22  Duncan Mak  <duncan@ximian.com>
+
+	* en/Gtk/FSButton.xml: Removed the constructor, per the custom
+	file update and added documentation.
+
 2003-07-20  John Luke  <jluke@cfl.rr.com>
 
 	* en/Gtk/FileSelection.xml: update and add example
diff --git a/doc/en/Gtk/FSButton.xml b/doc/en/Gtk/FSButton.xml
index 3bd6f7a5e..fe5a24ae9 100644
--- a/doc/en/Gtk/FSButton.xml
+++ b/doc/en/Gtk/FSButton.xml
@@ -1,5 +1,5 @@
 <Type Name="FSButton" FullName="Gtk.FileSelection+FSButton">
-  <TypeSignature Language="C#" Value="public class FSButton : Gtk.Button, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="auto" />
+  <TypeSignature Language="C#" Value="public class FSButton : Gtk.Button, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="duncan" />
   <AssemblyInfo>
     <AssemblyName>gtk-sharp</AssemblyName>
     <AssemblyPublicKey />
@@ -9,8 +9,17 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>To be added</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>
+      Helper class for <see cref="T:Gtk.Button" />s embedded inside a <see cref="T:Gtk.FileSelection" />
+    </summary>
+    <remarks>
+      <para>
+        This class is used as a wrapper around buttons embedded inside
+        a  <see cref="T:Gtk.FileSelection" />. This class exposes an
+        additional property, <see cref="T:Gtk.FileSelection+FSButton.FileSelection" />, which
+        can be used to get back to the parent <see cref="T:Gtk.FileSelection" /> dialog.
+      </para>
+    </remarks>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.Button</BaseTypeName>
@@ -31,22 +40,6 @@
   </Interfaces>
   <Attributes />
   <Members>
-    <Member MemberName=".ctor">
-      <MemberSignature Language="C#" Value="public FSButton (Gtk.FileSelection fs, IntPtr raw);" />
-      <MemberType>Constructor</MemberType>
-      <ReturnValue />
-      <Parameters>
-		<Parameter Name="fs" Type="Gtk.FileSelection" />
-		<Parameter Name="raw" Type="System.IntPtr" />
-	</Parameters>
-      <Docs>
-        <summary>To be added</summary>
-        <param name="fs">To be added: an object of type 'Gtk.FileSelection'</param>
-        <param name="raw">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'Gtk.FileSelection+FSButton'</returns>
-        <remarks>To be added</remarks>
-      </Docs>
-    </Member>
     <Member MemberName="FileSelection">
       <MemberSignature Language="C#" Value="public Gtk.FileSelection FileSelection { get; };" />
       <MemberType>Property</MemberType>
@@ -54,10 +47,18 @@
         <ReturnType>Gtk.FileSelection</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.FileSelection'</returns>
-        <remarks>To be added</remarks>
+        <summary>Returns the parent <see cref="T:Gtk.FileSelection" /></summary>
+        <returns>The parent <see cref="T:Gtk.FileSelection" /></returns>
+        <remarks>
+          <para>
+            This class is only used to by
+            <see cref="T:Gtk.Button"/>s embedded inside a
+            <see cref="T:Gtk.FileSelection" />. From the
+            <see cref="P:Gtk.FileSelection.OKButton" />, you can use
+            this property to get back to the parent dialog box.
+          </para>
+        </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file
diff --git a/gtk/FileSelection.custom b/gtk/FileSelection.custom
index 8d7044610..37c5d430e 100644
--- a/gtk/FileSelection.custom
+++ b/gtk/FileSelection.custom
@@ -16,7 +16,7 @@ public class FSButton : Gtk.Button {
 		get { return file_sel; }
 	}
 
-	public FSButton (FileSelection fs, IntPtr raw) : base (raw) {
+        internal FSButton (FileSelection fs, IntPtr raw) : base (raw) {
 		file_sel = fs;
 	}
 }