Disabilitare il check dei tag con Javadoc

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 trasformano in warning e l’operazione si conclude senza problemi.

Lascia una risposta

L'indirizzo email non verrà pubblicato. I campi obbligatori sono contrassegnati *

Utilizzando il sito, accetti l'invio dei cookies da parte nostra. Maggiori informazioni

Questo sito utilizza i cookies per fornire la migliore esperienza di navigazione possibile. Continuando ad utilizzarlo senza modificare le impostazioni o cliccando su "Accetta" acconsenti al loro utilizzo.

Chiudi