pentadactyl-pm/common/locale/en-US/various.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="various"
    title="&dactyl.appname; Other"
    xmlns="http://vimperator.org/namespaces/liberator"
    xmlns:html="http://www.w3.org/1999/xhtml">
<h1>Other help</h1>
<toc start="2"/>

<h2 tag="various">Various commands</h2>

<item>
    <tags>:beep</tags>
    <spec>:beep</spec>
    <description>
        <p>
            Play a system beep. This should not be used for any purpose other
            than testing the visual bell.
        </p>
    </description>
</item>


<item>
    <tags>:contexts</tags>
    <spec>:contexts <a>ex-command</a></spec>
    <description>
        <p>
            Lists the completion contexts used during the completion of its
            arguments. These context names are used in options such as
            <o>autocomplete</o> and <o>wildcase</o>. Note that completion must
            be triggered in order for this command to be effective, so if
            autocompletion is not active, you'll need to press the
            <k name="Tab"/> key at least once. You should also be aware that
            this command is only useful from the commandline.
        </p>
    </description>
</item>


<item>
    <tags>:norm :normal</tags>
    <spec>:norm<oa>al</oa><oa>!</oa> <a>commands</a></spec>
    <description>
        <p>
            Execute Normal mode commands <a>commands</a>. This makes it possible to execute
            Normal mode commands typed on the command line. <a>commands</a> is executed like it
            is typed. If the <oa>!</oa> is given, mappings will not be used. <a>commands</a> should be
            a complete command. <a>commands</a> cannot start with a space. Put 1 space before
            it, 1 space is one space.
        </p>
    </description>
</item>


<item>
    <tags><![CDATA[<C-l> CTRL-L :redr :redraw]]></tags>
    <spec>:redr<oa>aw</oa></spec>
    <description>
        <p>Redraws the screen. Useful to update the screen halfway executing a script or function.</p>
    </description>
</item>


<item>
    <tags>:run :! :!cmd</tags>
    <spec>:!<a>cmd</a></spec>
    <description>
        <p>
            Run a command. Runs <a>cmd</a> through system() and displays its output. Any '!' in
            <a>cmd</a> is replaced with the previous external command, but not when there is a
            backslash before the '!', then the backslash is removed.
        </p>

        <p>
            Warning: Input redirection (&lt; foo) not done, also do not run commands which
            require stdin or it will hang &dactyl.host;! It is possible to launch background
            processes, though (e.g. <ex>:! xterm &amp;</ex>).
        </p>
    </description>
</item>


<item>
    <tags>:!!</tags>
    <spec>:!!</spec>
    <description>
        <p>Repeat last <ex>:!<a>cmd</a></ex>.</p>
    </description>
</item>


<item>
    <tags>:sil :silent</tags>
    <spec>:sil<oa>ent</oa> <a>command</a></spec>
    <description>
        <p>
            Execute a command silently. Normal messages and error messages generated by the
            command invocation will not be given and will not be added to the message
            history.
        </p>
    </description>
</item>


<item>
    <tags>:verb :verbose</tags>
    <spec>:<oa>count</oa>verb<oa>ose</oa> <a>command</a></spec>
    <description>
        <p>
            Execute a command with <o>verbose</o> set to <oa>count</oa>. If <oa>count</oa> is not specified
            then 1 is used as the value.
        </p>
    </description>
</item>


<item>
    <tags>:ve :version</tags>
    <spec>:ve<oa>rsion</oa><oa>!</oa></spec>
    <description>
        <p>
            Show version information. You can show the &dactyl.host; version page with
            <ex>:version!</ex>.
        </p>
    </description>
</item>

<h2 tag="privacy">Privacy and sensitive information</h2>

<p>
    Part of &dactyl.appname;'s user efficiency comes at the cost of storing a
    lot of potentially private data, including command-line history, page
    marks, and the like. Because we know that keeping a detailed trail of all
    of your activities isn't always welcome, &dactyl.appname; provides
    comprehensive facilities for erasing potentially sensitive data.
</p>

<p tag="private-mode porn-mode">
    <strut/>
    &dactyl.appname; fully supports &dactyl.host;'s private browsing mode.
    When in private browsing mode, no other than Bookmarks and QuickMarks are
    written to disk. Further, upon exiting private mode, all new data,
    including command-line history, local and URL marks, and macros, are
    purged. For more information, see <o>private</o>.
</p>

<p tag="sanitizing clearing-data">
    <strut/>
    In addition to private mode, &dactyl.appname; provides a comprehensive
    facility for clearing any potentially sensitive data generated by either
    &dactyl.appname; or &dactyl.host;. It directly integrates with
    &dactyl.host;'s own sanitization facility, and so automatically clears any
    domain data and session history when requested. Further, &dactyl.appname;
    provides its own more granular sanitization facility, which allows, e.g.,
    clearing the command-line and macro history for the past ten minutes.
</p>

