From 5f1c7a56dd600eaed484349bd6cb8b974cf8ae96 Mon Sep 17 00:00:00 2001
From: Miguel de Icaza <miguel@gnome.org>
Date: Tue, 31 Jan 2006 02:50:11 +0000
Subject: [PATCH] Patch from Michal Dominik

svn path=/trunk/gtk-sharp/; revision=56307
---
 doc/en/Gtk/Grab.xml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/en/Gtk/Grab.xml b/doc/en/Gtk/Grab.xml
index f46b89b50..13b69108a 100644
--- a/doc/en/Gtk/Grab.xml
+++ b/doc/en/Gtk/Grab.xml
@@ -8,7 +8,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>Represents a Grab--- the part of a widget that can be dragged with the mouse.</summary>
+    <summary>Grab methods allow you to limit the keyboard and mouse interaction to a particular widget or window.</summary>
     <remarks />
   </Docs>
   <Base>
@@ -26,8 +26,8 @@
         <Parameter Name="widget" Type="Gtk.Widget" />
       </Parameters>
       <Docs>
-        <summary>Adds a Grab to the widget.</summary>
-        <param name="widget">a <see cref="T:Gtk.Widget" /></param>
+        <summary>Makes the specified widget the currently grabbed widget. This means that interaction with other widgets in the same application is blocked and mouse as well as keyboard events are delivered to this widget.</summary>
+        <param name="widget">The <see cref="T:Gtk.Widget" /> that grabs keyboard and pointer events.</param>
         <remarks />
       </Docs>
     </Member>
@@ -41,8 +41,8 @@
         <Parameter Name="widget" Type="Gtk.Widget" />
       </Parameters>
       <Docs>
-        <summary>Removes a Grab from the widget.</summary>
-        <param name="widget">a <see cref="T:Gtk.Widget" /></param>
+        <summary>Removes the grab from the given widget. You have to pair calls to <see cref="T:Gtk.Grab.Add" /> and <see cref="T:Gtk.Grab.Remove" />.</summary>
+        <param name="widget">The <see cref="T:Gtk.Widget" /> which gives up the grab.</param>
         <remarks />
       </Docs>
     </Member>
@@ -52,7 +52,7 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>Basic constructor.</summary>
+        <summary>Don't use.</summary>
         <remarks />
       </Docs>
     </Member>
@@ -63,10 +63,10 @@
         <ReturnType>Gtk.Widget</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the current Widget for this Grab object.</summary>
-        <value>a <see cref="T:Gtk.Widget" /></value>
+        <summary>Queries the current grab of the default window group.</summary>
+        <value>A <see cref="T:Gtk.Widget" /> which currently has the grab or <see langword="null" /> if no grab is active.</value>
         <remarks />
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
\ No newline at end of file