Refactoring Reload in NavigationManager and CRWWebController.

ios/web/public/navigation_manager.h

 // Copyright 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef IOS_WEB_PUBLIC_NAVIGATION_MANAGER_H_
 #define IOS_WEB_PUBLIC_NAVIGATION_MANAGER_H_
 
 #include <stddef.h>
 
 #import "base/mac/scoped_nsobject.h"
@@ skipping 135 matching lines @@
   virtual bool CanGoToOffset(int offset) const = 0;
   virtual void GoBack() = 0;
   virtual void GoForward() = 0;
 
   // Navigates to the specified absolute index.
   // TODO(crbug.com/533848): Update to use size_t.
   virtual void GoToIndex(int index) = 0;
 
   // Reloads the visible item under the specified ReloadType. If
   // |check_for_repost| is true and the current item has POST data the user is
-  // prompted to see if they really want to reload the page. In nearly all cases
-  // pass in true.  If a transient item is showing, initiates a new navigation
-  // to its URL.
+  // prompted to see if they really want to reload the page. Pass in true if the
+  // reload is explicitly initiated by the user. If a transient item is showing,
+  // initiates a new navigation to its URL.
   // TODO(crbug.com/700571): implement the logic for when |reload_type| is
   // ORIGINAL_REQUEST_URL.
   // TODO(crbug.com/700958): implement the logic for |check_for_repost|.
   virtual void Reload(ReloadType reload_type, bool check_for_repost) = 0;
 
   // Returns a list of all non-redirected NavigationItems whose index precedes
   // or follows the current index.
   virtual NavigationItemList GetBackwardItems() const = 0;
   virtual NavigationItemList GetForwardItems() const = 0;
 
@@ skipping 20 matching lines @@
   // Forces the pending item to be loaded using desktop user agent. Note that
   // the pending item may or may not already exist.
   // TODO(crbug.com/692303): Remove this when overriding the user agent doesn't
   // create a new NavigationItem.
   virtual void OverrideDesktopUserAgentForNextPendingItem() = 0;
 };
 
 }  // namespace web
 
 #endif  // IOS_WEB_PUBLIC_NAVIGATION_MANAGER_H_