<item>
    <tags>:sa :sanitize</tags>
    <spec>:sa<oa>nitize</oa> <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa> <a>item</a> …</spec>
    <spec>:sa<oa>nitize</oa>! <oa>-host=<a>host</a></oa> <oa>-older</oa> <oa>-timespan=<a>timespan</a></oa></spec>
    <description>
        <p>
            Clear private data items for <a>timespan</a>, where <a>item</a> …
            is a list of private items to delete. If <oa>!</oa> is specified
            then <o>sanitizeitems</o> is used for the list of items to delete.
            Items may be any of:
        </p>

        <dl>
            <dt>all         </dt>       <dd>All items</dd>
            <dt>cache       </dt>       <dd>Cache</dd>
            <dt>commandline </dt>       <dd>Command-line history</dd>
            <dt>cookies     </dt>       <dd>Cookies</dd>
            <dt>downloads   </dt>       <dd>Download history</dd>
            <dt>formdata    </dt>       <dd>Saved form and search history</dd>
            <dt>history     </dt>       <dd>Browsing history</dd>
            <dt>marks       </dt>       <dd>Local and URL marks</dd>
            <dt>macros      </dt>       <dd>Saved macros</dd>
            <dt>messages    </dt>       <dd>Saved <ex>:messages</ex></dd>
            <dt>offlineapps </dt>       <dd>Offline website data</dd>
            <dt>options     </dt>       <dd>Options containing hostname data</dd>
            <dt>passwords   </dt>       <dd>Saved passwords</dd>
            <dt>sessions    </dt>       <dd>Authenticated sessions</dd>
            <dt>sitesettings</dt>       <dd>Site preferences</dd>
        </dl>

        <p>
            When <em>history</em> items are sanitized, all command-line
            history items containing URLs or page titles (other than bookmark
            commands) are additionally cleared. Invocations of the
            <em>:sanitize</em> command are included in this set.
        </p>

        <p>
            If <a>timespan</a> (short name <em>-t</em>) is specified then only
            items within that timespan are deleted, otherwise the value of
            <o>sanitizetimespan</o> is used.  If <oa>-older</oa> (short name
            <em>-o</em>) is specified, than only items older than
            <a>timespan</a> are deleted.
        </p>

        <note>
            The following items are cleared regardless of <a>timeframe</a>:
            <em>cache</em>, <em>offlineapps</em>, <em>passwords</em>,
            <em>sessions</em>, <em>sitesettings</em>. Additionally,
            <em>options</em> are never cleared.
        </note>

        <p>
            If <a>host</a> (short name <em>-h</em>) is specified, only items
            containing a reference to that domain or a subdomain thereof are
            cleared. Moreover, if <em>commandline</em> or <em>history</em> is
            specified, the invocation of the <em>:sanitize</em> command is
            naturally cleared as well.
        </p>

        <note>
            This only applies to <em>commandline</em>, <em>cookies</em>,
            <em>history</em>, <em>marks</em>, <em>messages</em>,
            <em>options</em>, and <em>sitesettings</em>. All other
            domain-specific data is cleared only along with <em>history</em>,
            when a request is made to &dactyl.host; to purge all data for
            <em>host</em>. Included in this purge are all matchint history
            entries, cookies, closed tabs, form data, and location bar
            entries.
        </note>
    </description>
</item>


<h2 tag="online-help">Online help</h2>

<item>
    <tags><![CDATA[<F1> :help :h help]]></tags>
    <spec>:h<oa>elp</oa> <oa>subject</oa></spec>
    <spec>&lt;F1></spec>
    <description>
        <p>
            Open the help page. The default page, as specified by <o>helpfile</o> is shown
            unless <oa>subject</oa> is specified. If you need help for a specific topic, try
            <ex>:help overview</ex>.
        </p>
    </description>
</item>


<item>
    <tags>:helpall :helpa help-all</tags>
    <spec>:helpa<oa>ll</oa> <oa>subject</oa></spec>
    <description>
        <p>Open the single unchunked help page.</p>

        <p>See <ex>:help</ex>.</p>
    </description>
</item>


<item>
    <tags>:exu :exusage</tags>
    <spec>:exu<oa>sage</oa><oa>!</oa></spec>
    <description>
        <p>
            Show help on Ex commands. If <oa>!</oa> is given then the help is listed in the
            command output window.
        </p>
    </description>
</item>


<item>
    <tags>:optionu :optionusage</tags>
    <spec>:optionu<oa>sage</oa><oa>!</oa></spec>
    <description>
        <p>
            Show help on options. If <oa>!</oa> is given then the help is listed in the command
            output window.
        </p>
    </description>
</item>


<item>
    <tags>:viu :viusage</tags>
    <spec>:viu<oa>sage</oa><oa>!</oa></spec>
    <description>
        <p>
            Show help on Normal mode commands. If <oa>!</oa> is given then the help is listed in
            the command output window.
        </p>
    </description>
</item>



<tags>42</tags>

What is the meaning of life, the universe and everything?
Douglas Adams, the only person who knew what this question really was about is
now dead, unfortunately. So now you might wonder what the meaning of death
is…


<h2 tag="uncategorized">Uncategorized help</h2>

<item>
    <tags><![CDATA[<C-[> <Esc>]]></tags>
    <spec>&lt;Esc></spec>
    <description>
        <p>
            Focus content. Exits Command-line or Hints mode and returns to Normal
            mode. Also focuses the web page in case a form field has focus and eats
            our key presses.
        </p>
    </description>
</item>


<item>
    <tags><![CDATA[<Insert> i]]></tags>
    <spec>i</spec>
    <description>
        <p>
            Start caret mode. This mode resembles the Vim's Normal mode where you see a
            text cursor and can move around. If you want to select text in this mode, press
            <k>v</k> to start its Visual mode.
        </p>
    </description>
</item>


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