<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 two options:
-
-<item>
- <tags><![CDATA[<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>
-
<h2 tag="opening">Opening web pages</h2>
<item>
<example><ex>:open Linus Torvalds</ex></example>
</li>
<li>
- Any other value is passed directly &dactyl.host; and
+ Any other value is passed directly to &dactyl.host; and
must be a valid URL or hostname.
</li>
</ol>
</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>
Like <ex>:tabopen</ex>, but all arguments are opened in
a single new window.
</p>
+ <p>
+ When called via <ex>:private</ex>, the new window is a
+ private browsing window.
+ </p>
</description>
</item>
</item>
<item>
- <tags><![CDATA[<C-x>]]></tags>
+ <tags><![CDATA[<decrement-url-path> <C-x>]]></tags>
<strut/>
<spec><oa>count</oa><C-x></spec>
<description>
</item>
<item>
- <tags><![CDATA[<C-a>]]></tags>
+ <tags><![CDATA[<increment-url-path> <C-a>]]></tags>
<strut/>
<spec><oa>count</oa><C-a></spec>
<description>
</description>
</item>
+<h2 tag="history">History</h2>
+
<item>
- <tags>~</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>List all jumps, i.e., the current tab's session history.</p>
+ <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>
- Current history position is marked with <em>></em>.
- Jump numbers may be used as counts for with
- <ex>:back</ex> or <ex>:forward</ex>.
+ Go to the <oa>count</oa>th next domain in the history stack.
</p>
</description>
</item>
<item>
- <tags>gh</tags>
+ <tags>:hs :hist :history</tags>
+ <spec>:hist<oa>ory</oa><oa>!</oa> <oa>filter</oa></spec>
+ <description>
+ <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>
+ 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>
+
+<item>
+ <tags><![CDATA[<open-homepage> gh]]></tags>
<spec>gh</spec>
<description short="true">
<p>Go home. Opens the homepage in the current tab.</p>
</item>
<item>
- <tags>gH</tags>
+ <tags><![CDATA[<tab-open-homepage> gH]]></tags>
<strut/>
<spec>gH</spec>
<description>
</item>
<item>
- <tags>gu</tags>
+ <tags><![CDATA[<open-parent-path> gu]]></tags>
<spec><oa>count</oa>gu</spec>
<description short="true">
<p>Go to <oa>count</oa>th parent directory.</p>
</item>
<item>
- <tags>gU</tags>
+ <tags><![CDATA[<open-root-path> gU]]></tags>
<spec>gU</spec>
<description short="true">
<p>Go to the root of the web site.</p>
</description>
</item>
-<item>
- <tags>:reh :rehash</tags>
- <spec>:reh<oa>ash</oa> <oa>arg</oa> …</spec>
- <description>
- <p>
- Reload the &dactyl.appName; add-on, including all code, plugins,
- and configuration. For users running directly from the development
- repository, this is a good way to update to the latest version or
- to test your changes.
- </p>
- <p>
- Any arguments supplied are parsed as command-line arguments as
- specified in <t>startup-options</t>.
- </p>
- <warning>
- Not all plugins are designed to cleanly un-apply during a rehash.
- While official plugins are safe, beware of possible instability
- if you rehash while running third-party plugins.
- </warning>
- </description>
-</item>
-
<item>
<tags>:re :reload</tags>
<spec>:re<oa>load</oa><oa>!</oa></spec>
<h2 tag="stopping">Stopping</h2>
<item>
- <tags><![CDATA[<C-c> :st :stop]]></tags>
+ <tags><![CDATA[<stop-load> <C-c> :st :stop]]></tags>
<spec><C-c></spec>
<strut/>
<spec>:st<oa>op</oa></spec>
<h2 tag="quitting save-session">Quitting</h2>
+<item>
+ <tags>ZQ :x :exit</tags>
+ <strut/>
+ <spec>:exit<oa>!</oa></spec>
+ <description>
+ <p>
+ Quit &dactyl.appName;, no matter how many tabs/windows are open.
+ The session is not stored. Use <oa>!</oa> to forcibly quit.
+ </p>
+ </description>
+</item>
+
<item>
<tags>:q :quit</tags>
<strut/>
<spec>:quita<oa>ll</oa></spec>
<description>
<p>
- Quit &dactyl.appName;, no matter how many tabs/windows
- are open. The session is not stored.
+ Close the current &dactyl.appName; window, no matter how
+ many tabs are open.
</p>
</description>
</item>
</item>
<item>
- <tags>:xa :xall :wq :wqa :wqall</tags>
+ <tags>ZZ :xa :xall :wq :wqa :wqall</tags>
<spec>:wqa<oa>ll</oa></spec>
<strut/>
<spec>:xa<oa>ll</oa></spec>
</description>
</item>
-<item>
- <tags>ZQ</tags>
- <spec>ZQ</spec>
- <description short="true">
- <p>Quit and don't save the session. Works like <ex>:qall</ex>.</p>
- </description>
-</item>
-
-<item>
- <tags>ZZ</tags>
- <spec>ZZ</spec>
- <description short="true">
- <p>
- Quit &dactyl.appName; and save the session. Works like
- <ex>:xall</ex>.
- </p>
- </description>
-</item>
-
<h2 tag="current-directory">The current directory</h2>
<item>