diff --git a/platform/analysis-api/src/com/intellij/codeInspection/ProblemDescriptor.java b/platform/analysis-api/src/com/intellij/codeInspection/ProblemDescriptor.java
index be035f253708..63f08181893b 100644
--- a/platform/analysis-api/src/com/intellij/codeInspection/ProblemDescriptor.java
+++ b/platform/analysis-api/src/com/intellij/codeInspection/ProblemDescriptor.java
@@ -46,7 +46,7 @@ public interface ProblemDescriptor extends CommonProblemDescriptor{
   void setTextAttributes(TextAttributesKey key);
 
   /**
-   * Gets the unique object, which is the same for all of the problems of this group
+   * Gets the unique object, which has the same {@link com.intellij.lang.annotation.ProblemGroup#getProblemName()} for all of the problems of this group
    *
    * @return the problem group
    */
@@ -54,7 +54,7 @@ public interface ProblemDescriptor extends CommonProblemDescriptor{
   ProblemGroup getProblemGroup();
 
   /**
-   * Sets the unique object, which is the same for all of the problems of this group
+   * Sets the unique object, which has the same {@link com.intellij.lang.annotation.ProblemGroup#getProblemName()} for all of the problems of this group
    *
    * @param problemGroup the problemGroup
    */