Clarify documentation for selection modes. (#154188, Jonathan Blandford,

2004-10-06  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkenums.sgml: Clarify documentation for selection
	modes.  (#154188, Jonathan Blandford, new wording proposed by
	Owen Taylor)

docs/reference/ChangeLog

+2004-10-06  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkenums.sgml: Clarify documentation for selection
+	modes.  (#154188, Jonathan Blandford, new wording proposed by
+	Owen Taylor)
+
 2004-10-05  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtk-sections.txt: Add gtk_accelerator_get_label().

docs/reference/gtk/tmpl/gtkenums.sgml

@@ -332,20 +332,22 @@ Indicated the relief to be drawn around a #GtkButton.
 
 <!-- ##### ENUM GtkSelectionMode ##### -->
 <para>
-
+Used to control what selections users are allowed to make.
 </para>
 
 @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_BROWSE: Exactly one element is selected. In some circumstances,
+  such as initially or during a search operation, it's possible for no element 
+  to be selected with %GTK_SELECTION_BROWSE. What is really enforced is that 
+  the user can't deselect a currently selected element except by selecting 
+  another element.
 @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.
+@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to %GTK_SELECTION_MULTIPLE.
 
 <!-- ##### ENUM GtkShadowType ##### -->
 <para>