Package com.puppycrawl.tools.checkstyle.checks.javadoc
package com.puppycrawl.tools.checkstyle.checks.javadoc
Contains the Javadoc checks that are bundled with the main distribution.
-
ClassDescriptionBase class for Checks that process Javadoc comments.The file context holder.Checks the order of javadoc block-tags or javadoc tags.Detects a user-defined Javadoc block tag and reports a violation when the tag is present with text that does not match
tagTextPattern.Checks that Javadoc block tags for type definitions (class, interface, enum, record, annotation) do not contain tags that are semantically invalid for types.Checks that Javadocs are located at the correct position.Value object for storing data about an invalid Javadoc tag.Checks that a javadoc block tag appears only at the beginning of a line, ignoring leading asterisks and white space.Checks that the Javadoc content begins from the same position for all Javadoc comments in the project.Represents the locations for the javadoc content.Checks that the Javadoc closing delimiter contains exactly one asterisk before the slash.Checks the alignment of leading asterisks in a Javadoc comment.Checks that in Javadoc comments, each API name is linked with{@link}or{@linkplain}only on its first occurrence.Checks that Javadoc comments avoid unnecessary{@link}and{@linkplain}tags for APIs that are considered well-known.Checks the Javadoc of a method or constructor.Contains class'sToken.Stores useful information about declared exception.Represents text element with location in the text.Checks if the javadoc has leading asterisks on each line.Checks that there is at least one whitespace after the leading asterisk.Implementation of DetailNode interface that is mutable.Checks thatErrortypes are not documented in@throwsor@exceptionJavadoc tags.Checks that each Java package has a Javadoc file used for commenting.Checks the Javadoc paragraph.Checks that@paramtags in Javadoc comments are in the same order as the parameters in the declaration.Checks that Javadoc comments do not match a configured regular expression.Represents a Javadoc tag.Checks the indentation of the continuation lines in block tags.This enum defines the various Javadoc tags and their properties.The Javadoc Type.Checks that multiple@throwsand@exceptionJavadoc tags are listed alphabetically by exception name.Checks the Javadoc comments for type definitions.Checks that a variable has a Javadoc comment.Checks for missing Javadoc comments for a method or constructor.Checks for missing package definition Javadoc comments in package-info.java files.Checks for missing Javadoc comments for class, enum, interface, and annotation interface definitions.Checks that the block tag is followed by description.Checks that Javadoc inline tags{@code ...}and{@snippet ...}are preferred over HTML tags<code>and<pre>.Checks that Javadoc inline tags are preferred over escaping entities.Checks that one blank line before the block tag if it is present in Javadoc.Checks that a Javadoc block can fit in a single-line and doesn't contain block tags.Checks that Javadoc summary sentence does not contain phrases that are not recommended to use.Requires user defined Javadoc tag to be present in Javadoc comment with defined format.