common/locale/en-US/pattern.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
   3
   4 <!DOCTYPE document SYSTEM "dactyl://content/dtd">
   5
   6 <document
   7     name="pattern"
   8     title="&dactyl.appName; Patterns"
   9     xmlns="&xmlns.dactyl;"
  10     xmlns:html="&xmlns.html;">
  11
  12 <h1 tag="text-find-commands">Text find commands</h1>
  13 <toc start="2"/>
  14
  15 <p>
  16     &dactyl.appName; provides a Vim-like incremental find interface to
  17     replace &dactyl.host;'s crippled Typeahead Find. Among other improvements,
  18     our find service:
  19 </p>
  20 <ul>
  21     <li>
  22         Starts at the cursor position in the currently selected frame, unlike
  23         &dactyl.host;, which always starts at the beginning of the first frame
  24         for documents with more than one frame.
  25     </li>
  26     <li>
  27         Returns the cursor and viewport to their original position on cancel.
  28     </li>
  29     <li>
  30         Backtracks to the first successful match after pressing backspace,
  31         unlike &dactyl.host;, which will always continue from the last match.
  32     </li>
  33     <li>
  34         Supports reverse incremental find.
  35     </li>
  36     <li>
  37         Escape sequences to toggle link-only and case-sensitive find.
  38     </li>
  39 </ul>
  40
  41 <p>
  42     Regular expression find, however, is not currently available unless the
  43     /Find Bar/ service is installed, in which case it may be toggled on with
  44     a find flag.
  45 </p>
  46
  47 <item>
  48     <tags><![CDATA[<find-forward> /]]></tags>
  49     <spec>/<a>pattern</a><k name="CR"/></spec>
  50     <description>
  51         <p>Find <a>pattern</a> starting at the current caret position.</p>
  52
  53         <p>
  54             The following escape sequences can be used to modify the
  55             behavior of the find. When flags conflict, the last to
  56             appear is the one that takes effect.
  57         </p>
  58
  59         <dl dt="width: 6em;">
  60             <dt>\c</dt> <dd>Perform case insensitive find (default if <o>findcase</o>=<str>ignore</str>).</dd>
  61             <dt>\C</dt> <dd>Perform case sensitive find (default if <o>findcase</o>=<str>match</str>).</dd>
  62             <dt>\l</dt> <dd>Search only in links, as defined by <o>hinttags</o>.</dd>
  63             <dt>\L</dt> <dd>Search the entire page.</dd>
  64         </dl>
  65
  66         <p>
  67             Additionally, if the /Find Bar/ extension is installed, the
  68             following flags may be used,
  69         </p>
  70         <dl dt="width: 6em;">
  71             <dt>\r</dt> <dd>Process the entire pattern as a regular expression.</dd>
  72             <dt>\R</dt> <dd>Process the entire pattern as an ordinary string.</dd>
  73         </dl>
  74     </description>
  75 </item>
  76
  77 <item>
  78     <tags><![CDATA[<find-forward> ?]]></tags>
  79     <spec>?<a>pattern</a><k name="CR"/></spec>
  80     <description>
  81         <p>
  82             Find a pattern backward of the current caret position in exactly the
  83             same manner as <k>/</k>
  84         </p>
  85     </description>
  86 </item>
  87
  88 <item>
  89     <tags><![CDATA[<find-next> n]]></tags>
  90     <spec>n</spec>
  91     <description short="true">
  92         <p>Find next. Repeat the last find.</p>
  93     </description>
  94 </item>
  95
  96 <item>
  97     <tags><![CDATA[<find-previous> N]]></tags>
  98     <spec>N</spec>
  99     <description short="true">
 100         <p>Find previous. Repeat the last find in the opposite direction.</p>
 101     </description>
 102 </item>
 103
 104 <item>
 105     <tags><![CDATA[<find-word-next> *]]></tags>
 106     <spec>*</spec>
 107     <description short="true">
 108         <p>Search forward for the next occurrence of the word under cursor.</p>
 109     </description>
 110 </item>
 111
 112 <item>
 113     <tags><![CDATA[<find-word-previous> #]]></tags>
 114     <spec>#</spec>
 115     <description short="true">
 116         <p>Search backward for the previous occurrence of the word under cursor.</p>
 117     </description>
 118 </item>
 119
 120 <item>
 121     <tags>:noh :nohlfind</tags>
 122     <strut/>
 123     <spec>:noh<oa>lfind</oa></spec>
 124     <description>
 125         <p>
 126             Remove the find highlighting. The document is highlighted again
 127             when another find command is used or the <o>hlfind</o> option
 128             is set.
 129         </p>
 130     </description>
 131 </item>
 132
 133 </document>
 134
 135 <!-- vim:se sts=4 sw=4 et: -->