Rewrap comments to 80 columns in Source/platform/graphics/paint/.

third_party/WebKit/Source/platform/graphics/paint/DisplayItem.h

 // Copyright 2014 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 DisplayItem_h
 #define DisplayItem_h
 
 #include "platform/PlatformExport.h"
 #include "platform/graphics/ContiguousContainer.h"
 #include "platform/graphics/paint/DisplayItemClient.h"
@@ skipping 20 matching lines @@
  public:
   enum {
     // Must be kept in sync with core/paint/PaintPhase.h.
     kPaintPhaseMax = 11,
   };
 
   // A display item type uniquely identifies a display item of a client.
   // Some display item types can be categorized using the following directives:
   // - In enum Type:
   //   - enum value <Category>First;
-  //   - enum values of the category, first of which should equal <Category>First;
-  //     (for ease of maintenance, the values should be in alphabetic order)
-  //   - enum value <Category>Last which should be equal to the last of the enum values of the category
-  // - DEFINE_CATEGORY_METHODS(<Category>) to define is<Category>Type(Type) and is<Category>() methods.
+  //   - enum values of the category, first of which should equal
+  //     <Category>First (for ease of maintenance, the values should be in
+  //     alphabetic order);
+  //   - enum value <Category>Last which should be equal to the last of the enum
+  //     values of the category
+  // - DEFINE_CATEGORY_METHODS(<Category>) to define is<Category>Type(Type) and
+  //   is<Category>() methods.
   //
-  // A category or subset of a category can contain types each of which corresponds to a PaintPhase:
+  // A category or subset of a category can contain types each of which
+  // corresponds to a PaintPhase:
   // - In enum Type:
   //   - enum value <Category>[<Subset>]PaintPhaseFirst;
-  //   - enum value <Category>[<Subset>]PaintPhaseLast = <Category>[<Subset>]PaintPhaseFirst + PaintPhaseMax;
+  //   - enum value <Category>[<Subset>]PaintPhaseLast =
+  //     <Category>[<Subset>]PaintPhaseFirst + PaintPhaseMax;
   // - DEFINE_PAINT_PHASE_CONVERSION_METHOD(<Category>[<Subset>]) to define
   //   paintPhaseTo<Category>[<Subset>]Type(PaintPhase) method.
   //
-  // A category can be derived from another category, containing types each of which corresponds to a
-  // value of the latter category:
+  // A category can be derived from another category, containing types each of
+  // which corresponds to a value of the latter category:
   // - In enum Type:
   //   - enum value <Category>First;
-  //   - enum value <Category>Last = <Category>First + <BaseCategory>Last - <BaseCategory>First;
-  // - DEFINE_CONVERSION_METHODS(<Category>, <category>, <BaseCategory>, <baseCategory>) to define methods to
-  //   convert types between the categories;
+  //   - enum value <Category>Last =
+  //     <Category>First + <BaseCategory>Last - <BaseCategory>First;
+  // - DEFINE_CONVERSION_METHODS(<Category>,
+  //                             <category>,
+  //                             <BaseCategory>,
+  //                             <baseCategory>)
+  //   to define methods to convert types between the categories.
   enum Type {
     kDrawingFirst,
     kDrawingPaintPhaseFirst = kDrawingFirst,
     kDrawingPaintPhaseLast = kDrawingFirst + kPaintPhaseMax,
     kBoxDecorationBackground,
     kCaret,
     kColumnRules,
     kDebugDrawing,
     kDocumentBackground,
     kDragImage,
@@ skipping 24 matching lines @@
     kScrollbarForwardTrack,
     kScrollbarThumb,
     kScrollbarTickmarks,
     kScrollbarTrackBackground,
     kScrollbarCompositedScrollbar,
     kSelectionTint,
     kTableCellBackgroundFromColumnGroup,
     kTableCellBackgroundFromColumn,
     kTableCellBackgroundFromSection,
     kTableCellBackgroundFromRow,
-    // Table collapsed borders can be painted together (e.g., left & top) but there are at most 4 phases of collapsed
-    // border painting for a single cell. To disambiguate these phases of collapsed border painting, a mask is used.
-    // TableCollapsedBorderBase can be larger than TableCollapsedBorderUnalignedBase to ensure the base lower bits are 0's.
+    // Table collapsed borders can be painted together (e.g., left & top) but
+    // there are at most 4 phases of collapsed border painting for a single
+    // cell. To disambiguate these phases of collapsed border painting, a mask
+    // is used. TableCollapsedBorderBase can be larger than
+    // TableCollapsedBorderUnalignedBase to ensure the base lower bits are 0's.
     kTableCollapsedBorderUnalignedBase,
     kTableCollapsedBorderBase =
         (((kTableCollapsedBorderUnalignedBase - 1) >> 4) + 1) << 4,
     kTableCollapsedBorderLast = kTableCollapsedBorderBase + 0x0f,
     kTableSectionBoxShadowInset,
     kTableSectionBoxShadowNormal,
     kTableRowBoxShadowInset,
     kTableRowBoxShadowNormal,
     kVideoBitmap,
     kWebPlugin,
@@ skipping 71 matching lines @@
     kEndSubsequence,
 
     kUninitializedType,
     kTypeLast = kUninitializedType
   };
 
   static_assert(kTableCollapsedBorderBase >= kTableCollapsedBorderUnalignedBase,
                 "TableCollapsedBorder types overlap with other types");
   static_assert((kTableCollapsedBorderBase & 0xf) == 0,
                 "The lowest 4 bits of TableCollapsedBorderBase should be zero");
-  // Bits or'ed onto TableCollapsedBorderBase to generate a real table collapsed border type.
+  // Bits or'ed onto TableCollapsedBorderBase to generate a real table collapsed
+  // border type.
   enum TableCollapsedBorderSides {
     TableCollapsedBorderTop = 1 << 0,
     TableCollapsedBorderRight = 1 << 1,
     TableCollapsedBorderBottom = 1 << 2,
     TableCollapsedBorderLeft = 1 << 3,
   };
 
   DisplayItem(const DisplayItemClient& client, Type type, size_t derivedSize)
       : m_client(&client),
         m_type(type),
@@ skipping 31 matching lines @@
     return *m_client;
   }
   Type getType() const { return m_type; }
 
   // Size of this object in memory, used to move it with memcpy.
   // This is not sizeof(*this), because it needs to account for the size of
   // the derived class (i.e. runtime type). Derived classes are expected to
   // supply this to the DisplayItem constructor.
   size_t derivedSize() const { return m_derivedSize; }
 
-  // For PaintController only. Painters should use DisplayItemCacheSkipper instead.
+  // For PaintController only. Painters should use DisplayItemCacheSkipper
+  // instead.
   void setSkippedCache() { m_skippedCache = true; }
   bool skippedCache() const { return m_skippedCache; }
 
   // TODO(wkorman): Only DrawingDisplayItem needs the visual rect argument.
   // Consider refactoring class hierarchy to make this more explicit.
   virtual void appendToWebDisplayItemList(const IntRect&,
                                           WebDisplayItemList*) const {}
 
 // See comments of enum Type for usage of the following macros.
 #define DEFINE_CATEGORY_METHODS(Category)                           \
@@ skipping 148 matching lines @@
   bool isEndAndPairedWith(DisplayItem::Type otherType) const override = 0;
 #endif
 
  private:
   bool isEnd() const final { return true; }
 };
 
 }  // namespace blink
 
 #endif  // DisplayItem_h