## A escrever programas mais complexos

Agora que sabemos como desenhar coisas no tabuleiro, vamos aproveitar esta habilidade e desenhar um belo G (Veja o painel de Objetivo para detalhes).

Quando escreve um programa bem complexo, por vezes é útil adicionar comentários para simplificar uma posterior revisão do código. Aqui, por exemplo, é fácil se perder no processo de desenho e podeadicionar comentários como barra vertical desenhada ou terminei de desenhar o G. hora de voltar para posição inicial. Comentar o seu código é quase obrigatório se (ou mais alguém) quiser lê-lo depois, embora comentar demais (a descrever coisas óbvias) é ruim pois as ideias importantes se perdem no meio do ruído.

Existem [!java]três[/!][!python|scala|c]dois[/!] tipos de comentários em [!thelang], que instruem o [!java|scala|c]compilador[/!][!python]interpretador[/!] a não ler o texto que adiciona para humanos:

- Comentários de uma única linha. Quando o [!java|scala|c]compilador[/!][!python]interpretador[/!] encontra o símbolo [!java|scala|c]//[/!][!python]#[/!], ignora o resto da linha.
- Comentários em várias linhas. O [!java|scala|c]compilador[/!][!python]interpretador[/!] ignora tudo entre [!java|scala|c]os símbolos /* e */ mesmo quando eles são postos em linhas diferentes.[/!] [!python]uma linha a comaçar com ''' até a próxima linha terminado com '''.[/!]

    methodCallReadByThe[!java|scala|c]Compiler[/!][!python]Interpreter[/!]()[!java|c];[/!] [!java|scala|c]//[/!][!python]#[/!] tudo isto é ignorado
    otherCall()[!java|c];[/!] [!java|scala|c]/* Isto também
                   é ignorado */[/!]
    [!python]''' Isto também
    é ignorado  '''[/!]
    yetAnotherCall()[!java|c];[/!]

Existe um terceiro tipo de comentário em Java, entre /** e */, que é lido por um programa específico chamado JavaDoc para gerar automaticamente a documentação a explicar como usar o código. Estes comentários devem seguir um formalismo bem preciso.

Os comentários de várias linhas são frequentemente usados para documentar como usar o código, enquanto os outros são usados para descrever como este código funciona.