Est-ce que "/* (non-javadoc)" a un sens bien compris?

Ne /* (non-javadoc) ont un sens, au-delà de montrer au lecteur de code source à un bloc de commentaire est intentionnellement pas un commentaire Javadoc? Dernièrement, j'ai vu beaucoup de code qui ressemble à ceci:

/*
 * (non-javadoc)
 *
 * This method converts widgets to gizmos
 */
public Foo bar() {
   ...

S'agit-il d'une convention établie? Si oui, que signifie-t-il (au-delà du sens littéral évident) et quand est-il utilisé?

28
demandé sur Pops 2011-01-04 22:04:37
la source

2 ответов

selon la info que j'ai pu trouver , il s'agissait de corriger un bug dans les versions plus anciennes de L'outil JavaDoc (ou plus probablement la version plus ancienne du traitement des commentaires JavaDoc par Eclipse) qui n'afficherait pas la documentation correcte pour une méthode qui supplante la méthode d'une classe parent.

comme L'a noté Konstantin, le modèle de dérogation D'Eclipse inclut ce texte.

19
répondu Powerlord 2014-08-13 23:14:46
la source

il n'a pas de sens établi à part être un commentaire. Le formatage est le résultat de gabarits communs de formatage de code Eclipse, ce qui explique son caractère commun.

16
répondu Konstantin Komissarchik 2011-01-04 22:08:04
la source

Autres questions sur