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

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

Index: third_party/WebKit/Source/core/layout/LayoutObject.h
diff --git a/third_party/WebKit/Source/core/layout/LayoutObject.h b/third_party/WebKit/Source/core/layout/LayoutObject.h
index 7d808bdbffc4a6b75bc6e552cd3ad36ed4eb27a6..da2777953d8d9f34d56065cfc28ceb1d24470c54 100644
--- a/third_party/WebKit/Source/core/layout/LayoutObject.h
+++ b/third_party/WebKit/Source/core/layout/LayoutObject.h
@@ -267,8 +267,8 @@ class CORE_EXPORT LayoutObject : public ImageResourceObserver,
                             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
@@ -1389,7 +1389,7 @@ class CORE_EXPORT LayoutObject : public ImageResourceObserver,
   // 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();
 
@@ -2077,13 +2077,13 @@ class CORE_EXPORT LayoutObject : public ImageResourceObserver,
   //
   // 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);