1.4 COMENTARIO EN JAVA

Los comentarios se utilizan para explicar el código fuente.

Un comentario es un texto que se escribe dentro de un programa con el fin de facilitar la comprensión del mismo.

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:

/**
*
* @author Enrique
* @version 1.0
*
*/
realizado por Rene carachure

Los felicito por sus participaciones, y para una próxima ocasión los invito a contestar dentro de la sala de discusión que contiene los reactivos, ya que del modo en que usted lo ha hecho, en mi opinión, no es apropiado para contestar preguntas detonadoras, debido a que usted ha abierto una nueva sala, que en teoría se entiende deba utilizarse para un nuevo tema de discusión relacionado con el título del Foro, el cuál será respondido a su vez. Y al parecer con su participación, no ha iniciado algún tema de discusión, sino más bien pretende contestar algún reactivo de otra sala de discusión. Por lo tanto, lo invito para el próximo tema, contestar dentro de la sala, y puede generar nuevos temas afuera, si desea iniciar una nueva discusión en otra temática como una sala de discusión nueva.


ATTE:

M.C. Edgar Rangel Lugo.