DeepSource
Dashboard Resources Pricing Discover Directory Log in

Run your first analysis.

Find thousands of code security and quality issues in your codebase, before they end up in production.

Start now
Java

Java

Made by DeepSource
Use Analyzer

Malformed JavaDoc comment JAVA-D1007

Documentation
Major

This JavaDoc comment appears to be malformed. Such comments may raise errors or cause crashes when passed to a JavaDoc generation tool.

Rewrite the comment to use correct syntax.

JavaDoc is generally quite permissive with respect to what counts as a valid tag name. However, it is important to avoid straying too much from established conventions to ensure that your documentation does not leave people scratching their heads.

Bad Practice

In the example below, there is a malformed @param tag starting with two @ symbols. If a JavaDoc tool were to be used on this code, it is likely that errors will be raised.

/**
 * some method.
 *
 * @@param someParam param.
 */
void someMethod(String someParam) {
    // ...
}

Recommended

Correct the improper syntax, and follow proper JavaDoc comment formatting.

/**
 * some method.
 *
 * @param someParam param.
 */
void someMethod(String someParam) {
    // ...
}

References