<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="gedit-search-and-replace" xml:lang="fr">

  <info>
    <link type="guide" xref="index#gedit-working-with-files" group="sixth"/>
    <desc>Find and replace portions of text in a file.</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-2014.</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>Julien Hardelin</mal:name>
      <mal:email>jhardlin@orange.fr</mal:email>
      <mal:years>2013.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Guillaume Bernard</mal:name>
      <mal:email>associations@guillaume-bernard.fr</mal:email>
      <mal:years>2018</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Charles Monzat</mal:name>
      <mal:email>charles.monzat@free.fr</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

  <title>Search and replace</title>

  <links type="topic" groups="first"/>

  <section>
    <title>The simple search</title>
    <p>
      To open the search entry field, click on:
    </p>
    <p>
      <guiseq>
        <gui style="menu">Menu Button</gui>
        <gui style="menuitem">Find…</gui>
      </guiseq>
    </p>
  </section>

  <section>
    <title>The search and replace</title>
    <p>
      To open the Find and Replace dialog, click on:
    </p>
    <p>
      <guiseq>
        <gui style="menu">Menu Button</gui>
        <gui style="menuitem">Find and Replace…</gui>
      </guiseq>
    </p>
  </section>

  <section>
    <title>Clear highlight</title>
    <p>
      Usually, the text that you've searched for will remain highlighted in the
      document. To remove the highlight, click on:
    </p>
    <p>
      <guiseq>
        <gui style="menu">Menu Button</gui>
        <gui style="menuitem">Clear Highlight</gui>
      </guiseq>
    </p>
  </section>

  <section>
    <title>Tips</title>
    <p>
      If you first select a portion of text in the document, and then start a
      simple search or open the Find and Replace dialog, the text you've
      selected will appear in the search entry.
    </p>
  </section>

  <section>
    <title>Search options</title>
    <p>
      The Find and Replace dialog presents the search options as check boxes.
    </p>
    <p>
      For the simple search, click on the
      <gui style="button">Magnifying Glass</gui> icon in the search entry field.
    </p>
    <list>
      <item><p>Sélectionnez <gui>Respecter la casse</gui> pour rendre la recherche sensible à la casse.</p></item>
      <item>
        <p>
          Select <gui>Match Entire Word Only</gui> to search for a specific word
          without including fragments of other words.
        </p>
        <p>
          For example, if you searched for the word “and” with this option
          selected, the word “and” would be matched, but the words
          “sand” and “comm<em>and</em>er” would not be matched.
        </p>
      </item>
      <item><p>
        Select <gui>Wrap Around</gui> to continue at the other end of the
        document when going to the next or previous search result.
      </p></item>
    </list>
  </section>

  <section>
    <title>Utilisation des séquences d’échappement</title>
    <p>
      In a search or replace entry, you can use <em>escape sequences</em> with
      the following meanings:
    </p>
    <terms>
      <item>
        <title>\n</title>
        <p>Nouvelle ligne</p>
      </item>
      <item>
        <title>\r</title>
        <p>Retour à la ligne</p>
      </item>
      <item>
        <title>\t</title>
        <p>Tabulation</p>
      </item>
      <item>
        <title>\\</title>
        <p>
          Backslash. If you actually want a backslash and avoid one of the above
          special meanings, the backslash needs to be escaped.
        </p>
      </item>
    </terms>
  </section>
</page>
