Refactoring Reload in NavigationManager and CRWWebController.

ios/web/web_state/ui/crw_web_controller.h

 // Copyright 2012 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_WEB_STATE_UI_CRW_WEB_CONTROLLER_H_
 #define IOS_WEB_WEB_STATE_UI_CRW_WEB_CONTROLLER_H_
 
 #import <UIKit/UIKit.h>
 
 #import "ios/web/net/crw_request_tracker_delegate.h"
@@ skipping 135 matching lines @@
 // appropriate, as this method won't display any error to the user.
 - (GURL)currentURLWithTrustLevel:(web::URLVerificationTrustLevel*)trustLevel;
 
 // Methods for navigation and properties to interrogate state.
 - (void)reload;
 - (void)stopLoading;
 // YES if the CRWWebController's view is deemed appropriate for saving in order
 // to generate an overlay placeholder view.
 - (BOOL)canUseViewForGeneratingOverlayPlaceholderView;
 
-// Start loading the URL specified in |originalParams|, with the specified
+// Start loading the URL specified in |params|, with the specified
 // settings.  Always resets the openedByScript property to NO.
+// NOTE: |params.transition_type| should never be PAGE_TRANSITION_RELOAD except
+// for transient items, if one needs to reload, call |-reload| explicitly.
 - (void)loadWithParams:(const web::NavigationManager::WebLoadParams&)params;
 
 // Loads the URL indicated by current session state.
 - (void)loadCurrentURL;
 
 // Loads HTML in the page and presents it as if it was originating from an
 // application specific URL.
 - (void)loadHTML:(NSString*)HTML forAppSpecificURL:(const GURL&)URL;
 
 // Loads HTML in the page and presents it as if it was originating from the
@@ skipping 132 matching lines @@
 
 // Acts on a single message from the JS object, parsed from JSON into a
 // DictionaryValue. Returns NO if the format for the message was invalid.
 - (BOOL)respondToMessage:(base::DictionaryValue*)crwMessage
        userIsInteracting:(BOOL)userIsInteracting
                originURL:(const GURL&)originURL;
 
 @end
 
 #endif  // IOS_WEB_WEB_STATE_UI_CRW_WEB_CONTROLLER_H_