[gtk+] docs: Add docs about how to get a GtkDevice

[Javier Jardón <jjardon src gnome org>]

commit 30cdab13fe62884457b7c1c35142386e453adfd0
Author: Javier Jardón <jjardon gnome org>
Date:   Fri Dec 24 14:39:55 2010 +0100

    docs: Add docs about how to get a GtkDevice
    
    Fixes https://bugzilla.gnome.org/show_bug.cgi?id=637895

 gdk/gdkdevice.c |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)
---
diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c
index cc375d7..54cb7fa 100644
--- a/gdk/gdkdevice.c
+++ b/gdk/gdkdevice.c
@@ -1044,7 +1044,10 @@ get_native_grab_event_mask (GdkEventMask grab_mask)
 
 /**
  * gdk_device_grab:
- * @device: a #GdkDevice
+ * @device: a #GdkDevice. To get the device you can use gtk_get_current_event_device()
+ *   or gdk_event_get_device() if the grab is in reaction to an event. Also, you can use
+ *   gdk_device_manager_get_client_pointer() but only in code that isn't triggered by a
+ *   #GdkEvent and there aren't other means to get a meaningful #GdkDevice to operate on.
  * @window: the #GdkWindow which will own the grab (the grab window)
  * @grab_ownership: specifies the grab ownership.
  * @owner_events: if %FALSE then all device events are reported with respect to