summaryrefslogtreecommitdiff
path: root/common/locale/en-US/pattern.xml
blob: e874701268d66c8fff6c3ead0ee41e22fb99b488 (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
123
124
125
126
127
128
129
130
131
132
133
134
135
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>

<!DOCTYPE document SYSTEM "dactyl://content/dtd">

<document
    name="pattern"
    title="&dactyl.appName; Patterns"
    xmlns="&xmlns.dactyl;"
    xmlns:html="&xmlns.html;">

<h1 tag="text-find-commands">Text find commands</h1>
<toc start="2"/>

<p>
    &dactyl.appName; provides a Vim-like incremental find interface to
    replace &dactyl.host;'s crippled Typeahead Find. Among other improvements,
    our find service:
</p>
<ul>
    <li>
        Starts at the cursor position in the currently selected frame, unlike
        &dactyl.host;, which always starts at the beginning of the first frame
        for documents with more than one frame.
    </li>
    <li>
        Returns the cursor and viewport to their original position on cancel.
    </li>
    <li>
        Backtracks to the first successful match after pressing backspace,
        unlike &dactyl.host;, which will always continue from the last match.
    </li>
    <li>
        Supports reverse incremental find.
    </li>
    <li>
        Escape sequences to toggle link-only and case-sensitive find.
    </li>
</ul>

<p>
    Regular expression find, however, is not currently available unless the
    /Find Bar/ service is installed, in which case it may be toggled on with
    a find flag.
</p>

<item>
    <tags>/</tags>
    <spec>/<a>pattern</a><oa>/</oa><k name="CR"/></spec>
    <description>
        <p>Find <a>pattern</a> starting at the current caret position.</p>

        <p>
            The following escape sequences can be used to modify the
            behavior of the find. When flags conflict, the last to
            appear is the one that takes effect.
        </p>

        <dl dt="width: 6em;">
            <dt>\c</dt> <dd>Perform case insensitive find (default if <o>findcase</o>=<str>ignore</str>).</dd>
            <dt>\C</dt> <dd>Perform case sensitive find (default if <o>findcase</o>=<str>match</str>).</dd>
            <dt>\l</dt> <dd>Search only in links, as defined by <o>hinttags</o>.</dd>
            <dt>\L</dt> <dd>Search the entire page.</dd>
        </dl>

        <p>
            Additionally, if the /Find Bar/ extension is installed, the
            following flags may be used,
        </p>
        <dl dt="width: 6em;">
            <dt>\r</dt> <dd>Process the entire pattern as a regular expression.</dd>
            <dt>\R</dt> <dd>Process the entire pattern as an ordinary string.</dd>
        </dl>
    </description>
</item>

<item>
    <tags>?</tags>
    <spec>?<a>pattern</a><oa>?</oa><k name="CR"/></spec>
    <description>
        <p>
            Find a pattern backward of the current caret position in exactly the
            same manner as <k>/</k>
        </p>
    </description>
</item>

<item>
    <tags>n</tags>
    <spec>n</spec>
    <description short="true">
        <p>Find next. Repeat the last find.</p>
    </description>
</item>

<item>
    <tags>N</tags>
    <spec>N</spec>
    <description short="true">
        <p>Find previous. Repeat the last find in the opposite direction.</p>
    </description>
</item>

<item>
    <tags>*</tags>
    <spec>*</spec>
    <description short="true">
        <p>Search forward for the next occurrence of the word under cursor.</p>
    </description>
</item>

<item>
    <tags>#</tags>
    <spec>#</spec>
    <description short="true">
        <p>Search backward for the previous occurrence of the word under cursor.</p>
    </description>
</item>

<item>
    <tags>:noh :nohlfind</tags>
    <strut/>
    <spec>:noh<oa>lfind</oa></spec>
    <description>
        <p>
            Remove the find highlighting. The document is highlighted again
            when another find command is used or the <o>hlfind</o> option
            is set.
        </p>
    </description>
</item>

</document>

<!-- vim:se sts=4 sw=4 et: -->