Java tiene dos clases de comentarios:

  • Comentarios de implementación
  • Comentarios de Documentación

Los comentarios de implementación, son los clásicos comentarios conocidos de C/C++, utilizando doble barra // para comentar una línea, o delimitando el texto comentado /* */.

Los comentarios de documentación, conocidos como "doc comments", /** */, pueden ser exportados a HTML utilizando la herramienta javadoc.

En resumen, con estos dos tipos de comentarios, podemos decir que existen tres formas diferentes de escribir comentarios, y se resumen en el siguiente código:

// Este es un comentario solo para esta línea

/* Este es
un comentario
escrito en varias líneas
*/

/** este es un comentario de documentación,
puede tene varias líneas
y será de utilidad para que javadoc genere la documentación
*/

Vía: Programación en Java