Comentarios en línea y multilínea

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 para documentación. Realmente este tipo de comentario es el mismo que el de varias líneas con la diferencia de que la información que contenga será usada para un procesamiento especial que lleva a cabo la herramienta javadoc. Se distingue del comentario de varias líneas porque se agrega un asterisco adicional al inicio del comentario.

/**
Este tipo de comentarios los utiliza la
herramienta javadoc
*/