This comment contains Javadoc or HTML tags, and is in the right position for a Javadoc, but doesn't start with a double asterisk. Should it be a Javadoc?
/* Frobnicates the {@link Foo}s. */
class Frobnicator {
Foo frobnicate(Foo foo);
}
/** Frobnicates the {@link Foo}s. */
class Frobnicator {
Foo frobnicate(Foo foo);
}
Suppress by applying @SuppressWarnings("AlmostJavadoc") to the element being
documented (or not documented).