## Écrire des programmes plus complexes

Maintenant que vous savez écrire des choses sur le sol, nous allons utiliser cette compétence pour dessiner un merveilleux G par terre. Consultez le panneau d'objectif pour les détails de ce qui est attendu.

Quand vous écrivez un programme un peu complexe, il est souvent pratique d'ajouter des commentaires pour simplifier la relecture du code après coup. Ici par exemple, il est assez facile de se perdre dans les ordres nécessaires au dessin. Il peut être pratique d'ajouter des commentaires comme fin de la barre verticale ou Fini de dessiner le G. Retournons à la position initiale. Documenter votre code est presque toujours nécessaire si quelqu'un (vous ou quelqu'un d'autre) veut le lire après coup. Cependant, sur-commenter des choses triviales est une mauvaise idée car cela dilue les informations dans des commentaires trop verbeux.

Il y a [!java]trois[/!][!python|scala|c]deux[/!] sortes de commentaires en [!thelang], indiquant [!java|scala|c]au compilateur[/!][!python]à l'interpréteur[/!] qu'il ne doit pas lire le texte ajouté pour les humains :

- Commentaires sur une seule ligne. Quand le [!java|scala|c]compilateur[/!][!python]interpréteur[/!] rencontre le symbole [!java|scala|c]//[/!][!python]#[/!], il ignore la fin de la ligne.
- Commentaires sur plusieurs lignes. [!java|scala|c]Le compilateur[/!][!python]L'interpréteur[/!] ignore tout ce qui se trouve entre [!java|scala|c]les symboles /* et */, même s'ils sont sur des lignes différentes.[/!] [!python]une ligne commençant par ''' et la prochaine ligne terminant par '''.[/!]

    methodeAppeleeParLe[!java|scala|c]Compilateur[/!][!python]Interpreteur[/!]()[!java|c];[/!] [!java|scala|c]//[/!][!python]#[/!] tout ceci est ignoré
    autreAppel()[!java|c];[/!] [!java|scala|c]/* Ceci est
                   également ignoré */[/!]
    [!python]''' Ceci est
    également ignoré '''[/!]
    encoreUneAutreAppel()[!java|c];[/!]

Il existe une troisième forme de commentaires en Java, entre /** et */, qui sont lus par un programme nommé JavaDoc pour générer automatiquement la documentation expliquant comment utiliser le code. Ces commentaires doivent suivre un formalisme précis.

Les commentaires sur plusieurs lignes sont souvent utilisés pour documenter comment utiliser le code, tandis que les autres types de commentaires sont souvent utilisés pour documenter comment le code fonctionne.