Comentarios
Un comentario es un texto que se escribe dentro de un programa con el fin de facilitar la comprensión del mismo. Los comentarios se utilizan para explicar y documentar el código fuente. En Java se pueden utilizar tres tipos de comentarios:
Comentario tradicional estilo C/C++.
Empieza con los caracteres / y acaba con /.
Pueden ocupar más de una línea y pueden aparecer en cualquier lugar donde pueda aparear un espacio en blanco. No pueden anidarse.
Ejemplos de comentarios estilo C/C++:
/* Programa Ecuación segundo grado
Calcula las soluciones de una ecuación de segundo grado */
/ Lectura de datos por teclado /
Comentarios de una sola línea.
Comienzan con una doble barra ( // ) y se pueden extender hasta el final de la línea. No tienen carácter de terminación.
Ejemplos de comentarios de una sola línea:
// Programa Ecuación segundo grado
// Calcula las soluciones de una ecuación de segundo grado
int p; // precio del producto
Comentarios de documentación Javadoc.
Son comentarios especiales para generar documentación del programa.
Comienza con /* y termina con /
Ejemplo de comentario de documentación Javadoc:
/**
*
-
@author Enrique
-
@version 1.0
*
*/