[gtk+] [docs] Added some missing documentation to GdkDnd

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

commit b618ca8923ec5b932b18313e1a8dad933d5bbdaa
Author: Javier Jardón <jjardon gnome org>
Date:   Wed Jun 9 06:33:10 2010 +0200

    [docs] Added some missing documentation to GdkDnd
    
    The docs was removed by error in commit
    9399114802846a3878ff3f8d818bd18664285cf4

 docs/reference/gdk/tmpl/.gitignore |    1 +
 gdk/gdkdnd.h                       |   29 +++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index 888b6a2..a3343cb 100644
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -1 +1,2 @@
+dnd.sgml
 windows.sgml
diff --git a/gdk/gdkdnd.h b/gdk/gdkdnd.h
index c6a8079..2bdf589 100644
--- a/gdk/gdkdnd.h
+++ b/gdk/gdkdnd.h
@@ -38,6 +38,21 @@ G_BEGIN_DECLS
 
 typedef struct _GdkDragContext        GdkDragContext;
 
+/**
+ * GdkDragAction:
+ * @GDK_ACTION_DEFAULT: Means nothing, and should not be used.
+ * @GDK_ACTION_COPY: Copy the data.
+ * @GDK_ACTION_MOVE: Move the data, i.e. first copy it, then delete
+ *  it from the source using the DELETE target of the X selection protocol.
+ * @GDK_ACTION_LINK: Add a link to the data. Note that this is only
+ *  useful if source and destination agree on what it means.
+ * @GDK_ACTION_PRIVATE: Special action which tells the source that the
+ *  destination will do something that the source doesn't understand.
+ * @GDK_ACTION_ASK: Ask the user what to do with the data.
+ *
+ * Used in #GdkDragContext to indicate what the destination
+ * should do with the dropped data.
+ */
 typedef enum
 {
   GDK_ACTION_DEFAULT = 1 << 0,
@@ -48,6 +63,20 @@ typedef enum
   GDK_ACTION_ASK     = 1 << 5
 } GdkDragAction;
 
+/**
+ * GdkDragProtocol:
+ * @GDK_DRAG_PROTO_MOTIF: The Motif DND protocol.
+ * @GDK_DRAG_PROTO_XDND: The Xdnd protocol.
+ * @GDK_DRAG_PROTO_ROOTWIN: An extension to the Xdnd protocol for
+ *  unclaimed root window drops.
+ * @GDK_DRAG_PROTO_NONE: no protocol.
+ * @GDK_DRAG_PROTO_WIN32_DROPFILES: The simple WM_DROPFILES protocol.
+ * @GDK_DRAG_PROTO_OLE2: The complex OLE2 DND protocol (not implemented).
+ * @GDK_DRAG_PROTO_LOCAL: Intra-application DND.
+ *
+ * Used in #GdkDragContext to indicate the protocol according to
+ * which DND is done.
+ */
 typedef enum
 {
   GDK_DRAG_PROTO_MOTIF,