diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 716f8114ce..3579fe24de 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2004-05-11  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkenums.sgml: Document the selection modes here,
+	rather than in the docs of deprecated list widgets.
+
 Tue May 11 00:29:53 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/tmpl/gtkpixmap.sgml: 
diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml
index 466508f5c3..c37882d0f2 100644
--- a/docs/reference/gtk/tmpl/gtkenums.sgml
+++ b/docs/reference/gtk/tmpl/gtkenums.sgml
@@ -335,11 +335,17 @@ Indicated the relief to be drawn around a #GtkButton.
 
 </para>
 
-@GTK_SELECTION_NONE: 
-@GTK_SELECTION_SINGLE: 
-@GTK_SELECTION_BROWSE: 
-@GTK_SELECTION_MULTIPLE: 
-@GTK_SELECTION_EXTENDED: 
+@GTK_SELECTION_NONE: No selection is possible.
+@GTK_SELECTION_SINGLE: Zero or one element may be selected. 
+@GTK_SELECTION_BROWSE: Exactly one element is always selected 
+   (this can be false after you have changed the selection mode).
+@GTK_SELECTION_MULTIPLE: Any number of elements may be selected. 
+   Clicks toggle the state of an item. Any number of elements may be selected. 
+   Click-drag selects a range of elements; the Ctrl key may be used to enlarge 
+   the selection, and Shift key to select between the focus and the child 
+   pointed to. 
+@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to 
+   %GTK_SELECTION_MULTIPLE.
 
 <!-- ##### ENUM GtkShadowType ##### -->
 <para>