Discussion :

[ToTo13]

Bonjour,

je viens de passer de Java 1.7 vers Java 1.8 et il semblerait que les règles de construction de la javadoc ne soient plus les mêmes.
Par exemple, j'utilise des balises <dd></dd> pour indenter du texte. Cela ne posait aucun problème au préalable, mais maintenant cela génère une erreur lors de la construction de la javadoc.
Y a t-il un moyen de modifier cela ? Une sorte de modification des règles... ou une solution pour assurer la rétro-compatibilité.
Au cas où, je développe sous NetBeans.

Merci par avance,

PS : je ne suis pas certain que ce soit le forum le plus adapté, donc merci de déplacer mon post si nécessaire.

[eulbobo]

http://docs.oracle.com/javase/8/docs...hatsnew-8.html

Il y a une option pour désactiver la validation stricte des javadoc, mais oui, java 8 n'aime plus trop les caractères comme < ou > (parce que ça merde en conversion HTML)

[ToTo13]

Merci, mais je ne trouve pas du tout que ce soit une amélioration de la JavaDoc.
Mon code fonctionnait parfaitement et n'avait aucun souci de conversion en HTML. Du coup si je veux avoir quelque chose de "propre" je me retrouve avec plus de 200 fichiers à modifier :@
Y a t-il un outil pour faire des modifications à grande échelle, par exemple remplacer certaines balises se trouvant dans ma javadoc ?

[eulbobo]

C'est une amélioration dans le sens où ça force de manière stricte une présentation pour être sûr de toujours pouvoir générer une javadoc qui a du sens, sans que le moteur de génération de la javadoc n'ait à gérer les cas foireux de balises ouvertes et non fermées.

Après un outil qui fait ça tout seul, je ne sais pas... A moins que tu le développes toi même :p

sinon, ben génération avec le mode -Xdoclint:none

[adiGuba]

Salut,

Merci, mais je ne trouve pas du tout que ce soit une amélioration de la JavaDoc.
Mon code fonctionnait parfaitement et n'avait aucun souci de conversion en HTML. Du coup si je veux avoir quelque chose de "propre" je me retrouve avec plus de 200 fichiers à modifier :@
Y a t-il un outil pour faire des modifications à grande échelle, par exemple remplacer certaines balises se trouvant dans ma javadoc ?

Le soucis c'est que ton code HTML n'est pas "propre" justement.
La balise <dd> n'est pas conçus pour être utilisé seule, mais à l'intérieur d'un bloc <dl> permettant de définir une liste de définition :

Code HTML :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
<dl>
<dt>Term</dt>
<dd>Définition</dd>
</dl>

a++

[ToTo13]

Le soucis c'est que ton code HTML n'est pas "propre" justement.
La balise <dd> n'est pas conçus pour être utilisé seule, mais à l'intérieur d'un bloc <dl> permettant de définir une liste de définition :

Code HTML :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
<dl>
<dt>Term</dt>
<dd>Définition</dd>
</dl>

Ok je vois. Mais ça s'affichait très bien ;-)
Est ce que si j'ajoute la balise <dl> autour de mes <dd> la javadoc va accepter ?

Par contre, je sais que j'avais tout un tas de "=>" qui eux ne sont pas propre, il me va donc falloir les supprimer. Une idée pour faire cela proprement (et automatiquement) ?

[ToTo13]

Il y a quelques détails ici.
Visiblement ça met un gros bor*** dans de nombreuses JavaDoc. Dans mon cas, c'est plus de 200 classes à modifier

[tchize_]

Ok je vois. Mais ça s'affichait très bien ;-)
....
Par contre, je sais que j'avais tout un tas de "=>" qui eux ne sont pas propre, il me va donc falloir les supprimer. Une idée pour faire cela proprement (et automatiquement) ?

Parce que le browser derrière fait de gros efforts pour essayer de comprendre ton html pourri


Pour les =>, une regexp dans ton IDE devrai suffire. Chercher /\* (.*)=> et remplacer par /\* \1=&gt;

[ToTo13]

Parce que le browser derrière fait de gros efforts pour essayer de comprendre ton html pourri

Pour les =>, une regexp dans ton IDE devrai suffire. Chercher /\* (.*)=> et remplacer par /\* \1=&gt;

Merci :-)