Conheça Kim

"Olha, outra mulher humana! Mas com cabelo escuro agora. Que divertido!"

"Oi, meu nome é Kim."

"Oi, meu nome é Amigo!"

"Eu sei. Eu criei o seu nome. Diego não teria pensado nisso."

Os pensamentos de Amigo dispararam na velocidade da luz. "Hum... ela é tão legal... Será que ela gosta de robôs?"

"Vamos voltar à lição. Eu vou usar palavras fáceis para explicar o material pra você."

"OK."

"Eu quero adicionar algumas palavras ao que o Professor e Rishi disseram."

"Em Java, você pode escrever comandos, mas também pode incluir comentários aos comandos no próprio código. O compilador ignora todos os comentários. Quando o programa é executado, todos os comentários são omitidos."

"Me dê um exemplo, por favor."

"Ah, 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");
    }
}    

"Incluímos o comentário 'Agora vamos exibir a frase...' O começo do comentário é indicado por um par de símbolos (/*) e o final por (*/). Quando o programa é compilado, o compilador omite tudo que estiver entre os símbolos /* e */."

"Isso significa que eu posso escrever o que quiser?"

"Sim. Em geral, comentários no código se referem a partes do código que são difíceis de entender. Alguns comentários consistem em dezenas de textos, em geral escritos antes dos métodos, para descrever nuances sobre como os métodos funcionam."

"Há mais de uma maneira de adicionar comentários ao código. Você pode usar duas barras (//)."

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");
    }
}

"Aqui, o código que começa com // e vai até o fim da linha que contém o // é considerado um comentário. Em outras palavras, não é usado nenhum outro par de símbolos para 'encerrar o comentário'."

"Inclusive, alguns comentários são muito interessantes."

// 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

"Sim, alguns comentários são muito engraçados."

"Por hoje é só."

"Esta foi uma lição curta mas interessante. Obrigado, Kim."