1
0
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:
Ted Pavlic
2009-01-02 11:37:07 -05:00
parent 7923d17aab
commit 1facfe407f
3 changed files with 29 additions and 22 deletions

View File

@@ -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.
____ ____

View File

@@ -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.
________________________________________________________________________________ ________________________________________________________________________________

View File

@@ -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]