     //
     //--------------------------------------------------------------------------
     
-    /**
-     *  Flag that determines if the list supports multiple selection.
-     * 
+    /*
      *  TODO: description of how single selection properties
      *  work when multiple selection is enabled. multiple selection
      *  doesn't support selectionChanging event. etc.
+     */
+    /**
+     *  <code>true</code> if the list supports multiple selection.
      * 
      *  @default false
      */

        return NO_SELECTION;
    }
    
    override public function set selectedIndex(value:int):void
    {
        if (!allowMultipleSelection)

        invalidateProperties();
    }
    
    [Bindable("selectionChanged")]
    /*
     *  Selected items for this component.
     * 
     *  TODO: describe
     * 
     *  @default null
     */
    /**
     *  Selected items for this component.
     * 
     *  @default null
     */
    public function get selectedItems():Array
    {
        var result:Array;
