         }
     }
     
-    /**
-     *  @private
+    //--------------------------------------------------------------------------
+    //
+    //  Event Handlers
+    //
+    //--------------------------------------------------------------------------
+    
+    /**
+     *  Called when contents within the dataProvider changes.  
+     *
+     *  @param event The collection change event
+     *  
+     *  @langversion 3.0
+     *  @playerversion Flash 10
+     *  @playerversion AIR 1.5
+     *  @productversion Flex 4
      */
     protected function dataProvider_collectionChangeHandler(event:Event):void
     {

    //----------------------------------
    //  dataProvider
    //----------------------------------
    
    private var dataProviderChanged:Boolean;
    
    /**

    private var requiresSelectionChanged:Boolean = false;

    /**
     *  Specifies whether an item must always be selected in the dataProvider.
     *  If the value is <code>true</code>, the <code>selectedIndex</code> property 
     *  is always set to a value between 0 and (<code>dataProvider.length</code> - 1), 
     *  or -1 if there are no items.
