Discussion :

[devlop78]

bonjour à tous,

Des plugins existent pour créer une doc d'un projet à partir des commentaires de type

/**
* Cette fonction formate et affiche une chaîne de caractères dans la sortie standard.
* @author Hugo ETIEVANT
* @param str Chaîne à afficher
* @param format Chaîne décrivant le format d'affichage
* @since 3.2
* @return un booléen valant True si l'affichage c'est bien passé, False sinon
*/

Je souhaiterais savoir, pour ne pas perdre de temps à chaque fois, s'il existe un outil intégré ou intégrable à NetBeans pour créer ses commentaires sans savoir les créer (...) En gros, vulgairement, une interface graphique qui nous pose des questions, auxquelles on répond et hop il construit le commentaire. Non dans un but de Doc par la suite (mais pourquoi pas), mais surtout pour l'auto-complétition. Et aussi pour me motiver à commenter davantage mon code

Merci à vous, bonne soirée !

[bulbo]

Salut,

Intégré à NetBeans (en tout cas je l'ai dans la 6.9.1) tu vas dans le menu Tools -> Analyze javadoc.

Ca t'ouvre une vue ou tu peux checker le package ou la classe ou la méthode etc que tu veux commenter et ça te crée automatiquement les tags du genre @param, @return.

Par contre pas de question ou d'éditeur pour saisir la doc dans la foulée, mais en cliquant sur les items dans la vue analyzer ça te met le curseur de ton éditeur au bon endroit et tu n'as plus qu'à.

Bulbo

[devlop78]

Je ne l'ai pas dans tools. C'est tout à fait l'outil, cela evite les copier coller des éléments

[bulbo]

Il faut sélectionner un fichier java soit dans le Project Tree soit un fichier ouvert pour voir l'item dans le menu Tools ... tu travailles avec quelle version de NetBeans ?

Bulbo

[devlop78]

Ahhhh je suis arrivé dans ce forum avec des raccourcis de Zend Framework / PHP. Je pense qu'effectivement nous n'avons pas les mêmes fonctionnalités.

J'ai Netbeans PHP uniquement, la version 7.

[bulbo]

Ca c'est bien possible malheureusement.

Apparemment en PHP /** et Entrée crée automatiquement la section de commentaire correspondant à la méthode juste en dessous, comme en java. Du moins de ce que j'en ai lu rapidement sur le forum Netbeans.

Sinon jette un oeil au plugin Doxygen pour Netbeans on ne sait jamais

Bulbo