Siempre, cuando empezamos a aprender a desarrollar, sea el lenguaje que sea, nos inculcan un buen sistema para que siempre sepamos qué función realiza una porción de código concreta escrita, pero casi siempre, cuando ya tenemos un control bastante avanzado del lenguaje, se nos olvida escribir la parte más importante dentro de cualquier código fuente,  sí os hablo de los comentarios.

Los comentarios, son pequeñas porciones del código fuente escritas de tal forma que cuando vamos a compilar nuestro programa, el compilador ignora estas líneas, sólo son informativas, para recordarnos que hacía esa porción de código concreta.

Estos nos ayudará a refrescar bastante la memoria si escribimos un código, lo guardamos,  y volvemos a abrirlo y escribir más código después de 6 semanas. ¡Si no nos pasará como la viñeta superior, que seguro a más de uno nos ha pasado!

¿Pero sólo hay un tipo de comentario? No, normalmente hay como mínimo 2 o más en cada lenguaje, el comentario de línea o comentario en bloque (más de 1 línea).

Un comentario de línea comienza con un delimitador y continúa hasta el final de la línea de texto (es decir, no es necesario un segundo delimitador). En algunos lenguajes, el comentario de línea siempre comienza en una cierta columna no siendo necesario un delimitador.

Los delimitadores son una secuencia conocida de caracteres y suelen ser distintos para los comentarios de bloque que para los de línea. Por ejemplo, el lenguaje C++ usa los delimitadores /* y */ para los comentarios de bloque mientras que los comentarios de línea utilizan el delimitador //. Otros lenguajes solamente admiten un tipo de comentario. Por ejemplo, ADA solamente dispone de comentarios de línea mediante el delimitador .

Aquí os dejo un conjunto de ejemplos de comentarios en diversos lenguajes:

Ensamblador

[sourcecode language=”shell”]
;comentario
[/sourcecode]

Java

[sourcecode language=”java”]
//comentario de línea

/*comentario
de bloque*/

/**
comentario que será usado por javadoc
*/
[/sourcecode]

C/C++

[sourcecode language=”cpp”]
//comentario en línea

/* comentario
en bloque*/

#if 0
Comentario de bloque
aunque el bloque contenga
/* este tipo de comentarios */
#endif
[/sourcecode]

Ruby

[sourcecode language=”ruby”]
#comentario

=begin
comentario de bloque
=end
[/sourcecode]

Python

[sourcecode language=”python”]
#comentario
[/sourcecode]

Perl

[sourcecode language=”perl”]
#comentario
[/sourcecode]

Javascript

[sourcecode language=”javascript”]

En archivo .js pueden darse las siguientes formas:

//comentario en línea

/* comentario
en bloque */

En las páginas webs , aparte de las anteriores formas también está el comentario HTML:

<!–
sentencias javascript no obviadas
// –>
[/sourcecode]

SQL

[sourcecode language=”sql”]
//esto es un comentario
–este también

/* y este
en bloque */
[/sourcecode]

Visual Basic

[sourcecode language=”vb”]
‘comentario

”’comentario XML
[/sourcecode]

PHP

[sourcecode language=”php”]
//comentario en línea

#este también

/* comentario
en bloque */
[/sourcecode]

Cobol

[sourcecode language=”shell”]
* Comentario
[/sourcecode]

Viñeta | Coderfacts
Info | Wikipedia

[ad#anuncio_post]