Lidar com Javadoc comentários no Eclipse
Quando você usar o Eclipse para escrever o código Java, não se esqueça de editar os comentários Javadoc (as coisas que começam com / **). Você pode adicionar informações úteis quando você editar os comentários Javadoc, e como você editá-los, o código do Eclipse auxiliar oferece sugestões. Lembre-se essas dicas como você editar seus comentários Javadoc:
Adicionar um comentário Javadoc: Coloque o cursor no editor, no ponto onde o novo comentário Javadoc pertence. Em seguida, escolha Fonte em Adicionar Javadoc comentário na barra de menu principal.
Criar páginas de Javadoc de comentários Javadoc existentes: Selecione os projetos ou arquivos de origem cujas páginas Javadoc você deseja criar. (Selecione-los no Package Explorer, a vista Navigator, a vista de destaques, ou em um editor.) Em seguida, na barra de menu principal, escolha Project-Gerar Javadoc.
Ver uma página Javadoc existente: Selecione o elemento cuja página Javadoc que você quer ver. (Selecione-o no Package Explorer, a vista de destaques, ou em um editor.) Em seguida, na barra de menu principal, escolha Navegar-Open Javadoc externo.