diff --git a/java/java-psi-api/src/com/intellij/psi/PsiResourceList.java b/java/java-psi-api/src/com/intellij/psi/PsiResourceList.java
index 3b7be1409f92..dc68fabf1c91 100644
--- a/java/java-psi-api/src/com/intellij/psi/PsiResourceList.java
+++ b/java/java-psi-api/src/com/intellij/psi/PsiResourceList.java
@@ -7,5 +7,9 @@ package com.intellij.psi;
  * @see PsiTryStatement#getResourceList()
  */
 public interface PsiResourceList extends PsiElement, Iterable<PsiResourceListElement> {
+  /**
+   * @return number of PsiResourceListElement children 
+   * (unlike method name suggests, not only resource variables, but also resource expressions)
+   */
   int getResourceVariablesCount();
 }
\ No newline at end of file