Mark some non-spinvalidation methods deprecated, and update paint/README.md

third_party/WebKit/Source/core/layout/LayoutObject.h

 /*
  * Copyright (C) 2000 Lars Knoll (knoll@kde.org)
  *           (C) 2000 Antti Koivisto (koivisto@kde.org)
  *           (C) 2000 Dirk Mueller (mueller@kde.org)
  *           (C) 2004 Allan Sandfeld Jensen (kde@carewolf.com)
  * Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2012 Apple Inc.
  *               All rights reserved.
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * This library is free software; you can redistribute it and/or
@@ skipping 249 matching lines @@
   // implemented by any subclass, and since a hierarchy can contain a mixture of
   // boxes and other object types, these functions need to be in the base class.
   PaintLayer* EnclosingLayer() const;
   void AddLayers(PaintLayer* parent_layer);
   void RemoveLayers(PaintLayer* parent_layer);
   void MoveLayers(PaintLayer* old_parent, PaintLayer* new_parent);
   PaintLayer* FindNextLayer(PaintLayer* parent_layer,
                             LayoutObject* start_point,
                             bool check_parent = true);
 
-  // Returns the layer that will paint this object. If possible, use the faster
-  // PaintInvalidationState::paintingLayer() instead.
+  // Returns the layer that will paint this object. During paint invalidation,
+  // we should use the faster PaintInvalidatorContext::painting_layer instead.
   PaintLayer* PaintingLayer() const;
 
   // Scrolling is a LayoutBox concept, however some code just cares about
   // recursively scrolling our enclosing ScrollableArea(s).
   bool ScrollRectToVisible(
       const LayoutRect&,
       const ScrollAlignment& align_x = ScrollAlignment::kAlignCenterIfNeeded,
       const ScrollAlignment& align_y = ScrollAlignment::kAlignCenterIfNeeded,
       ScrollType = kProgrammaticScroll,
       bool make_visible_in_visual_viewport = true);
@@ skipping 1100 matching lines @@
   // If a DisplayItemClient is specified, that client is invalidated rather than
   // |this|.
   // Returns the visual rect that was invalidated (i.e, invalidation in the
   // space of the GraphicsLayer backing this LayoutObject).
   LayoutRect InvalidatePaintRectangle(const LayoutRect&,
                                       DisplayItemClient* = nullptr) const;
 
   // Walk the tree after layout issuing paint invalidations for layoutObjects
   // that have changed or moved, updating bounds that have changed, and clearing
   // paint invalidation state.
-  virtual void InvalidateTreeIfNeeded(const PaintInvalidationState&);
+  virtual void DeprecatedInvalidateTree(const PaintInvalidationState&);
 
   void SetShouldDoFullPaintInvalidationIncludingNonCompositingDescendants();
 
   // Returns the rect that should have paint invalidated whenever this object
   // changes. The rect is in the view's coordinate space. This method deals with
   // outlines and overflow.
   virtual LayoutRect AbsoluteVisualRect() const;
 
   // Returns the rect that should have paint invalidated whenever this object
   // changes. The rect is in the object's local coordinate space. This is for
@@ skipping 667 matching lines @@
   virtual void EnsureIsReadyForPaintInvalidation() { DCHECK(!NeedsLayout()); }
 
   // This function walks the descendants of |this|, following a
   // layout ordering.
   //
   // The ordering is important for PaintInvalidationState, as it requires to be
   // called following a descendant/container relationship.
   //
   // The function is overridden to handle special children (e.g. percentage
   // height descendants or reflections).
-  virtual void InvalidatePaintOfSubtreesIfNeeded(
+  virtual void DeprecatedInvalidatePaintOfSubtrees(
       const PaintInvalidationState& child_paint_invalidation_state);
 
   // This function generates the invalidation for this object only.
   // It doesn't recurse into other object, as this is handled by
-  // invalidatePaintOfSubtreesIfNeeded.
-  virtual PaintInvalidationReason InvalidatePaint(
+  // DeprecatedInvalidatePaintOfSubtrees.
+  virtual PaintInvalidationReason DeprecatedInvalidatePaint(
       const PaintInvalidationState&);
 
   void SetIsBackgroundAttachmentFixedObject(bool);
 
   void ClearSelfNeedsOverflowRecalcAfterStyleChange() {
     bitfields_.SetSelfNeedsOverflowRecalcAfterStyleChange(false);
   }
   void SetEverHadLayout() { bitfields_.SetEverHadLayout(true); }
 
   // Remove this object and all descendants from the containing
@@ skipping 721 matching lines @@
 CORE_EXPORT void showLineTree(const blink::LayoutObject*);
 CORE_EXPORT void showLayoutTree(const blink::LayoutObject* object1);
 // We don't make object2 an optional parameter so that showLayoutTree
 // can be called from gdb easily.
 CORE_EXPORT void showLayoutTree(const blink::LayoutObject* object1,
                                 const blink::LayoutObject* object2);
 
 #endif
 
 #endif  // LayoutObject_h