From 1fe2785b28c8f31a9c46043ffd0ab764e47a5228 Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Wed, 21 Apr 2004 20:46:56 +0000
Subject: [PATCH] Some of my contributions

svn path=/trunk/gtk-sharp/; revision=25794
---
 doc/en/Gdk/Bitmap.xml       |  2 +-
 doc/en/Gtk/AccelLabel.xml   | 12 +++++-----
 doc/en/Gtk/DrawingArea.xml  |  2 +-
 doc/en/Gtk/ThreadNotify.xml | 44 ++++++++++++++++++++++++++++++-------
 4 files changed, 44 insertions(+), 16 deletions(-)

diff --git a/doc/en/Gdk/Bitmap.xml b/doc/en/Gdk/Bitmap.xml
index 746f9edfc..2cf51b808 100644
--- a/doc/en/Gdk/Bitmap.xml
+++ b/doc/en/Gdk/Bitmap.xml
@@ -10,7 +10,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>This represents an X server  bitmap.</summary>
     <remarks>To be added</remarks>
   </Docs>
   <Base>
diff --git a/doc/en/Gtk/AccelLabel.xml b/doc/en/Gtk/AccelLabel.xml
index 0bc96fa66..b46e0b030 100644
--- a/doc/en/Gtk/AccelLabel.xml
+++ b/doc/en/Gtk/AccelLabel.xml
@@ -10,7 +10,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>A widget that displays an accelerator key</summary>
+    <summary>A widget that displays an accelerator key on the right of the text.</summary>
     <remarks>
       <para>
       The <see cref="T:Gtk.AccelLabel" /> widget is a subclass of <see cref="T:Gtk.Label" /> that also displays an accelerator key on the right of the label text. The <see cref="T:Gtk.AccelLabel" /> widget is commonly used in menus to show the keyboard shortcuts for commands.
@@ -93,9 +93,9 @@
         <Parameter Name="str1ng" Type="System.String" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="str1ng">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Gtk.AccelLabel'</returns>
+        <summary>Creates an accelerator label.</summary>
+        <param name="str1ng">The accelerator label.</param>
+        <returns />
         <remarks>To be added</remarks>
       </Docs>
     </Member>
@@ -174,9 +174,9 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>The GLib Type assigned to this class.</summary>
         <returns>a <see cref="T:GLib.GType" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>Used internally.</remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
diff --git a/doc/en/Gtk/DrawingArea.xml b/doc/en/Gtk/DrawingArea.xml
index 52e941873..40334438e 100644
--- a/doc/en/Gtk/DrawingArea.xml
+++ b/doc/en/Gtk/DrawingArea.xml
@@ -79,7 +79,7 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>Constructor.</summary>
+        <summary>Default Constructor.</summary>
         <returns>An instance of <see cref="T:Gtk.DrawingArea" />.</returns>
         <remarks />
       </Docs>
diff --git a/doc/en/Gtk/ThreadNotify.xml b/doc/en/Gtk/ThreadNotify.xml
index fd8254c51..df20e1a39 100644
--- a/doc/en/Gtk/ThreadNotify.xml
+++ b/doc/en/Gtk/ThreadNotify.xml
@@ -10,8 +10,36 @@
   </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>Multi-threaded integration with Gtk support.</summary>
+    <remarks>
+      <para>The ThreadNotify class is used to invoke methods in the Gtk+ thread.  Since Gtk is not a thread-safe toolkit, only a single thread at a time might be making calls into Gtk.</para>
+      <para>Typically applications will be executing the main Gtk+ main loop and when threads are done processing work, they invoke <see cref="M:Gtk.ThreadNotify.WakeupMain()" /> to invoke a method on the main Gtk+ thread.</para>
+      <example>
+        <code lang="C#">
+using Gtk;
+
+class Demo {
+  static void Main ()
+  {
+    Application.Init ();
+    notify = new ThreadNotify (new ReadyEvent (ready));
+    Application.Run ();
+  }
+
+  static void ready ()
+  {
+    // Update the GUI with computation values.
+  }
+
+  static void ThreadRoutine ()
+  {
+	LargeComputation ();
+        notify.WakeupMain ();
+  }
+}
+  </code>
+      </example>
+    </remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -27,8 +55,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Wakeup the main thread, and invoke delegate.</summary>
+        <remarks>This methods wakes up the Gtk+ main thread and executes the delegate that was specified at construction time in the Gtk+ thread.   </remarks>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -39,10 +67,10 @@
         <Parameter Name="re" Type="Gtk.ReadyEvent" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="re">To be added: an object of type 'Gtk.ReadyEvent'</param>
-        <returns>To be added: an object of type 'Gtk.ThreadNotify'</returns>
-        <remarks>To be added</remarks>
+        <summary>ThreadNotify constructor</summary>
+        <param name="re">A ReadyEvent delegate.</param>
+        <returns>Constructed object.</returns>
+        <remarks>The method referenced by the delegate will be invoked on the Gtk+ mainloop whenever any thread invokes the <see cref="M:Gtk.ThreadNotify.WakeupMain ()" /> method.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Close">