[gtk+/wip/baseline2] Document GtkBaselinePosition

[Alexander Larsson <alexl src gnome org>]

commit 4034a132636216731b3fd4b687f09dce36171f24
Author: Alexander Larsson <alexl redhat com>
Date:   Tue Mar 26 15:41:45 2013 +0100

    Document GtkBaselinePosition

 gtk/gtkenums.h |   14 +++++++++++---
 1 files changed, 11 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index 0ca62d2..82f5a0a 100644
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -133,10 +133,18 @@ typedef enum
 
 /**
  * GtkBaselinePosition:
- * @GTK_BASELINE_POSITION_TOP:
- * @GTK_BASELINE_POSITION_CENTER:
- * @GTK_BASELINE_POSITION_BOTTOM:
+ * @GTK_BASELINE_POSITION_TOP: Align the baseline at the top
+ * @GTK_BASELINE_POSITION_CENTER: Center the baseline
+ * @GTK_BASELINE_POSITION_BOTTOM: Align the baseline at the bottom
  *
+ * Whenever a container has some form of natural row it may align
+ * children in that row along a common typographical baseline. If
+ * the amount of verical space in the row is taller than the total
+ * requested height of the baseline-aligned children then it can use a
+ * #GtkBaselinePosition to select where to put the baseline inside the
+ * extra availible space.
+ *
+ * Since: 3.10
  */
 typedef enum
 {