diff --git a/src/main/java/com/puppycrawl/tools/checkstyle/checks/javadoc/SingleLineJavadocCheck.java b/src/main/java/com/puppycrawl/tools/checkstyle/checks/javadoc/SingleLineJavadocCheck.java index 52b250fe8..c985b27de 100644 --- a/src/main/java/com/puppycrawl/tools/checkstyle/checks/javadoc/SingleLineJavadocCheck.java +++ b/src/main/java/com/puppycrawl/tools/checkstyle/checks/javadoc/SingleLineJavadocCheck.java @@ -24,7 +24,8 @@ import com.puppycrawl.tools.checkstyle.api.JavadocTokenTypes; /** * Checks that a JavaDoc block which can fit on a single line and doesn't - * contain at-clauses may be substituted by a single line. + * contain at-clauses. Javadoc comment that contains at leat one at-clause + * should be formatted in few lines. * * Default configuration: *
diff --git a/src/xdocs/availablechecks.xml b/src/xdocs/availablechecks.xml
index d03f36053..58572159f 100644
--- a/src/xdocs/availablechecks.xml
+++ b/src/xdocs/availablechecks.xml
@@ -642,7 +642,7 @@
       
         SingleLineJavadoc
         
-        Checks that a JavaDoc block which can fit on a single line.
+         Checks that a JavaDoc block which can fit on a single line and doesn't contain at-clauses
       
       
         SimplifyBooleanExpression
diff --git a/src/xdocs/config_javadoc.xml b/src/xdocs/config_javadoc.xml
index 8f5eed69a..4ca580dc0 100644
--- a/src/xdocs/config_javadoc.xml
+++ b/src/xdocs/config_javadoc.xml
@@ -1098,7 +1098,9 @@ public boolean isSomething()
     

- Checks that a JavaDoc block which can fit on a single line and doesn't contain at-clauses may be substituted by a single line. + Checks that a JavaDoc block which can fit on a single line and doesn't + contain at-clauses. Javadoc comment that contains at leat one at-clause + should be formatted in few lines.