Créez commentaires Javadoc spéciaux. Pour désigner un commentaire javadoc, démarrer le commentaire avec /. commentaires Javadoc existent généralement en haut d'un fichier, avant que les classes et méthodes avant. Depuis il est conçu pour une documentation complète de l'API, il est pas rare de voir des fichiers avec plus de commentaires javadoc que code.""/
Ceci est un commentaire javadoc. Il ne possède pas de javadoc méta-tags encore, mais il l'a fait déclencher l'analyseur de javadoc à jeter un oeil à ce commentaire.
/""
Ajouter API méta-tags (balises qui décrivent l'API elle-même), en commentant. balises de l'API sont les noms des paramètres, des descriptions, des profils d'exception, des descriptions de valeur de retour, les noms de méthodes et descriptions de méthodes. Beaucoup d'IDE intègrent ces données dans leurs conseils d'outils et autres aides, ainsi que cela est pour une utilisation sous forme de HTML ou un commentaire.
Utilisez la description de la méthode. Cette méta-tag n'a pas de nom de tag: Il est tout simplement le commentaire qui vient avant les autres balises.""/ *
Calcule la pente d'une ligne.
* /""
Incorporer descriptions de paramètres. Ceux-ci sont désignés par lesparam méta-tags, qui devraient être suivies par un nom de paramètre et description.""/ *
Calcule la pente d'une ligne.
param p1 Premier point qui décrit la ligne
param Deuxième point p2 qui décrit la ligne
/""
Retour descriptions des valeurs. Ceci est indiqué par le méta-tagreturn et devrait être suivie par une description de la valeur de retour.""/ *
Calcule la pente d'une ligne.
param p1 Premier point qui décrit la ligne
param Deuxième point p2 qui décrit la ligne
Pentereturn de la ligne comme un flotteur
* /""
Ajouter des balises d'attribution. Les balises attribuent le code pour un auteur spécifique.""/ *
Calcule la pente d'une ligne.
Author Jack Smith
param p1 Premier point qui décrit la ligne
param Deuxième point p2 qui décrit la ligne
Pentereturn de la ligne comme un flotteur
/""
Générer la documentation HTML. Si vous n'êtes pas en utilisant un IDE ou vous voulez simplement de le faire manuellement, vous pouvez exécuter le programme en ligne de commande javadoc du répertoire de votre projet. Spécifiez le répertoire de sortie avec le commutateur -d et transmettre une liste de fichiers .java (généralement comme un joker).""docs de javadoc -d * .java""