     [Bindable(event="valueCommit")]
     /**
      *  Date that is currently selected in the DateSpinner control.
+     * 
+     *  <p>Note that the Date object returned by the getter is a copy of 
+     *  the internal Date, and the one provided to the setter is copied
+     *  internally, so modifications to these will not be reflected in the
+     *  DateSpinner. To modify the DateSpinner's date, get and modify the
+     *  current selectedDate and then re-set the selectedDate.</p>
      *
      *  @default Current date when the DateSpinner was instantiated.
      * 

    private static function get todayDate():Date
    {
        if (_todayDate != null)
            return _todayDate;
        
        return new Date();
    }
    
    //--------------------------------------------------------------------------
    //
    //  Overridden methods

     */
    public function get selectedDate():Date
    {
        return new Date(_selectedDate.time);
    }
    
    /**
