<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="plugin-code-comment" xml:lang="fr">

  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-additional-plugins"/>  
    <revision version="3.4" date="2013-02-24" status="review"/>
    <revision pkgversion="3.34" date="2020-02-09" status="review"/>

    <credit type="author">
      <name>Jim Campbell</name>
      <email its:translate="no">jwcampbell@gmail.com</email>
    </credit>

    <desc>Mettre en commentaire ou décommenter un bloc de code.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Vincent Untz</mal:name>
      <mal:email>vuntz@gnome.org</mal:email>
      <mal:years>2006.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jonathan Ernst</mal:name>
      <mal:email>jonathan@ernstfamily.ch</mal:email>
      <mal:years>2006.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Philippe Lefevre</mal:name>
      <mal:email>ph.l@libertysurf.fr</mal:email>
      <mal:years>2006.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Christophe Bliard</mal:name>
      <mal:email>christophe.bliard@trux.info</mal:email>
      <mal:years>2006.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Claude Paroz</mal:name>
      <mal:email>claude@2xlibre.net</mal:email>
      <mal:years>2007-2011.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bruno Brouard</mal:name>
      <mal:email>annoa.b@gmail.com</mal:email>
      <mal:years>2011.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Luc Pionchon</mal:name>
      <mal:email>pionchon.luc@gmail.com</mal:email>
      <mal:years>2011.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alain Lojewski</mal:name>
      <mal:email>allomervan@gmail.com</mal:email>
      <mal:years>2011-2013.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alexandre Franke</mal:name>
      <mal:email>alexandre.franke@gmail.com</mal:email>
      <mal:years>2013.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jean-Marc Tissières</mal:name>
      <mal:email>jmetissieres@gmail.com</mal:email>
      <mal:years>2023.</mal:years>
    </mal:credit>
  </info>

  <title>Commentateur de code</title>

  <p>Des commentaires de code sont des fragments de texte qui permettent aux personnes de comprendre le code d’un programme mais qui n’affectent pas la façon dont le code fonctionne. Les commentaires sont séparés des autres parties d’un programme par des caractères spéciaux.</p>
  
  <p>Le greffon <app>Commentateur de code</app> rend plus facile et plus rapide la création ou la suppression de commentaires de code.</p>

  <steps>
    <title>Activation du greffon :</title>
    <item>
      <p>Appuyez sur le bouton du menu dans le coin supérieur droit de la fenêtre et sélectionnez <guiseq><gui style="menuitem">Préférences</gui> <gui style="tab">Greffons</gui></guiseq>.</p>
    </item>
    <item>
      <p>Sélectionnez <gui style="menuitem">Commentateur de code</gui> pour activer le greffon.</p>
    </item>
  </steps>
  
  <steps>
    <title>Pour créer ou supprimer un commentaire :</title>
    <item>
      <p>Sélectionnez le morceau de texte que vous souhaitez mettre en commentaire ou décommenter.</p>
    </item>
    <item>
      <p>Pour ajouter un commentaire, appuyez sur le bouton droit de la souris et sélectionnez <gui style="menuitem">Commenter le code</gui>, ou appuyez sur <keyseq><key>Ctrl</key> <key>M</key></keyseq>.</p>
    </item>
    <item>
      <p>Pour supprimer un commentaire, appuyez sur le bouton droit de la souris et sélectionnez <gui style="menuitem">Décommenter le code</gui>, ou appuyez sur <keyseq><key>Maj</key> <key>Ctrl</key><key>M</key></keyseq>.</p>
    </item>
  </steps>
  
  <note style="tip">
    <p><app>gedit</app> utilise automatiquement le style correct de commentaire en se basant sur le langage ou la syntaxe du fichier. Si <app>gedit</app> n’arrive pas à identifier votre langage ou syntaxe, vous pouvez le sélectionner dans la liste des langages de la <gui>barre d’état</gui> inférieure.</p>
  </note>

</page>
