Make some organization in RenderWidgetHost clearer.

content/browser/renderer_host/render_widget_host.h

 // Copyright (c) 2011 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 CONTENT_BROWSER_RENDERER_HOST_RENDER_WIDGET_HOST_H_
 #define CONTENT_BROWSER_RENDERER_HOST_RENDER_WIDGET_HOST_H_
 #pragma once
 
 #include <deque>
 #include <string>
@@ skipping 456 matching lines @@
 
   // Called to handled a keyboard event before sending it to the renderer.
   // This is overridden by RenderView to send upwards to its delegate.
   // Returns true if the event was handled, and then the keyboard event will
   // not be sent to the renderer anymore. Otherwise, if the |event| would
   // be handled in HandleKeyboardEvent() method as a normal keyboard shortcut,
   // |*is_keyboard_shortcut| should be set to true.
   virtual bool PreHandleKeyboardEvent(const NativeWebKeyboardEvent& event,
                                       bool* is_keyboard_shortcut);
 
-  // Called when a keyboard event was not processed by the renderer. This is
-  // overridden by RenderView to send upwards to its delegate.
+  // "RenderWidgetHostDelegate" ------------------------------------------------
+  // There is no RenderWidgetHostDelegate but the following methods serve the
+  // same purpose. They are overridden by RenderView to send upwards to its
+  // delegate.
+
+  // Called when a keyboard event was not processed by the renderer.
   virtual void UnhandledKeyboardEvent(const NativeWebKeyboardEvent& event) {}
 
-  // Called when a mousewheel event was not processed by the renderer. This is
-  // overridden by RenderView to send upwards to its delegate.
+  // Called when a mousewheel event was not processed by the renderer.
   virtual void UnhandledWheelEvent(const WebKit::WebMouseWheelEvent& event) {}
 
   // Notification that the user has made some kind of input that could
-  // perform an action. The render view host overrides this to forward the
-  // information to its delegate (see corresponding function in
-  // RenderViewHostDelegate). The gestures that count are 1) any mouse down
+  // perform an action. The gestures that count are 1) any mouse down
   // event and 2) enter or space key presses.
   virtual void OnUserGesture() {}
 
   // Callbacks for notification when the renderer becomes unresponsive to user
-  // input events, and subsequently responsive again. RenderViewHost overrides
-  // these to tell its delegate to show the user a warning.
+  // input events, and subsequently responsive again.
   virtual void NotifyRendererUnresponsive() {}
   virtual void NotifyRendererResponsive() {}
 
+  // ---------------------------------------------------------------------------
+
   // RenderViewHost overrides this method to impose further restrictions on when
   // to allow mouse lock.
   // Once the request is approved or rejected, GotResponseToLockMouseRequest()
   // will be called.
   virtual void RequestToLockMouse();
 
   void RejectMouseLockOrUnlockIfNecessary();
   bool IsMouseLocked() const;
 
   // RenderViewHost overrides this method to report when in fullscreen mode.
@@ skipping 270 matching lines @@
   gfx::Point last_scroll_offset_;
 
   bool pending_mouse_lock_request_;
 
   base::WeakPtrFactory<RenderWidgetHost> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(RenderWidgetHost);
 };
 
 #endif  // CONTENT_BROWSER_RENDERER_HOST_RENDER_WIDGET_HOST_H_