Clarify comments for methods added in r178921

Clarify comments for methods added in r178921 as per follow-up review comments.

R=pdr@chromium.org

Review URL: https://codereview.chromium.org/423823005

git-svn-id: svn://svn.chromium.org/blink/trunk@179044 bbb929c8-8fbe-4397-9dbb-9b2b20218538

third_party/WebKit/Source/core/dom/Attr.h

@@ -67,7 +67,7 @@ private:
     Attr(Element&, const QualifiedName&);
     Attr(Document&, const QualifiedName&, const AtomicString& value);
 
-    bool isElementNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isElementNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     void createTextChild();
 

third_party/WebKit/Source/core/dom/CharacterData.h

@@ -76,8 +76,8 @@ private:
     virtual bool offsetInCharacters() const OVERRIDE FINAL;
     void setDataAndUpdate(const String&, unsigned offsetOfReplacedData, unsigned oldLength, unsigned newLength, RecalcStyleBehavior = DoNotRecalcStyle);
 
-    bool isContainerNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isElementNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isContainerNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isElementNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 };
 
 DEFINE_NODE_TYPE_CASTS(CharacterData, isCharacterDataNode());

third_party/WebKit/Source/core/dom/ContainerNode.h

@@ -186,8 +186,8 @@ protected:
     void setLastChild(Node* child) { m_lastChild = child; }
 
 private:
-    bool isContainerNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isTextNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isContainerNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isTextNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     void removeBetween(Node* previousChild, Node* nextChild, Node& oldChild);
     void insertBeforeCommon(Node& nextChild, Node& oldChild);

third_party/WebKit/Source/core/dom/Document.h

@@ -1073,9 +1073,9 @@ private:
     friend class Node;
     friend class IgnoreDestructiveWriteCountIncrementer;
 
-    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isDocumentNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isElementNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isDocumentNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isElementNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     ScriptedAnimationController& ensureScriptedAnimationController();
     virtual SecurityContext& securityContext() OVERRIDE FINAL { return *this; }

third_party/WebKit/Source/core/dom/DocumentFragment.h

@@ -48,7 +48,7 @@ private:
     virtual PassRefPtrWillBeRawPtr<Node> cloneNode(bool deep = true) OVERRIDE;
     virtual bool childTypeAllowed(NodeType) const OVERRIDE;
 
-    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 };
 
 DEFINE_NODE_TYPE_CASTS(DocumentFragment, isDocumentFragment());

third_party/WebKit/Source/core/dom/Element.h

@@ -561,9 +561,9 @@ private:
     void clearElementFlag(ElementFlags);
     bool hasElementFlagInternal(ElementFlags) const;
 
-    bool isElementNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isDocumentNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isElementNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isDocumentFragment() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isDocumentNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     void styleAttributeChanged(const AtomicString& newStyleString, AttributeModificationReason);
 

third_party/WebKit/Source/core/dom/Text.h

@@ -70,7 +70,7 @@ private:
     virtual String nodeName() const OVERRIDE;
     virtual PassRefPtrWillBeRawPtr<Node> cloneNode(bool deep = true) OVERRIDE FINAL;
 
-    bool isTextNode() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isTextNode() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     bool needsWhitespaceRenderer();
 

third_party/WebKit/Source/core/dom/shadow/InsertionPoint.h

@@ -78,7 +78,7 @@ protected:
     virtual void willRecalcStyle(StyleRecalcChange) OVERRIDE;
 
 private:
-    bool isInsertionPoint() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isInsertionPoint() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     ContentDistribution m_distribution;
     bool m_registeredWithShadowRoot;

third_party/WebKit/Source/core/html/HTMLElement.h

@@ -115,8 +115,8 @@ protected:
 private:
     virtual String nodeName() const OVERRIDE FINAL;
 
-    bool isHTMLElement() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isStyledElement() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isHTMLElement() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isStyledElement() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     void mapLanguageAttributeToLocale(const AtomicString&, MutableStylePropertySet*);
 

third_party/WebKit/Source/core/svg/SVGElement.h

@@ -234,8 +234,8 @@ private:
     // https://bugs.webkit.org/show_bug.cgi?id=77938
     virtual bool areAuthorShadowsAllowed() const OVERRIDE FINAL { return false; }
 
-    bool isSVGElement() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
-    bool isStyledElement() const WTF_DELETED_FUNCTION; // Hide to catch useless calls.
+    bool isSVGElement() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
+    bool isStyledElement() const WTF_DELETED_FUNCTION; // This will catch anyone doing an unnecessary check.
 
     RenderStyle* computedStyle(PseudoId = NOPSEUDO);
     virtual RenderStyle* virtualComputedStyle(PseudoId pseudoElementSpecifier = NOPSEUDO) OVERRIDE FINAL { return computedStyle(pseudoElementSpecifier); }