[gtk+] docs: Add note about hot_x/y in gtk_drag_set_icon_surface()

[Benjamin Otte <otte src gnome org>]

commit 7acb4d0502be5b2abbdb0205f7a458181819b964
Author: Benjamin Otte <otte redhat com>
Date:   Thu Sep 30 13:54:20 2010 +0200

    docs: Add note about hot_x/y in gtk_drag_set_icon_surface()

 gtk/gtkdnd.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index 7ee4894..c7f470c 100644
--- a/gtk/gtkdnd.c
+++ b/gtk/gtkdnd.c
@@ -3248,6 +3248,11 @@ _gtk_cairo_surface_extents (cairo_surface_t *surface,
  * Sets @surface as the icon for a given drag. GTK+ retains
  * references for the arguments, and will release them when
  * they are no longer needed.
+ *
+ * To position the surface realtive to the mouse, use
+ * cairo_surface_set_device_offset() on @usrface. The mouse
+ * cursor will be positioned at the (0,0) coordinate of the
+ * surface.
  **/
 void 
 gtk_drag_set_icon_surface (GdkDragContext    *context,