Nel passaggio dalla versione 7 alla 8 di Java mi sono accorto che Javadoc è diventato particolarmente "pignolo" con la sintassi della documentazione. Il magico mvn javadoc:javadoc si è trasformato in un incubo.

Ora non sono più ammessi tag incompleti o formattazione non valida. Non che questo sia un male, anzi. Ma quando le priorità sono altre, le classi centinaia e si ha la necessità di creare un minimo di javadoc sarebbe meglio sorvolare e rimandare a tempi migliori (magari aggiungendo una issue su GitHub per ricordarcelo).

Ripeto che l'ideale sarebbe avere tutto al posto giusto ma non sempre le cose vanno come vorremmo, soprattutto se si mette mano al codice scritto da altri.

Il controllo può essere disabilitato aggiungendo al file pom.xml il seguente profilo

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

Ora tutti gli error si trasformano in warning e l'operazione si conclude senza problemi.