1<page xmlns="http://projectmallard.org/1.0/"
2      xmlns:its="http://www.w3.org/2005/11/its"
3      type="topic" style="task"
4      id="finding">
5
6  <info>
7    <link type="guide" xref="index#reading"/>
8    <revision pkgversion="3.2" date="2011-09-05" status="final"/>
9    <revision pkgversion="3.10.3" date="2014-03-22" status="review"/>
10    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
11    <revision pkgversion="3.15" date="2015-01-28" status="candidate"/>
12    <revision pkgversion="3.30" date="2018-11-25" status="candidate"/>
13
14    <credit type="author">
15      <name>Phil Bull</name>
16      <email its:translate="no">philbull@gmail.com</email>
17    </credit>
18    <credit type="editor">
19      <name>Anna Philips</name>
20      <email its:translate="no">anna.cs.au@gmail.com</email>
21    </credit>
22    <credit type="editor">
23      <name>Ekaterina Gerasimova</name>
24      <email its:translate="no">kittykat3756@gmail.com</email>
25    </credit>
26
27    <include href="legal-unported.xml" xmlns="http://www.w3.org/2001/XInclude"/>
28
29    <desc>Search for a word or phrase in a document.</desc>
30  </info>
31
32  <title>Find text in a document</title>
33
34  <steps>
35    <item>
36      <p>Click the <gui>Magnifying glass button</gui> or press
37      <keyseq><key>Ctrl</key><key>F</key></keyseq> or <key>/</key> to display a
38      search box.</p>
39    </item>
40    <item>
41      <p>Start typing into the search box and the search will start
42      automatically.</p>
43    </item>
44    <item>
45      <p>Use the <gui>∧</gui> and <gui>∨</gui> buttons to move to the previous
46      or next search result.</p>
47    </item>
48    <item>
49      <p>To hide the search bar, click the <gui>Magnifying glass button</gui>
50      again or press <key>Esc</key>.</p>
51    </item>
52  </steps>
53
54  <note style="tip">
55    <p>To filter words by case or completion, you can right click on the search
56    box and select <gui>Case Sensitive</gui> or <gui>Whole Words
57    Only</gui>.</p>
58  </note>
59
60  <p>If the word or phrase that you searched for is not found in the document,
61  you will see <media type="image" its:translate="no" src="figures/search-not-found.png"/> in the
62  search box. However, if it appears in the document at least once, you will be
63  shown how many times the search result appears on the current page.</p>
64
65  <note>
66    <p>Only PDF documents are searchable. Some PDF documents are not
67    searchable because their text is encoded in the document as an image.</p>
68  </note>
69
70</page>
71