This one has been a big missing feature for quite some time. Even old comments on the code (now deleted) wondered on being able to do this.

I didn't reuse the CPD-START / CPD-STOP literals since I found them unintuitive. START is to tell CPD to stop looking, STOP is to resume analysis. This even contradicted the preexisting // NOPMD comments. Again, a negative to suppress.

The start / stop may work given it's within a @SuppressWarnings (so we get a "suppress warnings cpd start"), but certainly wouldn't be the same for stand alone comments. To avoid issues, I simply created new literals.

I also updated the docs and moved the annotation based approach to legacy due to lack of flexibility.

Porting this approach to other JavaCC based languages is still pending. I can't find a way to do it in a reusable manner, since each parser generates it's own Token class, and the specialToken is a public field, not accessible through a getter. Ideas are welcomed.