Starting &liberator.appname;
startup-options
Command-line options can be passed to &liberator.appname; via the -&liberator.name; &liberator.host;
option. These are passed as single string argument.
E.g., &liberator.hostbin; -&liberator.name; ++cmd 'set exrc' +u 'tempRcFile' ++noplugin
-
+c
+c command
Execute a single Ex command after all initialization has been performed. See
initialization.
This option can be specified multiple times.
-
++cmd
++cmd command
Execute a single Ex command before any initialization has been performed. See
initialization.
This option can be specified multiple times.
-
+u
+u rcfile
The file rcfile is used for user initialization commands. If rcfile is
"NORC" then no startup initialization is performed except for the loading of
plugins, i.e., steps 1. and 2. in initialization are skipped. If rcfile
is "NONE" then plugin loading is also skipped.
-
++noplugin
++noplugin
Prevents plugin scripts from being loaded at startup. See loadplugins.
Initialization
At startup, &liberator.appname; completes the following tasks in order.
- &liberator.appname; can perform user initialization commands. When
one of the following is successfully located, it is executed,
and no further locations are tried.
-
$&liberator.idname;_INIT — May contain a single Ex command (e.g.,
":source file").
-
~/&liberator.name;rc — Windows only. If this file exists, its contents
are executed and $MY_&liberator.idname;RC set to its path.
-
~/.&liberator.name;rc — If this file exists, its contents are executed.
-
If exrc is set and the +u command-line option was not
specified, then any RC file in the current directory is also
sourced.
-
All directories in runtimepath are searched for a
"plugin" subdirectory and all yet unloaded plugins are loaded.
For each plugin directory, all *.{js,vimp} files (including
those in further subdirectories) are sourced alphabetically. No
plugins will be sourced if:
- noloadplugins is set.
- the ++noplugin command-line option was specified.
- the +u=NONE command-line option specified set.
Any particular plugin will not be loaded if it has already been
loaded (e.g., by an earlier :loadplugins command).
The user's ~ (i.e., "home") directory is determined as follows:
- On Unix and Mac, the environment variable $HOME is used.
-
On Windows, &liberator.appname; checks for the existence of
%HOME%, then %USERPROFILE%, and then
%HOMEDRIVE%%HOMEPATH%. It uses the first one it
finds.
Saving settings
-
:mkv :mk&liberator.name;rc
:mkvimperatorrc! file
Write current key mappings and changed options to file. If no
file is specified then ~/.&liberator.name;rc is written unless this file
already exists. The special version :mk&liberator.name;rc! will overwrite
file if it exists.
Warning: this differs from Vim's behavior which defaults to writing the file
in the current directory.
Restarting
-
:res :restart
:restart
Force &liberator.host; to restart. Useful when installing extensions.