Class JavadocMissingWhitespaceAfterAsteriskCheck

  • All Implemented Interfaces:
    Configurable, Contextualizable

    public class JavadocMissingWhitespaceAfterAsteriskCheck
    extends AbstractJavadocCheck

    Checks that there is at least one whitespace after the leading asterisk. Although spaces after asterisks are optional in the Javadoc comments, their absence makes the documentation difficult to read. It is the de facto standard to put at least one whitespace after the leading asterisk.

    • Property violateExecutionOnNonTightHtml - Control when to print violations if the Javadoc being examined by this check violates the tight html rules defined at Tight-HTML Rules. Type is boolean. Default value is false.

    To configure the default check:

     <module name="JavadocMissingWhitespaceAfterAsterisk"/>
     

    Code Example:

     /** This is valid single-line Javadoc. */
     class TestClass {
       /**
         *This is invalid Javadoc.
         */
       int invalidJavaDoc;
       /**
         * This is valid Javadoc.
         */
       void validJavaDocMethod() {
       }
       /**This is invalid single-line Javadoc. */
       void invalidSingleLineJavaDocMethod() {
       }
       /** This is valid single-line Javadoc. */
       void validSingleLineJavaDocMethod() {
       }
     }
     

    Parent is com.puppycrawl.tools.checkstyle.TreeWalker

    Violation Message Keys:

    • javadoc.missed.html.close
    • javadoc.missing.whitespace
    • javadoc.parse.rule.error
    • javadoc.wrong.singleton.html.tag
    Since:
    8.32