reflow comments in core/input

third_party/WebKit/Source/core/input/BoundaryEventDispatcher.cpp

 // Copyright 2016 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.
 
 #include "core/input/BoundaryEventDispatcher.h"
 
 #include "core/dom/Node.h"
 #include "core/dom/shadow/FlatTreeTraversal.h"
 
 namespace blink {
@@ skipping 56 matching lines @@
     dispatchOut(exitedTarget, enteredTarget);
 
   // Create lists of all exited/entered ancestors, locate the common ancestor
   // Based on httparchive, in more than 97% cases the depth of DOM is less
   // than 20.
   HeapVector<Member<Node>, 20> exitedAncestors;
   HeapVector<Member<Node>, 20> enteredAncestors;
   size_t exitedAncestorsCommonParentIndex = 0;
   size_t enteredAncestorsCommonParentIndex = 0;
 
-  // A note on mouseenter and mouseleave: These are non-bubbling events, and they are dispatched if there
-  // is a capturing event handler on an ancestor or a normal event handler on the element itself. This special
-  // handling is necessary to avoid O(n^2) capturing event handler checks.
+  // A note on mouseenter and mouseleave: These are non-bubbling events, and
+  // they are dispatched if there is a capturing event handler on an ancestor or
+  // a normal event handler on the element itself. This special handling is
+  // necessary to avoid O(n^2) capturing event handler checks.
   //
-  //   Note, however, that this optimization can possibly cause some unanswered/missing/redundant mouseenter or
-  // mouseleave events in certain contrived eventhandling scenarios, e.g., when:
-  // - the mouseleave handler for a node sets the only capturing-mouseleave-listener in its ancestor, or
-  // - DOM mods in any mouseenter/mouseleave handler changes the common ancestor of exited & entered nodes, etc.
-  // We think the spec specifies a "frozen" state to avoid such corner cases (check the discussion on "candidate event
-  // listeners" at http://www.w3.org/TR/uievents), but our code below preserves one such behavior from past only to
-  // match Firefox and IE behavior.
+  // Note, however, that this optimization can possibly cause some
+  // unanswered/missing/redundant mouseenter or mouseleave events in certain
+  // contrived eventhandling scenarios, e.g., when:
+  // - the mouseleave handler for a node sets the only
+  //   capturing-mouseleave-listener in its ancestor, or
+  // - DOM mods in any mouseenter/mouseleave handler changes the common ancestor
+  //   of exited & entered nodes, etc.
+  // We think the spec specifies a "frozen" state to avoid such corner cases
+  // (check the discussion on "candidate event listeners" at
+  // http://www.w3.org/TR/uievents), but our code below preserves one such
+  // behavior from past only to match Firefox and IE behavior.
   //
   // TODO(mustaq): Confirm spec conformance, double-check with other browsers.
 
   buildAncestorChainsAndFindCommonAncestors(
       exitedTarget, enteredTarget, &exitedAncestors, &enteredAncestors,
       &exitedAncestorsCommonParentIndex, &enteredAncestorsCommonParentIndex);
 
   bool exitedNodeHasCapturingAncestor = false;
   const AtomicString& leaveEvent = getLeaveEvent();
   for (size_t j = 0; j < exitedAncestors.size(); j++) {
     if (exitedAncestors[j]->hasCapturingEventListeners(leaveEvent)) {
       exitedNodeHasCapturingAncestor = true;
       break;
     }
   }
 
   // Dispatch leave events, in child-to-parent order.
   for (size_t j = 0; j < exitedAncestorsCommonParentIndex; j++)
     dispatchLeave(exitedAncestors[j], enteredTarget,
                   !exitedNodeHasCapturingAncestor);
 
   // Dispatch over event
   if (isInDocument(enteredTarget))
     dispatchOver(enteredTarget, exitedTarget);
 
-  // Defer locating capturing enter listener until /after/ dispatching the leave events because
-  // the leave handlers might set a capturing enter handler.
+  // Defer locating capturing enter listener until /after/ dispatching the leave
+  // events because the leave handlers might set a capturing enter handler.
   bool enteredNodeHasCapturingAncestor = false;
   const AtomicString& enterEvent = getEnterEvent();
   for (size_t i = 0; i < enteredAncestors.size(); i++) {
     if (enteredAncestors[i]->hasCapturingEventListeners(enterEvent)) {
       enteredNodeHasCapturingAncestor = true;
       break;
     }
   }
 
   // Dispatch enter events, in parent-to-child order.
   for (size_t i = enteredAncestorsCommonParentIndex; i > 0; i--)
     dispatchEnter(enteredAncestors[i - 1], exitedTarget,
                   !enteredNodeHasCapturingAncestor);
 }
 
 }  // namespace blink