javadoc et /* (non-Javadoc)

Bonjour

Je débute sur eclipse et sur java globalement et aussi sur ce forum et vous remercie par avance ! ;)

J'ai sélectionné toutes les champs, méthodes d'une classe dans outline ou projet explorer
J'ai voulu généré automatiquement les commentaires javadoc avec alt+shift+J

et j'ai eu des commentaires par ex:
/* (non-Javadoc)
* @see s09.inter.Pile#loop()
*/
j'ai supposé que mon package "inter" différent du package de la classe était la cause de ce non-commentaire javadoc
je suppose peut-être mal et aimerais comprendre ce qui s'est passé pourquoi a t il généré là et pas sur d'autres ?

mais dans tous les cas comment puis je obtenir les com javadoc,
je sais que je peux rajouter une ' * ' mais ce n'est pas le but pour que ce soit automatique d'ailleurs y-a t il moyen de le faire sur plusieurs classe en même temps ?

En vous remerciant de votre aide...

Salut,

Je ne sais pas pourquoi tu as ce simple commentaire au lieu du javadoc qu'on devrait obtenir sur ALT+SHIFT+J. D'un autre côté, je trouve cette fonction un peu bidon : le propre de la javadoc est d'expliquer à quoi sert une méthode et comment on s'en sert, ce qu'un automatisme pourra difficilement déterminer (sauf IA super puissante de science fiction). Et ce qui est généré automatiquement n'est plus utile avec les IDE modernes.

Mais si tu y tiens, normalement, il suffit de sélectionner l'ensemble des éléments (méthodes, attributs...)dans le package explorer, et de faire ALT+SHIFT+J, ce qui est assez pénible lorsqu'on veut faire ça pour l'ensemble des classes (on ne peut pas utiliser CTRL-A, parce qu'il ne faut pas sélectionner les nœuds "entête").

Par ailleurs, il existe des plugins comme : JAutodoc.

justement j'ai sélectionné l'ensemble des champs, attributs, méthodes puis ALT+SHIFT+J
et parfois cela génère le commentaires javadoc comme attendu et parfois ça
/* (non-Javadoc)
* @see ... la méthode de l'interface pourtant la classe implémente son interface
*/

l'intéret est deux pour moi débutant de cette fonction :
1- je met de la lisibilité dans mon code et peut me concentrer sur l'apprentissage de java proprement dit
2- j'apprend javadoc plus intuitivement

j'avais intallé JAutodoc. mais cela m'a mis le clavier qwerty sur tout l'IDE
j'ai du enlever dans /plugin et /features et c'est revenu de nouveau clavier français ???

en tout cas ce serait vraiment utile que je puisse générer auto les /** */ sans ce problème
j'ai accumulé beaucoup de petits projets ça me permettrait rapidement de remettre de l'ordre et de la visibilité
je reconnais que c'est une mauvaise pratique mais j'apprend :)

Citation:

---

Envoyé par nouilletonne

justement j'ai sélectionné l'ensemble des champs, attributs, méthodes puis ALT+SHIFT+J
et parfois cela génère le commentaires javadoc comme attendu et parfois ça
/* (non-Javadoc)
* @see ... la méthode de l'interface pourtant la classe implémente son interface
*/

l'intéret est deux pour moi débutant de cette fonction :
1- je met de la lisibilité dans mon code et peut me concentrer sur l'apprentissage de java proprement dit
2- j'apprend javadoc plus intuitivement

---

Je suis pas sûr ni pour l'un, ni pour l'autre, mais si ça le fait pour toi, admettons.

Citation:

---

Envoyé par nouilletonne

j'avais intallé JAutodoc. mais cela m'a mis le clavier qwerty sur tout l'IDE
j'ai du enlever dans /plugin et /features et c'est revenu de nouveau clavier français ???

---

Je n'utilise pas JAutodoc, donc ne peut rien te dire sur ce bug, et un contournement éventuel.

