Originariamente inviato da Yasha
Ora però mi viene un dubbio.
Io ho dei file con una classe public e magari altre classi nello stesso file.
Ex una classe che estende JPanel pubblica che contiene altre classi che estendono JPanel, queste sono nello stesso file ma non public.

In questo caso come dovrei commentare? Devo mettere ogni classe in un file separato?
A livello di scrittura dei commenti Javadoc non cambierebbe niente. Cambia semmai il fatto che il tool javadoc per default (ma si può cambiare) considera solo classi/membri public o protected. Quindi se in un sorgente hai più classi "top-level" dichiarate, solo una, secondo le regole, può essere public. Pertanto per default javadoc non tratterebbe le altre con accesso package-level.

E il fatto di mettere ogni classe "top-level" in un sorgente a sé stante è l'approccio tipico/consigliato per rendere le cose più chiare e "pulite".