web-dev-qa-db-fra.com

Comment générer des commentaires Javadoc dans Eclipse?

Duplicate possible:
générateur de modèles Javadoc

Est-il possible de générer des commentaires Javadoc dans Eclipse? Si oui, c'est quoi?

194
antony.trupe

Pour moi le /**<NEWLINE> ou Shift-Alt-J (ou --J sur un Mac) fonctionne mieux.

Je n'aime pas voir les commentaires Javadoc dans le code source qui ont été générés automatiquement et n'ont pas été mis à jour avec du contenu réel. En ce qui me concerne, ces javadocs ne sont qu'un gaspillage d'espace d'écran.

OMI, il est bien préférable de générer les squelettes de commentaires Javadoc un par un au fur et à mesure que vous allez renseigner les détails.

342
Stephen C

Shift-Alt-J est un raccourci clavier utile dans Eclipse pour la création de modèles de commentaires Javadoc.

L'appel du raccourci sur une déclaration de classe, de méthode ou de champ créera un modèle Javadoc:

public int doAction(int i) {
    return i;
}

Appuyer sur Shift-Alt-J sur la déclaration de méthode donne:

/**
 * @param i
 * @return
 */
public int doAction(int i) {
    return i;
}
78
coobird

JAutoDoc :

un Eclipse Plugin pour ajouter automatiquement des en-têtes de fichier et Javadoc à votre code source. Il génère éventuellement des commentaires initiaux à partir du nom de l'élément à l'aide de Velocitytemplates pour les en-têtes Javadoc et des fichiers ...

36
antony.trupe

Vous voulez dire dans le menu Projet -> Générer Javadoc?

26
Mirek Pluta

À un endroit où vous souhaitez utiliser javadoc, saisissez /** <NEWLINE> pour créer le modèle.

14
bmargulies