Javadoc dans le JDK 8 : Invalid “de l'auto-élément de fermeture (non autorisé”

Quelles sont les meilleures solutions de contournement lors de l'exécution de javadoc à l'aide du JDK 8 et on reçoit cette erreur.

Il semble que, pour JDK 8, il a été décidé que les balises comme <br /> et <p /> devrait générer des erreurs, parce qu'ils ne sont pas valides (strict) HTML 4. voir la discussion JDK liste de diffusion ici

Je me demande, parce que je voulais juste compiler quelques projet java avec maven et trébuché sur cette question. Bien sûr, je peux déposer un ticket avec le projet (et je pense que je vais), mais ce serait bien si il y a un moyen de désactiver ce comportement (pour un ordinateur). Sinon, je pense que beaucoup de projets ont besoin d'être fixé avant qu'ils peuvent être construits sur JDK 8 sans problèmes.

InformationsquelleAutor JE42 | 2014-09-25
  1. 24

    Pour ces deux cas particuliers, je pense que l'action recommandée est de les remplacer par des <p>. Cette est le lien vers la documentation Oracle.

    InformationsquelleAutor Tavo
  2. 17

    Pour supprimer les erreurs dans le javaDocs il suffit de remplacer:

    • <p/> avec juste <p>
    • <br/> avec juste <br>

    Tout fonctionne bien après la correction, à une exception façon.

    • Le Simple remplacement de <p/>par <p> va conduire à un certain nombre de vides balise p avertissements. Jusqu'-voté parce que c'était mieux que les autres réponses, mais j'ai tout de même ajouté une solution plus complète comme réponse.
    InformationsquelleAutor Xelian
  3. 13

    Prises de "Ce qui est Nouveau dans le JDK 8" de l'oracle.com:

    La javac outil a maintenant le soutien de vérifier le contenu des commentaires javadoc pour des questions qui pourraient conduire à divers problèmes, tels que HTML non valide ou les questions d'accessibilité, dans les fichiers qui sont générés lors de la javadoc est exécuté. La fonctionnalité est activée par la nouvelle -Xdoclint option. Pour plus de détails, voir la sortie de l'exécution de "javac -X". Cette fonctionnalité est également disponible dans la javadoc de l'outil, et est activé par défaut.

    Maintenant, j'ai ce qu'il me dit de faire. Sur JDK 7, la sortie de "javac -X" ne fait pas mention de l'-Xdoclint option. Cependant, sur JDK 8, cela donne:

     -Xdoclint:(all|none|[-]<group>)[/<access>]
    Enable or disable specific checks for problems in javadoc comments,
    where <group> is one of accessibility, html, missing, reference, or syntax,
    and <access> is one of public, protected, package, or private.

    Exécutez l'utilitaire Javadoc comme suit:

    javadoc.exe -Xdoclint:none <other options...>

    Dans mon script, l'erreur que vous avez mentionné disparu par l'utilisation de cette option.

    • Oui, c'est correct. Cependant, javdoc de JDK 7 échoue avec cette option, cela signifie que vous avez à détecter la prise en charge de la nouvelle option. En fin de compte, j'ai fini par fixer le html.
    • Si le projet est à l'aide de maven, vous pouvez utiliser des profils qui activent uniquement pour jdk8. C'est probablement mieux de juste corriger le HTML si vous le pouvez et fichier un bug avec le projet.
    InformationsquelleAutor Timmos
  4. 1

    Alors qu'il est possible de désactiver la vérification des erreurs avec l'-Xdoclint option, elle n'a pas à réparer le problème, il vient se cache le problème. Faire des HTML4 documents les substitutions suivantes sont correctes.

    • Remplacer l'auto fermeture des balises br régulièrement balises br (<br /> par <br>)
    • Remplacer vide les balises p avec les balises br (<p /> par <br>)
    • S'assurer que toutes les balises p contenu et sont fermés (<p>... avec <p> ...</p>)
    InformationsquelleAutor Ralph Ritoch