docs: add docs for GtkTargetPair

1 files changed, 23 insertions, 3 deletions

diff --git a/gtk/gtkselection.h b/gtk/gtkselection.h
index 2bc5fe0be9..af474f3eaf 100644
--- a/gtk/gtkselection.h
+++ b/gtk/gtkselection.h
@@ -34,13 +34,33 @@
 
 G_BEGIN_DECLS
 
+typedef struct _GtkTargetPair GtkTargetPair;
+
+/**
+ * GtkTargetPair:
+ * @target: #GdkAtom representation of the target type
+ * @flags: #GtkTargetFlags for DND
+ * @info: an application-assigned integer ID which will
+ *     get passed as a parameter to e.g the #GtkWidget::selection-get
+ *     signal. It allows the application to identify the target
+ *     type without extensive string compares.
+ *
+ * A #GtkTargetPair structure is used to represent the same
+ * information as a table of #GtkTargetEntry, but in
+ * an efficient form.
+ */
+struct _GtkTargetPair
+{
+  GdkAtom   target;
+  guint     flags;
+  guint     info;
+};
+
 /**
  * GtkTargetList:
  *
  * A #GtkTargetList structure is a reference counted list
- * of #GtkTargetPair. It is used to represent the same
- * information as a table of #GtkTargetEntry, but in
- * an efficient form. This structure should be treated as
+ * of #GtkTargetPair. This structure should be treated as
  * opaque.
  */
 typedef struct _GtkTargetList  GtkTargetList;