summaryrefslogtreecommitdiff
path: root/common/locale/en-US/pattern.xml
blob: df43f02af280d08baff73d1c2c4583a119e7e1d7 (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
<?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>
    <li>
        Crude regular expression searches are supported.
    </li>
</ul>

<item>
    <tags><![CDATA[<find-forward> /]]></tags>
    <spec>/<a>pattern</a><k name="CR" link="false"/></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 search. 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>
            <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><![CDATA[<find-backward> <S-Slash> ?]]></tags>
    <spec>?<a>pattern</a><k name="CR" link="false"/></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><![CDATA[<find-next> n]]></tags>
    <spec>n</spec>
    <description short="true">
        <p>Find next. Repeat the last find.</p>
    </description>
</item>

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

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

<item>
    <tags><![CDATA[<find-word-backward> #]]></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: -->