Pourquoi les commentaires Javadoc sont-ils ignorés ?
pour les autres outils travaillant sur vos codes sources, les commentaires Javadoc passent pour de simples commentaires et sont donc ignorés. Effectivement le format de commentaire Javadoc /** ... */et un cas particulier des commentaires multi-lignes Java /* ...
Comment faire un commentaire Javadoc ?
La première règle, nous l'avons déjà citée : un commentaire Javadoc se place toujours au-dessus de l'élément à documenter. Voici un exemple de commentaire Javadoc décrivant la classe Rational. 1 2 3 4 5 6 7 8 9 /** * Cette classe permet de manipuler le concept de nombres rationnels (de fractions).
Comment créer une documentation Javadoc ?
Plus sélectionner l'option « Générer la Javadoc ». Un menu avec des options apparait. Remplissez le champ « Commande Javadoc » si ce n'est pas déjà fait. Ensuite, vous pouvez sélectionner les différents packages que vous voulez documenter, ainsi que la visibilité de la documentation.
Comment décrire un paquetage Javadoc ?
Les commentaires Javadoc précèdent généralement les déclarations de classes, d'attributs et de méthodes. Il est également possible de décrire un paquetage, en créant un fichier package-info.java dans le dossier correspondant, dans lequel on inclut un commentaire Javadoc. Un tag Javadoc commence par une @ ( arobase ).