Nas APIs Java, posso ver comentários do Javadoc para pacotes.
Como / onde coloco comentários Javadoc para documentar um pacote?
A partir da versão 1.5, você pode definir um package-info.java
arquivo e fornecer um comentário no estilo javadoc padrão para um pacote:
com / foo / package-info.java:
/**
* com.foo is a group of bar utils for operating on foo things.
*/
package com.foo;
//rest of the file is empty
Até o Java 1.4, inclusive, você precisava fornecer um arquivo HTML package.html, conforme descrito nas outras respostas.
Desde o Java 1.5, você também pode fornecer um
package-info.java
, que contém um comentário Javadoc regular (sem HTML). O último é o preferido, pois fornece alguns recursos extras (principalmente anotações de pacotes).Detalhes: documentos da Sun para javadoc
fonte
package-info.java
muito bem.Com um
package.html
arquivo no nível do pacote (ou seja, no diretório desse pacote). Este deve ser umHTML
arquivo totalmente formado , com a<html>
tag definida nelefonte