Reintegrate 552 r66225-r66645....

chrome/browser/browser_navigator.h

Index: chrome/browser/browser_navigator.h
===================================================================
--- chrome/browser/browser_navigator.h	(revision 66837)
+++ chrome/browser/browser_navigator.h	(working copy)
@@ -85,6 +85,13 @@
 
   // The disposition requested by the navigation source. Default is
   // CURRENT_TAB.
+  // If disposition is NEW_WINDOW or NEW_POPUP, |show_window| is set to true
+  // automatically.
+  // If disposition is NEW_BACKGROUND_TAB, TabStripModel::ADD_SELECTED is
+  // removed from |tabstrip_add_types| automatically.
+  // If disposition is one of NEW_WINDOW, NEW_POPUP, NEW_FOREGROUND_TAB or
+  // SINGLETON_TAB, then TabStripModel::ADD_SELECTED is automatically added to
+  // |tabstrip_add_types|.
   WindowOpenDisposition disposition;
 
   // The transition type of the navigation. Default is PageTransition::LINK
@@ -114,6 +121,8 @@
 
   // True if the target window should be made visible at the end of the call
   // to Navigate(). Default is false.
+  // If disposition is NEW_WINDOW or NEW_POPUP, |show_window| is set to true
+  // automatically.
   bool show_window;
 
   // [in]  Specifies a Browser object where the navigation could occur or the