pentadactyl-pm/common/locale/en-US/pattern.xml

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="chrome://dactyl/content/help.xsl"?>

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

<document
    name="pattern"
    title="&dactyl.appname; Patterns"
    xmlns="&xmlns.dactyl;"
    xmlns:html="&xmlns.html;">
<h1 tag="text-search-commands">Text search commands</h1>
<toc start="2"/>

<p>
    &dactyl.appname; provides a Vim-like incremental search interface to
    replace &dactyl.host;'s crippled Typeahead Find. Among other improvements,
    our search 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 search.
    </li>
    <li>
        Escape sequences to toggle link-only and case-sensitive searching.
    </li>
</ul>

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

<item>
    <tags>/</tags>
    <spec>/<a>pattern</a><oa>/</oa><k name="CR"/></spec>
    <description>
        <p>Search forward for the first occurrence of <a>pattern</a>.</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>\c</dt> <dd>Perform case insensitive search (default if <o>ignorecase</o> is set).</dd>
            <dt>\C</dt> <dd>Perform case sensitive search</dd>
            <dt>\l</dt> <dd>Search only in links, as defined by <o>hinttags</o>. (default if <o>linksearch</o> is set).</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>\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>Search backward for <a>pattern</a>, 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 search.</p>
    </description>
</item>


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


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


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


<item>
    <tags>:noh :nohlsearch</tags>
    <strut/>
    <spec>:noh<oa>lsearch</oa></spec>
    <description>
        <p>
            Remove the search highlighting. The document is highlighted again
            when another search command is used or the <o>hlsearch</o> option
            is set.
        </p>
    </description>
</item>

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