Reflow comments in //third_party/WebKit/Source/core/editing

third_party/WebKit/Source/core/editing/Position.h

 /*
  * Copyright (C) 2004, 2006, 2008 Apple Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 76 matching lines @@
   bool isBeforeAnchor() const {
     return m_anchorType == PositionAnchorType::BeforeAnchor;
   }
   bool isBeforeChildren() const {
     return m_anchorType == PositionAnchorType::BeforeChildren;
   }
   bool isOffsetInAnchor() const {
     return m_anchorType == PositionAnchorType::OffsetInAnchor;
   }
 
-  // These are always DOM compliant values.  Editing positions like [img, 0] (aka [img, before])
-  // will return img->parentNode() and img->nodeIndex() from these functions.
-  Node* computeContainerNode()
-      const;  // null for a before/after position anchored to a node with no parent
+  // These are always DOM compliant values.  Editing positions like [img, 0]
+  // (aka [img, before]) will return img->parentNode() and img->nodeIndex() from
+  // these functions.
 
-  int computeOffsetInContainerNode()
-      const;  // O(n) for before/after-anchored positions, O(1) for parent-anchored positions
-  PositionTemplate<Strategy> parentAnchoredEquivalent()
-      const;  // Convenience method for DOM positions that also fixes up some positions for editing
+  // null for a before/after position anchored to a node with no parent
+  Node* computeContainerNode() const;
+
+  // O(n) for before/after-anchored positions, O(1) for parent-anchored
+  // positions
+  int computeOffsetInContainerNode() const;
+
+  // Convenience method for DOM positions that also fixes up some positions for
+  // editing
+  PositionTemplate<Strategy> parentAnchoredEquivalent() const;
 
   // Returns |PositionIsAnchor| type |Position| which is compatible with
   // |RangeBoundaryPoint| as safe to pass |Range| constructor. Return value
   // of this function is different from |parentAnchoredEquivalent()| which
   // returns editing specific position.
   PositionTemplate<Strategy> toOffsetInAnchor() const;
 
   // Inline O(1) access for Positions which callers know to be parent-anchored
   int offsetInContainerNode() const {
     DCHECK(isOffsetInAnchor());
     return m_offset;
   }
 
   // Returns an offset for editing based on anchor type for using with
   // |anchorNode()| function:
   //   - OffsetInAnchor  m_offset
   //   - BeforeChildren  0
   //   - BeforeAnchor    0
   //   - AfterChildren   last editing offset in anchor node
   //   - AfterAnchor     last editing offset in anchor node
   // Editing operations will change in anchor node rather than nodes around
   // anchor node.
   int computeEditingOffset() const;
 
-  // These are convenience methods which are smart about whether the position is neighbor anchored or parent anchored
+  // These are convenience methods which are smart about whether the position is
+  // neighbor anchored or parent anchored
   Node* computeNodeBeforePosition() const;
   Node* computeNodeAfterPosition() const;
 
   // Returns node as |Range::firstNode()|. This position must be a
   // |PositionAnchorType::OffsetInAhcor| to behave as |Range| boundary point.
   Node* nodeAsRangeFirstNode() const;
 
   // Similar to |nodeAsRangeLastNode()|, but returns a node in a range.
   Node* nodeAsRangeLastNode() const;
 
@@ skipping 56 matching lines @@
 #endif
 
   DEFINE_INLINE_TRACE() { visitor->trace(m_anchorNode); }
 
  private:
   bool isAfterAnchorOrAfterChildren() const {
     return isAfterAnchor() || isAfterChildren();
   }
 
   Member<Node> m_anchorNode;
-  // m_offset can be the offset inside m_anchorNode, or if editingIgnoresContent(m_anchorNode)
-  // returns true, then other places in editing will treat m_offset == 0 as "before the anchor"
-  // and m_offset > 0 as "after the anchor node".  See parentAnchoredEquivalent for more info.
+  // m_offset can be the offset inside m_anchorNode, or if
+  // editingIgnoresContent(m_anchorNode) returns true, then other places in
+  // editing will treat m_offset == 0 as "before the anchor" and m_offset > 0 as
+  // "after the anchor node".  See parentAnchoredEquivalent for more info.
   int m_offset;
   PositionAnchorType m_anchorType;
 };
 
 extern template class CORE_EXTERN_TEMPLATE_EXPORT
     PositionTemplate<EditingStrategy>;
 extern template class CORE_EXTERN_TEMPLATE_EXPORT
     PositionTemplate<EditingInFlatTreeStrategy>;
 
 using Position = PositionTemplate<EditingStrategy>;
 using PositionInFlatTree = PositionTemplate<EditingInFlatTreeStrategy>;
 
 template <typename Strategy>
 bool operator==(const PositionTemplate<Strategy>& a,
                 const PositionTemplate<Strategy>& b) {
   if (a.isNull())
     return b.isNull();
 
   if (a.anchorNode() != b.anchorNode() || a.anchorType() != b.anchorType())
     return false;
 
   if (!a.isOffsetInAnchor()) {
-    // Note: |m_offset| only has meaning when |PositionAnchorType::OffsetInAnchor|.
+    // Note: |m_offset| only has meaning when
+    // |PositionAnchorType::OffsetInAnchor|.
     return true;
   }
 
   // FIXME: In <div><img></div> [div, 0] != [img, 0] even though most of the
   // editing code will treat them as identical.
   return a.offsetInContainerNode() == b.offsetInContainerNode();
 }
 
 template <typename Strategy>
 bool operator!=(const PositionTemplate<Strategy>& a,
@@ skipping 26 matching lines @@
 
 }  // namespace blink
 
 #ifndef NDEBUG
 // Outside the WebCore namespace for ease of invocation from gdb.
 void showTree(const blink::Position&);
 void showTree(const blink::Position*);
 #endif
 
 #endif  // Position_h