In Java gibt es drei Arten von Kommentaren:
- Die von C bekannten Kommentare, die mit /* eingeleitet
und mit */ beendet werden.
- Kommentare, die mit // eingeleitet werden. Alle Zeichen
hinter // bis zum Ende der Zeile gelten als Kommentar und werden
ignoriert.
- Als dritte Syntax kennt Java Kommentare, die mit /** beginnen
und mit */ enden. Solche Kommentare können vom Programm javadoc ausgewertet werden, das zu einer Klasse eine Dokumentation im HTML-Format
erzeugen kann. Hierzu kann javadoc spezielle Tags auswerten, welche im Anhang B.6 näher beschrieben sind.
Die Kommentare der ersten und dritten Art dürfen nicht geschachtelt werden.
Es ist dagegen zulässig, dass nach einem durch // eingeleiteten Kommentar
diese beiden Zeichen in der gleichen Zeile wiederholt vorkommen.
Kommentare dürfen nicht innerhalb von Literalen oder Bezeichnern stehen.
/* Die Zeichen // werden hier ignoriert. */
/** Ein Kommentar... /* // und jetzt das Ende */
// Die nächste Zeile ist illegal.
/** /* Das ist geschachtelt */ */