From eea63d0087d7a755cab03b6ab68fcce2fdd1a677 Mon Sep 17 00:00:00 2001
From: Mike Kestner <mkestner@gmail.com>
Date: Thu, 24 Jun 2004 19:35:28 +0000
Subject: [PATCH] 2004-06-24  Mike Kestner  <mkestner@ximian.com>

	* en/GLib/Timeout.xml : finish the class and Add docs.

svn path=/trunk/gtk-sharp/; revision=30330
---
 doc/ChangeLog             |  4 ++++
 doc/en/GLib/Timeout.xml   | 20 +++++++++++++-------
 doc/en/Gtk/VScrollbar.xml |  4 ++--
 3 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a1ca18d91..0e8a192d2 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2004-06-24  Mike Kestner  <mkestner@ximian.com>
+
+	* en/GLib/Timeout.xml : finish the class and Add docs.
+
 2004-06-24  Mike Kestner  <mkestner@ximian.com>
 
 	* en/*/*.xml : add back the enumtype Value__ fields with "Do not use"
diff --git a/doc/en/GLib/Timeout.xml b/doc/en/GLib/Timeout.xml
index 167c17a33..ca1b7fd5b 100644
--- a/doc/en/GLib/Timeout.xml
+++ b/doc/en/GLib/Timeout.xml
@@ -11,8 +11,7 @@
   <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>Allows the installation of Timeout Handlers on the GLib main loop.</summary>
-    <remarks>
-    </remarks>
+    <remarks>Use the <see cref="M:GLib.Timeout.Add" /> method to install timeout handlers into the mainloop.</remarks>
   </Docs>
   <Base>
     <BaseTypeName>System.Object</BaseTypeName>
@@ -31,11 +30,18 @@
         <Parameter Name="hndlr" Type="GLib.TimeoutHandler" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="interval">an object of type <see cref="T:System.UInt32" /></param>
-        <param name="hndlr">an object of type <see cref="T:GLib.TimeoutHandler" /></param>
-        <returns>an object of type 'uint'</returns>
-        <remarks>To be added</remarks>
+        <summary>Adds a <see cref="T:GLib.TimeoutHandler" /> delegate to the mainloop.  </summary>
+        <param name="interval">the interval in milliseconds between invocations of <paramref name="hndlr" />.</param>
+        <param name="hndlr">a delegate of type <see cref="T:GLib.TimeoutHandler" /> to invoke every <paramref name="interval" />.</param>
+        <returns>an id representing the event source of the installed timeout handler.</returns>
+        <remarks>
+          <para>
+The delegate is invoked after the time period specified by <paramref name="interval" />. The delegate is invoked repeatedly until it returns <see langword="false" />.
+</para>
+          <para>
+Invocation of the delegate may be delayed by other event processing, so this mechanism cannot be depended on for accurate timing. The interval to the next timeout is calculated at completion of the preceding timeout. There is no attempt made to "catch up" if an invocation is delayed.
+</para>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/doc/en/Gtk/VScrollbar.xml b/doc/en/Gtk/VScrollbar.xml
index 652f648bf..bf83cef4a 100644
--- a/doc/en/Gtk/VScrollbar.xml
+++ b/doc/en/Gtk/VScrollbar.xml
@@ -74,7 +74,7 @@
         <summary>Creates a new vertical scrollbar.</summary>
         <param name="adjustment">The <see cref="T:Gtk.Adjustment" /> to use, or <see langword="null" /> to create a new adjustment.</param>
         <returns>The new <see cref="T:Gtk.VScrollbar" /></returns>
-        <remarks>To be added</remarks>
+        <remarks></remarks>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -105,4 +105,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>