Geração de Javadoc

O assistente Abre o assistente de Javadoc Geração de Javadoc permite gerar Javadoc. Trata-se de uma interface para a ferramenta javadoc.exe disponível no JDK Java. Visite a página da Ferramenta de Javadoc de Sun para obter a documentação completa de uma ferramenta de Javadoc.

Primeira página

Selecção do Tipo:

Opção

Descrição

Comando para Javadoc

Especificar o comando a utilizar para gerar o javadoc.

Seleccionar tipos para onde será gerado o Javadoc

Na lista, marque ou desmarque as caixas de verificação para especificar exactamente os tipos que pretende exportar. Esta lista é iniciada pela selecção da área de trabalho.

Criar Javadoc para membros com visibilidade

  • Privada: Todos os membros serão documentados
  • Pacote: Apenas os membros com visibilidade predefinida, protegida ou pública serão documentados
  • Protegida: Apenas os membros com visibilidade protegida ou pública serão documentados
  • Pública: Apenas os membros com visibilidade pública serão documentados (predefinição)


Utilizar Doclet Padrão

Iniciar o comando de Javadoc com o doclet padrão (predefinição) 

  • Destino: seleccione o destino em que o doclet padrão vai escrever a documentação gerada. O destino é um argumento específico de doclet, não estando activo quando utilizar um doclet personalizado.


Utilizar Doclet Personalizado

Utilizar um doclet personalizado para gerar documentação 

  • Nome do doclet: Nome de tipo qualificado do doclet
  • Caminho de classe do doclet: O caminho de classe necessário à classe de doclet


Argumentos de doclet padrão

Argumentos de Doclet Padrão (disponíveis quando Utilizar doclet padrão for seleccionado):

Opção

Descrição

Título do documento

Especifique um título do documento.
Gerar página utilizar Seleccione esta opção se pretende que a documentação contenha m uma página Utilizar.
Gerar árvore de hierarquia Seleccione esta opção caso pretenda que a documentação contenha uma página Árvore.

Gerar barra de navegador

Seleccione esta opção caso pretenda que a documentação contenha uma barra de navegação (cabeçalho e pá de página).
Gerar índice Seleccione esta opção caso pretenda que esta documentação contenha uma página Índice.
Separar índice por letra Criar um índice por letra. Activado quando Gerar Índice for seleccionado. 
@author Seleccione esta opção caso pretenda que o identificador @author seja documentado.
@version Seleccione esta opção caso pretenda que o identificador @version seja documentado.
@deprecated Seleccione esta opção caso pretenda que o identificador @deprecated seja documentado.
lista desactualizada Seleccione esta opção caso pretenda que a documentação contenha uma página Obsoleto. Activado quando a opção  @deprecated for seleccionada.
Seleccionar classes referenciadas a que o Javadoc deve criar ligações Especifique a que outra documentação o Javadoc deve criar ligações quando forem referenciados outros tipos. 
  • Seleccionar tudo: Criar ligações a todas as outras localizações de documentação
  • Limpar Tudo: Não criar ligações a outras localizações de documentação
  • Configurar: Configurar a localização de Javadoc de um JAR ou projecto referenciado.
Folha de estilo Seleccionar a folha de estilo a utilizar

Argumentos gerais

Opções Gerais de Javadoc:

Opção

Descrição

Descrição Geral

Especifica que o Javadoc deve obter o texto para a documentação de descrição geral de um determinado ficheiro. Será colocado em overview-summary.html.

Opções da VM

Adicione um número de opções extra da VM aqui.

Opções extra de Javadoc

Adicione um número de opções extra da VM aqui: Opções doclet personalizadas ou opções de compatibilidade de JRE 1.4.
Repare que os argumentos que contêm espaços têm de estar entre aspas. Para argumentos que especifiquem um código html (p.ex. -header), utilize &  ou &" para evitar espaços e aspas.

Compatibilidade de origem JRE

A compatibilidade de origem JRE a ser aceite pela ferramenta javadoc.

Guardar as definições desta exportação de Javadoc como um script Ant

Especifique o armazenamento de um script Ant que vai executar a exportação especificada de Javadoc sem ter de utilizar o assistente. O script Ant existente pode ser modificado com este assistente (Utilizar 'Abrir assistente de Javadoc' no menu contextual no script Ant gerado)

Abrir o ficheiro de índice gerado no browser Abre o ficheiro index.html gerado no browser (Apenas disponível ao utilizar o doclet padrão)

Prima  Terminar para iniciar a geração de Javadoc. Se o destino for diferente para a localização configurada na página Localização de Javadoc do projecto, Ser-lhe-á perguntado se pretende definir a localização de Javadoc do projecto na nova pasta de destino. Ao fazê-lo, todas as invocações de Abrir Javadoc Externo utilizarão a documentação agora criada.

Será iniciado um novo processo e a geração será executada em segundo plano. Abra a vista Consola (Janela > Mostrar Vista > Consola) para ver o progresso e o estado da geração.

Tarefas relacionadas

Criar documentação de Javadoc

Referência relacionada

Acções de ficheiro
Propriedades de Localização de Javadoc