From 41c578d85a23fea2d889e953e81736c1fd0e4c47 Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Sat, 26 Jun 2004 23:32:38 +0000
Subject: [PATCH] New from jluke

svn path=/trunk/gtk-sharp/; revision=30451
---
 doc/en/Gtk/Gc.xml     |  4 ++--
 doc/en/Gtk/Global.xml | 23 ++++++++++++++++++-----
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/doc/en/Gtk/Gc.xml b/doc/en/Gtk/Gc.xml
index 3941e23cd..63684ef29 100644
--- a/doc/en/Gtk/Gc.xml
+++ b/doc/en/Gtk/Gc.xml
@@ -29,7 +29,7 @@
         <Parameter Name="gc" Type="Gdk.GC" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Releases the <see cref="T:Gdk.GC" /> that is passed in.</summary>
         <param name="gc">a <see cref="T:Gdk.GC" /></param>
         <remarks>To be added</remarks>
       </Docs>
@@ -47,7 +47,7 @@
         <Parameter Name="values_mask" Type="Gdk.GCValuesMask" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Returns a <see cref="T:Gdk.GC" /> with the specified values.</summary>
         <param name="depth">a <see cref="T:System.Int32" /></param>
         <param name="colormap">a <see cref="T:Gdk.Colormap" /></param>
         <param name="values">a <see cref="T:Gdk.GCValues" /></param>
diff --git a/doc/en/Gtk/Global.xml b/doc/en/Gtk/Global.xml
index 1d2a0d2b9..9b36e77c9 100644
--- a/doc/en/Gtk/Global.xml
+++ b/doc/en/Gtk/Global.xml
@@ -149,9 +149,9 @@
         <ReturnType>Gdk.Event</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Obtains a copy of the event currently being processed by Gtk#.</summary>
         <returns>a <see cref="T:Gdk.Event" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>For example, if you get a <see cref="E:Gtk.Button.Clicked" /> event from <see cref="T:Gtk.Button" />, the current event will be the <see cref="T:Gdk.EventButton" /> that triggered the <see cref="E:Gtk.Button.Clicked" /> signal.  If there is no current event, the function returns <see langword="null" />.</remarks>
       </Docs>
     </Member>
     <Member MemberName="CurrentEventTime">
@@ -161,7 +161,7 @@
         <ReturnType>System.UInt32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Returns a uint representing the unix time of the current event.</summary>
+        <summary>Returns a <see cref="T:System.UInt32" /> representing the unix time of the current event.</summary>
         <returns>Returns the unix time for the current event.</returns>
         <remarks>None.</remarks>
       </Docs>
@@ -319,9 +319,22 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
+        <summary>Checks if any events are pending.</summary>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks>This can be used to update the GUI and invoke timeouts etc. while doing some time intensive computation.
+
+<example>
+            <code lang="C#">
+	/* computation going on */
+...
+        while (Gtk.Global.EventsPending)
+	{
+	  Gtk.Application.RunIteration ();
+	}
+...
+	/* computation continued */
+  </code>
+          </example></remarks>
       </Docs>
     </Member>
     <Member MemberName="TypeClass">