     }
     
     /**
-     *  Sizes, positions and parents the dropIndicator based on the specified
-     *  dropLocation.
-     *
-     *  Starts/stops drag-scrolling when necessary conditions are met.
-     * 
-     *  @param dropLocation <p>Specifies the location where to show the indicator.
-     *  Drop location is obtained through the computeDropLocation() method.</p>
+     *  Sizes, positions and parents the drop indicator based on the specified
+     *  drop location. Use the <code>calculateDropLocation()</code> method
+     *  to obtain the DropLocation object.
+     *
+     *  <p>Starts/stops drag-scrolling when necessary conditions are met.</p>
+     * 
+     *  @param dropLocation Specifies the location where to show the drop indicator.
+     *  Drop location is obtained through the <code>computeDropLocation()</code> method.
      *
      *  @see #dropIndicator 
-     *  @see #hideDropIndicator
-     *  @see #getDragEventContext
-     *  @see #dropIndicator
+     *  @see #hideDropIndicator()
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

     * 
     *  Called by the <code>calculatedDropLocation()</code> method.
     *
     *  @param x The x coordinate of the drag and drop gesture, in target's
     *  local coordinates.
     * 
     *  @param y The y coordinate of the drag and drop gesture, in target's
     *  local coordinates.
     *
     *  @return The drop index or -1 if the drop operation is not available
     *  at the specified coordinates.
     * 
     *  @see #calculateDropLocation
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10

    private var _dropIndicator:DisplayObject;
    
    /**
     *  The <code>DisplayObject</code> that this layout uses for
     *  the drop indicator during a drag-and-drop operation.
     *
     *  Typically you do not set this property directly,
     *  but instead define a <code>dropIndicator</code> skin part in the 
     *  skin class of the drop target.
     * 
     *  <p>The List control sets this property in response to a
     *  <code>DragEvent.DRAG_ENTER</code> event.
     *  The List initializes this property with an
     *  instance of its <code>dropIndicator</code> skin part.
     *  The List clears this property in response to a
     *  <code>DragEvent.DRAG_EXIT</code> event.</p>
     *  
     *  @langversion 3.0
