Fix issue #1504. Minor documentation change which updates the ListBox setSelectedIndex(int) method javadoc comment. This method leaves the list with only a single item selected, which may not be what a developer of a mutliple-selection list expects. Added a pointer to setSelectedItem(int, boolean).
Patch by: zundel
Review by: jalbanca, rdayal
git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@1574 8db76d5a-ed1c-0410-87a9-c151d255dfc7
diff --git a/user/src/com/google/gwt/user/client/ui/ListBox.java b/user/src/com/google/gwt/user/client/ui/ListBox.java
index 8f936cf..f0401b4 100644
--- a/user/src/com/google/gwt/user/client/ui/ListBox.java
+++ b/user/src/com/google/gwt/user/client/ui/ListBox.java
@@ -386,6 +386,10 @@
/**
* Sets the currently selected index.
*
+ * After calling this method, only the specified item in the list will
+ * remain selected. For a ListBox with multiple selection enabled, see
+ * {@link #setItemSelected(int, boolean)} to select multiple items at a time.
+ *
* <p>
* Note that setting the selected index programmatically does <em>not</em>
* cause the {@link ChangeListener#onChange(Widget)} event to be fired.
