Te presentamos a Kim

«¡Vaya, otra humana! Aunque esta vez es morena. ¡Qué interesante!».

«Hola, me llamo Kim».

«Hola, yo me llamo Amigo».

«Sí, ya lo sé. Fui yo la que inventó tu nombre. Diego no lo habría pensado».

Los pensamientos de Amigo se sucedieron a velocidades electrónicas. «Hum... Qué guapa es... Me pregunto si le gustan los robots».

«Volvamos a la lección. Voy a explicarte el material con palabras sencillas».

«Vale».

«Me gustaría añadir alguna cosa a lo que ya te han contado Rishi y el profesor».

«En Java, puedes escribir comandos, pero también añadir comentarios a esos comandos directamente en el código. El compilador hará caso omiso a tus comentarios. Cuando se ejecuta el programa, se omiten todos los comentarios».

«A ver un ejemplo, por favor».

«Sí, claro».

public class Home
{
    public static void main(String[] args)
    {
        /*
        Now we'll display the phrase 'Amigo Is The Best' on the screen
        */
        System.out.print("Amigo ");
        System.out.print("Is ");
        System.out.print("The ");
        System.out.print("Best");
    }
}    

«Hemos añadido el comentario “Ahora vamos a mostrar la frase...”. El comienzo del comentario se indica mediante un par de símbolos (/*) y dónde termina con los mismos símbolos, pero en orden inverso (*/). Cuando se compila el programa, el compilador omite todo lo que esté entre los símbolos /* y */.».

«¿Eso significa que puedo escribir lo que quiera?».

«Sí. Por lo general, los comentarios que hay en el código se refieren a partes difíciles de entender. Hay comentarios que tienen decenas de cadenas, a menudo escritas antes de los métodos para describir matices de su funcionamiento».

«Hay otra forma de añadir un comentario al código. Puedes usar dos barras diagonales (//)».

public class Home
{
    public static void main(String[] args)
    {
        System.out.print("Amigo ");
        System.out.print("Is The "); // This is also a comment
        System.out.print("Best");
    }
}

«Aquí, se considera comentario el código que empieza por // y va hasta el final de la línea que llevaba //. En resumen, que no existe un segundo par de símbolos que se utilicen para “terminar el comentario”».

«Por cierto, que algunos comentarios son realmente interesantes».

// I'm not responsible of this code. They made me write it, against my will.

// Dear future me. Please forgive me.
// I can't even begin to express how sorry I am.

// If I see something like this once more, I'll have a complete mental breakdown at work.

// If this condition is ever satisfied,
// please inform me for a reward. Phone: xxx-xxx-xxx.

// Dear maintainer:
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
// total_hours_wasted_here = 42

// When I wrote this, only God and I understood what I was doing
// Now, God only knows

// Sometimes I believe compiler ignores all my comments.

// I dedicate all this code, all my work, to my wife, Darlene, who will 
// have to support me and our three children and the dog once it gets 
// released into the public.

// Drunk, fix later

// Magic. Do not touch

«Sí, hay algunos comentarios muy graciosos».

«Eso es todo por hoy».

«Ha sido una lección breve pero interesante. Gracias, Kim».