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 → Adicionar Javadoc comentário na barra de menu principal.
Criar páginas Javadoc de comentários Javadoc existentes: Selecionar os projetos ou arquivos de origem cujas páginas Javadoc você deseja criar. (Selecione-los no Package Explorer, a exibição 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 → Abrir Javadoc Externa.