Os comentários JavaDoc permitem documentar o código das classes, sendo possível adicionar algumas tags nos comentários. Estas tags serão depois processadas pela ferramenta javadoc no processo de geração da documentação em formato HTML da classe.
Qualquer comentário JavaDoc começa com /** e termina com */ e consiste numa descrição de uma classe, método ou atributo. Um comentário JavaDoc pode conter várias tags.
Para gerar a documentação em formato HTML, é necessário executar o seguinte comando na linha de comandos

$ javadoc packageName
que irá gerar toda a documentação das classes que pertencem ao package packageName. Caso queira gerar apenas a documentação de uma classe, então deve executar o seguinte comando:
$ javadoc className

Cada comentário JavaDoc deve ser colocado antes da classe, método ou atributo que ser quer documentar. As várias tags que se podem utilizar dentro de um comentário JavaDoc (algumas só fazem sentido em determinados casos, por exemplo @param só deve ser utilizado em métodos) são as seguintes:
  • @see - indica uma classe ou outro método que é relevante para o que está a ser documentado. Só faz sentido ser utilizado 
 Tag                                      Significado Aplicado                         
 @see Indica uma classe ou um método que é relevante para o que está ser documentado. Vai corresponder a um link para a documentação da classe ou método em causa. Classe ou método
 @author Informação do nome do autor, como nome, email, website, etc. Classe
 @version Informação da versão da classe, interface ou tipo enumerado. Classe
 @param Descrição de um parâmetro de um método ou construtor. Cada parâmetro deve ser documentado utilizando o formato @param nomeParâmetro descrição Método
 @return Descrição da valor de retorno de um método. Deve descrever os diferentes valores de retorno que um método pode devolver. Método
 @exception Descrição de uma excepção que pode ser lançada pelo método. Cada excepção que um método pode lançar deve ser descrita utilizando esta tag com o seguinte formato @exception ClassExceptionName descrição de quando é que o método pode lançar a excepção Método
 @throws Semelhante ao caso anterior. Método
 @deprecated Define o elemento documentado como sendo obsoleto. É utilizado pelo compilador para gerar um aviso caso se use o elemento em causa. Classe ou método
 @since A versão da API em que esta classe, método ou atributo foi adicionado. Todos