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).