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

<tags>startup-options</tags>

<p>
    Command-line options can be passed to &dactyl.appname; via the -&dactyl.name; &dactyl.host;
    option. These are passed as single string argument.
    E.g., &dactyl.hostbin; -&dactyl.name; <str>++cmd 'set exrc' +u 'tempRcFile' ++noplugin</str>
</p>

<item>
    <tags>+c</tags>
    <spec>+c <a>command</a></spec>
    <description>
        <p>
            Execute a single Ex command after all initialization has been performed. See
            <t>initialization</t>.
        </p>

        <p>This option can be specified multiple times.</p>
    </description>
</item>


<item>
    <tags>++cmd</tags>
    <spec>++cmd <a>command</a></spec>
    <description>
        <p>
            Execute a single Ex command before any initialization has been performed. See
            <t>initialization</t>.
        </p>

        <p>This option can be specified multiple times.</p>
    </description>
</item>


<item>
    <tags>+u</tags>
    <spec>+u <a>rcfile</a></spec>
    <description>
        <p>
            The file <a>rcfile</a> is used for user initialization commands. If <a>rcfile</a> is
            "NORC" then no startup initialization is performed except for the loading of
            plugins, i.e., steps 1. and 2. in <t>initialization</t> are skipped. If <a>rcfile</a>
            is "NONE" then plugin loading is also skipped.
        </p>
    </description>
</item>


<item>
    <tags>++noplugin</tags>
    <spec>++noplugin</spec>
    <description>
        <p>Prevents plugin scripts from being loaded at startup. See <o>loadplugins</o>.</p>
    </description>
</item>


<h2 tag="initialization startup">Initialization</h2>

<p>At startup, &dactyl.appname; completes the following tasks in order. </p>

<ol>
    <li> &dactyl.appname; can perform user initialization commands. When
    one of the following is successfully located, it is executed,
    and no further locations are tried.

        <ol>
            <li tag="$&dactyl.idname;_INIT">
                <em>$&dactyl.idname;_INIT</em> — May contain a single Ex command (e.g.,
                "<ex>:source <a>file</a></ex>").
            </li>
            <li tag="$MY_&dactyl.idname;RC">
                <em>~/&dactyl.name;rc</em> — Windows only. If this file exists, its contents
                are executed and <em>$MY_&dactyl.idname;RC</em> set to its path.
            </li>
            <li>
                <em>~/.&dactyl.name;rc</em> — If this file exists, its contents are executed.
            </li>
        </ol>
    </li>
    <li>
        If <o>exrc</o> is set and the +u command-line option was not
        specified, then any RC file in the current directory is also
        sourced.
    </li>
    <li>
        All directories in <o>runtimepath</o> are searched for a
        "plugin" subdirectory and all yet unloaded plugins are loaded.
        For each plugin directory, all <tt>*.{js,vimp}</tt> files (including
        those in further subdirectories) are sourced alphabetically. No
        plugins will be sourced if:

        <ul>
            <li><o>noloadplugins</o> is set.</li>
            <li>the ++noplugin command-line option was specified.</li>
            <li>the +u=NONE command-line option specified set.</li>
        </ul>

        Any particular plugin will not be loaded if it has already been
        loaded (e.g., by an earlier <ex>:loadplugins</ex> command).
    </li>
</ol>

The user's ~ (i.e., "home") directory is determined as follows:

<ul>
    <li>On Unix and Mac, the environment variable  <em>$HOME</em> is used.</li>
    <li>
        On Windows, &dactyl.appname; checks for the existence of
        <em>%HOME%</em>, then <em>%USERPROFILE%</em>, and then
        <em>%HOMEDRIVE%%HOMEPATH%</em>. It uses the first one it
        finds.
    </li>
</ul>

<h2 tag="save-settings">Saving settings</h2>

<item>
    <tags>:mkv :mk&dactyl.name;rc</tags>
    <spec>:mkv<oa>imperatorrc</oa><oa>!</oa> <oa>file</oa></spec>
    <description>
        <p>
            Write current key mappings and changed options to <oa>file</oa>. If no
            <oa>file</oa> is specified then <em>~/.&dactyl.name;rc</em> is written unless this file
            already exists. The special version <ex>:mk&dactyl.name;rc!</ex> will overwrite
            <oa>file</oa> if it exists.
        </p>

        <p>
            Warning: this differs from Vim's behavior which defaults to writing the file
            in the current directory.
        </p>
    </description>
</item>


<h2 tag="restarting">Restarting</h2>

<item>
    <tags>:res :restart</tags>
    <spec>:res<oa>tart</oa></spec>
    <description>
        <p>Force &dactyl.host; to restart. Useful when installing extensions.</p>
    </description>
</item>



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