Citation:

---

Envoyé par nouilletonne

en tout cas ce serait vraiment utile que je puisse générer auto les /** */ sans ce problème
j'ai accumulé beaucoup de petits projets ça me permettrait rapidement de remettre de l'ordre et de la visibilité
je reconnais que c'est une mauvaise pratique mais j'apprend :)

---

C'est un peu tard, là, mais après avoir créer ta signature de méthode, tu tapes /** puis entrée juste avant et ça te créé le canevas de la javadoc. C'est plus contraignant, mais au moins ça te donne le réflexe de faire la javadoc systématiquement.
Sinon, reste la moulinette, avec java-parser par exemple... ça peut être aussi formateur.

Je ne sais pas ce qu'est java-parser et créer une moulinette au sein du code même

par contre je suis enfin tombé sur une explication et une solution pour mon problème
https://www.eclipse.org/forums/index.php/t/34107/

en allant dans window/préférences/java/codetemplates/comments/overiddingmethods/
et éditer et copier le même code que les methodes non héritées

car c'était bien cela les méthodes héritées des interfaces entre autres, généraient ce genre de commentaires javadoc

je vais retenter pour Jautodoc pour essayer de résoudre,
(résolu en fait ça ne devait pas être à cause du plugin j'avais pourtant bien vérifié que par exemple mon clavier n'était pas verrouillé CAP ou autre chose... mais tout à l'heure il était bien qwerty encore une énigme informatique pour moi)

certes tout ça ressemble à de la feignantise mais c'est plutôt pour repartir correctement lisiblement
car je m'y perd en tant que débutant dans l'usine à gaz d'eclipse et un peu de confiance ça fait pas de mal pour aborder d'autres sujets java de mes programmes qui sont loin d'être simple pour moi ^^

Citation:

---

Envoyé par nouilletonne

...je suis enfin tombé sur une explication et une solution pour mon problème
https://www.eclipse.org/forums/index.php/t/34107/

en allant dans window/préférences/java/codetemplates/comments/overiddingmethods/
et éditer et copier le même code que les methodes non héritées

car c'était bien cela les méthodes héritées des interfaces entre autres, généraient ce genre de commentaires javadoc

---

Ah, oui, je comprends mieux : c'est la doc par défaut insérée pour une méthode @Override. C'est vrai que c'est une plaie ce truc (un /** {@inheritDoc} */ aurait été mieux pour moi): je n'avais jamais fait gaffe que c'était aussi la javadoc insérée par ALT+SHIFT+J (comme je n'utilise jamais ça, forcément).

par contre plus ennuyeux je suis toujours en qwerty par moment dans certaine fenêtre et je ne sais pas pourquoi ni comment résoudre ? (ma version d'eclipse, ... )
Ma version : Luna , OS : w7 pro 64

Salut,

Citation:

---

Envoyé par nouilletonne

par contre plus ennuyeux je suis toujours en qwerty par moment dans certaine fenêtre et je ne sais pas pourquoi ni comment résoudre ? (ma version d'eclipse, ... )
Ma version : Luna , OS : w7 pro 64

---

Le problème vient sûrement de la barre des langues de Windows (à coté de l'horloge).

Il y a un raccourci-clavier basé sur control alt et/ou shift qui permet de changer rapidement de langue (et de clavier).
Du coup il est fréquent de changer la langue d'eclipse par erreur.

Vérifies que tu soit bien en français, et si tu n'as pas besoin de cette barre de langues va dans ses paramètres pour "supprimer" l'anglais...


a++

merci c'était ça forcément

ALTG + MAJ ou CTRLG + MAJ pour basculer les langues et clavier et ALT +SHIFT + J pour eclipse pas besoin de faire trop proba pour finir en qwerty !

j'ai supprimé les raccourcis associé au basculement langue je devrais être tranquille

bon.. je crois qu'on peut considérer résolu ce sujet ? :)