<h1 tag="surfing browsing">Browsing</h1>
<toc start="2"/>
-<h2 tag="bypassing-&dactyl.name;">Bypassing &dactyl.appName;</h2>
-
-&dactyl.appName; overrides nearly all &dactyl.host; keys in order to
-make browsing more pleasant for Vim users. On the occasions when you
-want to bypass &dactyl.appName;'s key handling and pass keys directly to
-&dactyl.host; or to a web page, you have several options:
-
-<item>
- <tags><![CDATA[<pass-next-key-builtin> <A-b>]]></tags>
- <spec><![CDATA[<A-b>]]></spec>
- <description>
- <p>
- Process the next key as a builtin mapping, ignoring any user defined
- mappings and <o>passkeys</o> settings.
- </p>
- </description>
-</item>
-
-<item>
- <tags><![CDATA[send-key <pass-next-key> <C-v> CTRL-V]]></tags>
- <spec><![CDATA[<C-v>]]></spec>
- <description>
- <p>
- Pass the next key press directly to &dactyl.host;.
- </p>
- </description>
-</item>
-
-<item>
- <tags><![CDATA[pass-through <pass-all-keys> <C-z> CTRL-Z]]></tags>
- <spec><![CDATA[<C-z>]]></spec>
- <description>
- <p>
- Pass all keys except for <k name="Esc"/> directly to
- &dactyl.host;. When <k name="Esc"/> is pressed,
- resume normal key handling. This is especially useful
- for web sites which make heavy use of key bindings.
- </p>
- </description>
-</item>
-
-<p>
- See also <o>passkeys</o> and <o>passunknown</o> for ways to permanently pass
- all or particular keys under certain conditions.
-</p>
-
<h2 tag="opening">Opening web pages</h2>
<item>
</description>
</item>
+<item>
+ <tags>O</tags>
+ <spec>O</spec>
+ <description short="true">
+ <p>
+ Open an <ex>:open</ex> prompt followed by the current URL.
+ </p>
+ </description>
+</item>
+
<item>
<tags>T</tags>
<spec>T</spec>
</description>
</item>
+<item>
+ <tags>s</tags>
+ <spec>s</spec>
+ <description short="true">
+ <p>Open a search prompt.</p>
+ </description>
+</item>
+
+<item>
+ <tags>S</tags>
+ <spec>S</spec>
+ <description short="true">
+ <p>Open a search prompt for a new tab.</p>
+ </description>
+</item>
+
<item>
<tags>:tabdu :tabduplicate</tags>
<spec>:<oa>count</oa>tabdu<oa>plicate</oa><oa>!</oa></spec>
</description>
</item>
-<item>
- <tags>O</tags>
- <spec>O</spec>
- <description short="true">
- <p>
- Open an <ex>:open</ex> prompt followed by the current URL.
- </p>
- </description>
-</item>
-
<item>
<tags>w :winopen :wopen</tags>
<spec>:wino<oa>pen</oa><oa>!</oa> <oa>args</oa></spec>
</description>
</item>
+<h2 tag="history">History</h2>
+
<item>
- <tags><![CDATA[<open-home-directory> ~]]></tags>
- <spec>~</spec>
- <description short="true">
- <p>Open home directory. Equivalent to <ex>:open ~/</ex></p>
+ <tags><![CDATA[<C-o>]]></tags>
+ <strut/>
+ <spec><oa>count</oa><![CDATA[<C-o>]]></spec>
+ <description>
+ <p>
+ Go to an older position in the jump list.
+ If <oa>count</oa> is specified, jump <oa>count</oa> positions backward.
+ </p>
</description>
</item>
-<h2 tag="navigating">Navigating</h2>
+<item>
+ <tags><![CDATA[<C-i>]]></tags>
+ <strut/>
+ <spec><oa>count</oa><![CDATA[<C-i>]]></spec>
+ <description>
+ <p>
+ Go to a newer position in the jump list.
+ If <oa>count</oa> is specified, jump <oa>count</oa> positions forward.
+ </p>
+ </description>
+</item>
<item>
- <tags><![CDATA[H <C-o> CTRL-O :ba :back]]></tags>
+ <tags>:ju :jumps</tags>
+ <strut/>
+ <spec>:ju<oa>mps</oa></spec>
+ <description>
+ <p>
+ Display the jump list.
+ The jump numbers shown are suitable as arguments to <k name="C-o"/>
+ or <k name="C-i"/>.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[<M-Left> <A-Left> H]]></tags>
+ <strut/>
+ <spec>[count]H</spec>
+ <description>
+ <p>
+ Go back in the browser history. If <oa>count</oa> is specified, go
+ back <oa>count</oa> pages.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[<M-Right> <A-Right> L]]></tags>
+ <strut/>
+ <spec><oa>count</oa>L</spec>
+ <description>
+ <p>
+ Go forward in the browser history. If <oa>count</oa> is specified,
+ go forward <oa>count</oa> pages.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:ba :back</tags>
<spec>:<oa>count</oa>ba<oa>ck</oa> <oa>url</oa></spec>
- <spec>:ba<oa>ck</oa>!</spec>
- <spec><oa>count</oa><C-o></spec>
+ <spec>:<oa>count</oa>ba<oa>ck</oa>!</spec>
<description>
<p>
- Go <oa>count</oa> pages back in the browser history. If
- <oa>url</oa> is specified go back to the first matching
- URL. The special version <ex>:back!</ex> goes to the
- beginning of the browser history.
+ Go back in the browser history. If <oa>count</oa> is specified, go
+ back <oa>count</oa> pages.
+ </p>
+ <p>
+ The special version <ex>:back!</ex> goes to the beginning of the browser history.
</p>
</description>
</item>
<item>
- <tags><![CDATA[L <C-i> CTRL-I :fo :fw :forward]]></tags>
+ <tags>:fw :fo :forward</tags>
<spec>:<oa>count</oa>fo<oa>rward</oa> <oa>url</oa></spec>
- <spec>:fo<oa>rward</oa>!</spec>
- <spec><oa>count</oa><C-i></spec>
+ <spec>:<oa>count</oa>fo<oa>rward</oa>!</spec>
<description>
<p>
- Go <oa>count</oa> pages forward in the browser history.
- If <oa>url</oa> is specified go forward to the first
- matching URL. The special version <ex>:forward!</ex>
- goes to the end of the browser history.
+ Go forward in the browser history. If <oa>count</oa> is specified,
+ go forward <oa>count</oa> pages.
+ </p>
+ <p>
+ The special version <ex>:forward!</ex> goes to the end of the browser history.
</p>
</description>
</item>
<item>
- <tags>:ju :jumps</tags>
- <spec>:ju<oa>mps</oa></spec>
+ <tags><![CDATA[[d]]></tags>
+ <spec><oa>count</oa>[d</spec>
+ <description>
+ <p>
+ Go to the <oa>count</oa>th previous domain in the history stack.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[]d]]></tags>
+ <spec><oa>count</oa>]d</spec>
+ <description>
+ <p>
+ Go to the <oa>count</oa>th next domain in the history stack.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:hs :hist :history</tags>
+ <spec>:hist<oa>ory</oa><oa>!</oa> <oa>filter</oa></spec>
<description>
- <p>List all jumps, i.e., the current tab's session history.</p>
+ <p>
+ Show recently visited URLs. Opens the message window at the bottom of the screen
+ with all history items whose page titles or URLs match
+ <oa>filter</oa>.
+ </p>
<p>
- Current history position is marked with <em>></em>.
- Jump numbers may be used as counts for
- <ex>:back</ex> or <ex>:forward</ex>.
+ The special version <ex>:history!</ex> works the same as
+ <ex>:history</ex> except that it opens all matching
+ pages in new tabs rather than listing them.
</p>
+
+ <p>The pages may also be filtered via the following options,</p>
+
+ <dl dt="width: 8em;">
+ <dt>-max</dt>
+ <dd>
+ The maximum number of items to list or open
+ (short name <em>-m</em>).
+ </dd>
+ <dt>-sort</dt>
+ <dd>
+ The sort order of the results
+ (short name <em>-s</em>).
+ </dd>
+ </dl>
+ </description>
+</item>
+
+<h2 tag="navigating">Navigating</h2>
+
+<item>
+ <tags><![CDATA[<open-home-directory> ~]]></tags>
+ <spec>~</spec>
+ <description short="true">
+ <p>Open home directory. Equivalent to <ex>:open ~/</ex></p>
</description>
</item>