diff --git a/xml/xml-psi-api/src/com/intellij/psi/xml/XmlTagValue.java b/xml/xml-psi-api/src/com/intellij/psi/xml/XmlTagValue.java
index 6183cf6f1fe7..e3b50aec15a6 100644
--- a/xml/xml-psi-api/src/com/intellij/psi/xml/XmlTagValue.java
+++ b/xml/xml-psi-api/src/com/intellij/psi/xml/XmlTagValue.java
@@ -26,12 +26,20 @@ public interface XmlTagValue {
   @NotNull
   XmlText[] getTextElements();
 
+  /**
+   * @return raw tag value text
+   * @see #getTrimmedText()
+   */
   @NotNull
   String getText();
   
   @NotNull
   TextRange getTextRange();
 
+  /**
+   * @return concatenated child XmlTexts values.
+   * @see XmlText#getValue()
+   */
   @NotNull
   String getTrimmedText();