     
     /**
      *  Contains <code>true</code> if the item renderer's cell is part 
-     *  of the current selection.  
-     *  The item renderer owner is responsible for drawing the selection 
-     *  indicator for the selected row or cell.  
-     *  The item renderer can also change its visual properties 
-     *  to emphasize that it's part of the selection.
+     *  of the current selection.
+     * 
+     *  <p> Unlike a List item renderer, 
+     *  grid item renderers do not have exclusive responsibility for displaying 
+     *  something to indicate that they're part of the selection.  The Grid 
+     *  itself automatically displays the selectionIndicator skin part for the 
+     *  selected rows or cells.  The item renderer can also change its visual properties 
+     *  to emphasize that it's part of the selection.</p>
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

    function set showsCaret(value:Boolean):void;    
    
    /**
     *  The GridColumn object representing the column
     *  associated with this item renderer.
     *
     *  <p>This property is set by the item renderer owner by its
     *  <code>updateDisplayList()</code> method. </p>
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10

     *  property, or because a redisplay was explicitly requested. 
     * 
     *  <p>This method can be used to configure all of a renderer's visual 
     *  elements and properties.
     *  Using this method can be more efficient than binding <code>data</code>
     *  properties to visual element properties.  
     *  Note: Because the <code>prepare()</code> method is called frequently, 
     *  make sure that it is coded efficiently.</p>
     *
     *  <p>The <code>prepare()</code> method may be called many times 
     *  before the <code>discard()</code> method is called.</p>
     * 
     *  <p>This method is not intended to be called directly.
     *  It is called by the DataGrid implementation.</p>
     * 
     *  @param hasBeenRecycled  <code>true</code> if this renderer is being reused.
     * 
