mirror of
https://github.com/gryf/pentadactyl-pm.git
synced 2026-02-23 20:35:45 +01:00
Several edits to help docs to clarify when plugins are loaded and what can cause them to not be loaded.
This commit is contained in:
@@ -470,7 +470,10 @@ ____
|
|||||||
|\'nolpl'| |\'lpl'| |\'noloadplugins'| |\'loadplugins'|
|
|\'nolpl'| |\'lpl'| |\'noloadplugins'| |\'loadplugins'|
|
||||||
||'loadplugins' 'lpl'|| boolean (default on)
|
||'loadplugins' 'lpl'|| boolean (default on)
|
||||||
____
|
____
|
||||||
Load plugin scripts when starting up.
|
Load plugin scripts when starting up. When on, yet unloaded plugins are
|
||||||
|
automatically loaded after the vimperatorrc file has been sourced. To
|
||||||
|
load plugins earlier, use the [c]:loadplugins[c] command within the
|
||||||
|
vimperatorrc.
|
||||||
____
|
____
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -95,9 +95,11 @@ ________________________________________________________________________________
|
|||||||
|:lpl| |:loadplugins|
|
|:lpl| |:loadplugins|
|
||||||
||:loadplugins|| +
|
||:loadplugins|| +
|
||||||
________________________________________________________________________________
|
________________________________________________________________________________
|
||||||
Load all unloaded plugins immediately. This is useful both for sourcing new
|
Load all unloaded plugins immediately. Because plugins are automatically
|
||||||
plugins without restarting vimperator, and making sure that a plugin is loaded
|
loaded after vimperatorrc is sourced, this command must be placed early
|
||||||
so that you can use its commands from your vimperatorrc.
|
in the vimperatorrc file if vimperatorrc also includes commands that are
|
||||||
|
implemented by plugins. Additionally, this command allows for sourcing
|
||||||
|
new plugins without restarting vimperator.
|
||||||
________________________________________________________________________________
|
________________________________________________________________________________
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -5,33 +5,35 @@ be documented here.
|
|||||||
|
|
||||||
section:Initialization[initialization,startup]
|
section:Initialization[initialization,startup]
|
||||||
|
|
||||||
At startup Vimperator can perform user initialization commands. When one of
|
At startup, Vimperator completes the following tasks in order.
|
||||||
the following is successfully located, it is executed, and no further
|
|
||||||
locations are tried.
|
|
||||||
|
|
||||||
|
1. Vimperator can perform user initialization commands. When
|
||||||
|
one of the following is successfully located, it is executed, and no
|
||||||
|
further locations are tried.
|
||||||
|$VIMPERATOR_INIT|
|
|$VIMPERATOR_INIT|
|
||||||
|
|
||||||
1. _$VIMPERATOR_INIT_ -- May contain a single ex command, usually
|
a. _$VIMPERATOR_INIT_ -- May contain a single ex command (e.g.,
|
||||||
[c]:source {file}[c].
|
"[c]:source {file}[c]").
|
||||||
2. [a]\~/_vimperatorrc[a] -- Windows only. If this file exists, its contents
|
b. [a]\~/_vimperatorrc[a] -- Windows only. If this file exists, its contents
|
||||||
are executed.
|
are executed.
|
||||||
3. [a]\~/.vimperatorrc[a] -- If this file exists, its contents are executed.
|
c. [a]\~/.vimperatorrc[a] -- If this file exists, its contents are executed.
|
||||||
|
|
||||||
If 'exrc' is set then any RC file in the current directory is also sourced.
|
2. If 'exrc' is set, then any RC file in the current directory is also sourced.
|
||||||
|
|
||||||
The plugin directory can be in any of the directories in 'runtimepath'.
|
3. All directories in 'runtimepath' are searched for a "plugin"
|
||||||
|
subdirectory and all yet unloaded plugins are loaded. For each plugin
|
||||||
All directories in 'runtimepath' are searched for a "plugin" subdirectory and
|
directory, all *.\{js,vimp} files (including those in further
|
||||||
all are loaded. For each plugin directory all *.\{js,vimp} files (including
|
subdirectories) are sourced alphabetically. No plugins will be sourced
|
||||||
those in further subdirectories) are sourced alphabetically.
|
if 'noloadplugins' is set. Any particular plugin will not be loaded if
|
||||||
|
it has already been loaded (e.g., by an earlier [c]:loadplugins[c]
|
||||||
Plugins will not be sourced if 'noloadplugins' is set.
|
command).
|
||||||
|
|
||||||
The user's ~ (i.e., "home") directory is determined as follows:
|
The user's ~ (i.e., "home") directory is determined as follows:
|
||||||
|
|
||||||
* Unix and Mac -- _$HOME_ is used.
|
* On Unix and Mac, the environment variable _$HOME_ is used.
|
||||||
* Windows -- if _%HOME%_ is set then this is used, otherwise _%USERPROFILE%_ or finally
|
* On Windows, Vimperator checks for the existence of _%HOME%_, then
|
||||||
_%HOMEDRIVE%%HOMEPATH%_.
|
_%USERPROFILE%_, and then _%HOMEDRIVE%%HOMEPATH%_. It uses the first one
|
||||||
|
it finds.
|
||||||
|
|
||||||
section:Saving{nbsp}settings[save-settings]
|
section:Saving{nbsp}settings[save-settings]
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user