CKTIS / Java
Comentarios y documentación en Java
Comentarios y documentación en Java: Java reconoce comentarios de línea //, de bloque /* ... */ y de documentación /** ... */; javadoc interpreta etiquetas y genera documentación de API.
Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxis
commentsJava reconoce comentarios de línea //, de bloque /* ... / y de documentación /* ... */; javadoc interpreta etiquetas y genera documentación de API.
Usa Javadoc para el contrato de una API pública con @param, @return y @throws, y {@code ...} para mostrar identificadores y fragmentos de código con seguridad.
Los comentarios de bloque no se anidan: comentar código que contiene */ cierra el comentario antes; un comentario obsoleto es peor que un nombre preciso.
Los escapes Unicode se procesan antes de tokenizar: \u000a dentro de // puede convertirse en fin de línea y hacer que el texto posterior se compile como código.
Los comentarios // y /* ... */ no cambian la ejecución de int value = 7; la única línea de salida 7 confirma que se tratan como comentarios.
Ejemplos
public class Main {
public static void main(String[] args) {
int value = 7; // this comment does not change the expression
/* A block comment can span lines. */
System.out.println(value);
}
}
Resultado
7
Los comentarios // y /* ... */ no cambian la ejecución de int value = 7; la única línea de salida 7 confirma que se tratan como comentarios.