summaryrefslogtreecommitdiffstats
path: root/help/C/gedit-search-and-replace.page
blob: dc54561e8628802ebded22e4a7228479a96a1b49 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
<page xmlns="http://projectmallard.org/1.0/"
      type="guide"
      id="gedit-search-and-replace">

  <info>
    <link type="guide" xref="index#gedit-working-with-files" group="sixth" />
    <desc>Find and replace portions of text in a file.</desc>
  </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>
        Select <gui>Match Case</gui> to make the search case sensitive.
      </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>Using escape sequences</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>Newline</p>
      </item>
      <item>
        <title>\r</title>
        <p>Carriage return</p>
      </item>
      <item>
        <title>\t</title>
        <p>Tab</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>