 
 /**
  *  Dispatched when the transition starts.
+ *  
+ *  @langversion 3.0
+ *  @playerversion AIR 2.5
+ *  @productversion Flex 4.5
  */
 [Event(name="transitionStart", type="flash.events.Event")]
 
 /**
  *  Dispatched when the transition is complete.
+ *  
+ *  @langversion 3.0
+ *  @playerversion AIR 2.5
+ *  @productversion Flex 4.5
  */
 [Event(name="transitionEnd", type="flash.events.Event")]
 
 
 /**
- *  The ViewTransitionBase class serves as the base class for all stock view 
- *  transitions.  It is not intended to be used as a transition on its own.
- *  
+ *  The ViewTransitionBase class is the base class for all view transitions.  
+ *  It is not intended to be used as a transition on its own.
  *  In addition to providing common convenience and helper methods used by 
  *  view transitions this class also provides a default action bar transition 
  *  sequence.
  * 
- *  <p>When a view transition is initialized, the owning view navigator will 
- *  assign the startView and endView references to the views the transition 
- *  will be animating from and to. In addition, the navigator property will 
- *  be set to reflect the view navigator.</p>
+ *  <p>When a view transition is initialized, the owning view navigator 
+ *  sets the <code>startView</code> and <code>endView</code> properties 
+ *  to the views the transition animates. 
+ *  The <code>navigator</code> property is 
+ *  set to the view navigator.</p>
  * 
- *  <p>The lifecycle of a transition starts with the <code>captureStartValues()</code> 
- *  method.  When this method is called, the navigator is currently in the 
- *  start state.  At this point the transition should capture any start values 
- *  or bitmaps that it requires.  Afterwards, a validation pass on the pending 
- *  view and <code>captureEndValues()</code> will be called. At this point the 
- *  transition is to capture any properties or bitmaps representations from the 
- *  pending view.</p>
+ *  <p>The lifecycle of a transition starts with 
+ *  the <code>captureStartValues()</code> method.  
+ *  When this method is called, the navigator is currently in the 
+ *  start state.  
+ *  At this time, the transition should capture any start values 
+ *  or bitmaps that it requires.  
+ *  Afterwards, a validation pass on the pending 
+ *  view and <code>captureEndValues()</code> is called. 
+ *  At this time, the transition captures any properties or 
+ 8  bitmaps representations from the pending view.</p>
  *  
- *  <p>At this point <code>prepareForPlay()</code> is called, which allows the transition 
- *  to perform any further preparation (such as preparing a spark effects sequence, 
- *  or positioning transient elements on the display list).</p>
+ *  <p>The <code>prepareForPlay()</code> method is then called, 
+ *  which allows the transition  to perform any further preparation,
+ *  such as preparing a Spark effects sequence, 
+ *  or positioning transient elements on the display list.</p>
  * 
- *  <p>After one final validation pass (if necessary), <code>play()</code> is invoked 
- *  by the navigator to perform the actual transition. Prior to any animation
- *  starting the <code>FlexEvent.TRANSITION_START</code> event will be dispatched.</p>
+ *  <p>After a final validation pass, if necessary, the <code>play()</code> method 
+ *  is called by the navigator to perform the actual transition. 
+ *  Prior to any animation starting, the <code>start</code> event is dispatched.</p>
  * 
- *  <p>When a transition completes, it is required to dispatch a 
- *  <code>FlexEvent.TRANSITION_END</code> event.</p>
+ *  <p>When a transition completes, it is required to dispatch an 
+ *  <code>end</code> event.</p>
+ *
+ *  <p><strong>Note:</strong>Create and configure view transitions in ActionScript;
+ *  you cannot create them in MXML.</p>
  *  
  *  @langversion 3.0
- *  @playerversion Flash 10
  *  @playerversion AIR 2.5
  *  @productversion Flex 4.5
  */

    }
    
    /**
     *  Called by the transition to denote that the effect object 
     *  has finished executing, dispatches a FlexEvent.TRANSITION_END event.
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */

    //--------------------------------------------------------------------------
    
    /**
     *  Called by the ViewNavigator during the preparation phase of a transition.
     *  It is invoked when the new view has been fully realized and validated and the 
     *  action bar and tab bar content reflect the state of the new view. 
     *  The transition can use this method capture any values it requires from the 
     *  pending view. 
     *  Any bitmaps reflecting the state of the new view, tab bar, 
     *  or action bar should be captured if required for animation.
     * 
     *  @langversion 3.0
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */
