Docs the fact that setting selection programmatically does not fire events.
Issue: 689
Patch by: jgw
Review by: rdayal


git-svn-id: https://google-web-toolkit.googlecode.com/svn/trunk@1144 8db76d5a-ed1c-0410-87a9-c151d255dfc7

user/src/com/google/gwt/user/client/ui/ListBox.java

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 d26b083..6c5c5c8 100644
--- a/user/src/com/google/gwt/user/client/ui/ListBox.java
+++ b/user/src/com/google/gwt/user/client/ui/ListBox.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2006 Google Inc.
+ * Copyright 2007 Google Inc.
  * 
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy of
@@ -240,6 +240,11 @@
   /**
    * Sets whether an individual list item is selected.
    * 
+   * <p>
+   * Note that setting the selection programmatically does <em>not</em> cause
+   * the {@link ChangeListener#onChange(Widget)} event to be fired.
+   * </p>
+   * 
    * @param index the index of the item to be selected or unselected
    * @param selected <code>true</code> to select the item
    */
@@ -285,6 +290,11 @@
   /**
    * Sets the currently selected index.
    * 
+   * <p>
+   * Note that setting the selected index programmatically does <em>not</em>
+   * cause the {@link ChangeListener#onChange(Widget)} event to be fired.
+   * </p>
+   * 
    * @param index the index of the item to be selected
    */
   public void setSelectedIndex(int index) {