      *  Calculates how much to scroll for the specified <code>dropLocation</code>
      *  during a drag and drop gesture.
      *
-     *  Called by the <code>showDropIndicator()</code> method to figure out the
+     *  Called by the <code>showDropIndicator()</code> method to calculate the scroll 
      *  during drag-scrolling.
      *
-     *  @param context A valid <code>LayoutDragEventContext</code> previously obtained
-     *  through the <code>getDragEventContext</code> method.
-     *
-     *  @param scrollDelta The <code>Point</code> to be filled with the computed scroll delta.
-     *
-     *  @param timeInterval The interval in milliseconds between two consecutive drag-scrolls.
-     *
-     *  @param timeElapsed The duration in milliseconds since the drag scrolling start.
+     *  @param context A valid DropLocation object previously obtained
+     *  by calling the <code>calculateDropLocation()</code> method.
+     *
+     *  @param timeInterval The interval, in milliseconds, between two consecutive drag-scrolls.
+     *
+     *  @param timeElapsed The duration, in milliseconds, since the drag scrolling start.
      *
      *  @return How much to drag scroll, or null if drag-scrolling is not needed.
      *
      *  @see spark.layouts.supportClasses.DropLocation 
-     *  @see #calculateDropIndex
-     *  @see #calculateDropIndicatorBounds
+     *  @see #calculateDropIndex()
+     *  @see #calculateDropIndicatorBounds()
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

    }
    
    /**
     *  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>
     *
     *  @see #dropIndicator 
     *  @see #hideDropIndicator
     *  @see #getDragEventContext
     *  @see #dropIndicator
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10

    public function set dropIndicator(value:DisplayObject):void
    {
        if (_dropIndicator)
            target.overlay.removeDisplayObject(_dropIndicator);
        
        _dropIndicator = value;
        
        if (_dropIndicator)
        {
            _dropIndicator.visible = false;
            target.overlay.addDisplayObject(_dropIndicator, OverlayDepth.DROP_INDICATOR_DEPTH);

            if (_dropIndicator is ILayoutManagerClient)
                UIComponentGlobals.layoutManager.validateClient(ILayoutManagerClient(_dropIndicator), true);

            // Set includeInLayout to false, otherwise it'll still invalidate
            // the parent Group layout as we size and position the indicator.
            if (_dropIndicator is ILayoutElement)
                ILayoutElement(_dropIndicator).includeInLayout = false;
        }
    }
    
