     private var _transitionControlsWithContent:Boolean;
     
     /**
-     *  When set to true, the primary view transition
-     *  is used to transition the navigator in its entirety,  
-     *  and sub-transitions such as the action bar or 
-     *  tab bar transitions are not performed.
+     *  When set to <code>true</code>, the primary view transition
+     *  is used to transition the view navigator in its entirety, 
+     *  including the action bar.
+     *  Specific transitions for the action bar are not performed.
+     *  Because the tab bar is associated with the entire application, 
+     *  and not a view, view transitions do not affect it.
      *
-     *  <p>Note that even when set to false, there are cases
-     *  where its not feasible to transition the action bar 
-     *  or tab bar, such as when the action bar or 
-     *  tab bar does not exist in one of the two views or
-     *  if the tab bar or action bar changes size.</p>
+     *  <p>Note that even when set to <code>false</code>, there are cases
+     *  where its not feasible to transition the action bar. 
+     *  For example, when the action bar 
+     *  does not exist in one of the two views, or
+     *  if the action bar changes size.</p>
      *
      *  @default false
      * 
      *  @langversion 3.0
-     *  @playerversion Flash 10
      *  @playerversion AIR 2.5
      *  @productversion Flex 4.5
      */

    }
    
    /**
     *  Called by the default prepareForPlay() implementation, this method 
     *  is responsible for creating the spark effect that should be played on the
     *  action bar when the transition starts.  This method should be
     *  overridden by sub classes if a custom action bar effect is
     *  required.  By default, this returns a basic action bar effect.
     * 
     *  @return An IEffect instance serving as the action bar effect. Will be 
     *  played by the default play() method implementation.
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */

    }
    
    /**
     *  Used to render snap shots of screen elements in 
     *  preparation for transitioning.  
     *  The bitmap is returned in the form of a BitmapImage object.  
     *  The BitmapImage object's transform is adjusted so that
     *  the bitmap matches the target.
     * 
     *  @param target Display object to capture.
     *  
     *  @param padding Padding around the object to be included in 
     *  the BitmapImage object.
     * 
     *  @return BitmapImage object representing the target.
     * 
     *  @langversion 3.0
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5
     */ 
