COMENTARIOS EN JAVA

¿Cómo agregar comentarios en Java?

El propósito de agregar comentarios dentro del código , es que este no interfiera con el código, que al compilarse (cuando se cree el programa) haga como si no existiera. Existen tres formas de agregar comentarios, aunque la mayoría (me incluyo) solo utiliza las dos primeras formas.

Primera forma:

Fácil de recordar, solo debemos insertar dos barras inclinadas //. esto hará que toda esa linea de texto se considere un comentario.

//Mi comentario

Segunda forma

Con esto podemos comentar varias líneas de texto. Primero escribimos /* antes del comentario y al final escribimos */

/* Este es
un comentario 
con varias líneas */

Si se te olvida como usarlo solo fíjate en la parte numérica de tu teclado de izquierda a derecha se encuentra el "/" y después el "*", esto para abrir el comentario, y para cerrarlo solo al revés de derecha a izquierda. Así es como lo recuerdo para no confundirme con otros lenguajes que usan símbolos parecidos para agregar comentarios. 

Tercera forma:

Usada en la herramienta de documentación JavaDoc. Estos comentarios aparecen en un archivo generado en HTML (JavaDoc=una pagina web con los comentarios) bien estructurado y ordenado, muy utilizado por las empresa para documentar el código de su software. 

Para comentar primero escribes /** y al final */

Ejemplo

/**Comentario para documentos JavaDoc*/

Insertar comentarios es una actividad muy útil en todo tipo de proyectos, nos permite recordar o  avisar a alguien si se agregó, elimino o modifico algo del contenido. Es muy recomendable usarlos siempre, incluso puedes usarlos solo para agregar ocultamente tu firma al proyecto jjeje.