diff options
| author | Tommy Allen <tommy@esdf.io> | 2016-07-12 02:17:58 -0400 |
|---|---|---|
| committer | Tommy Allen <tommy@esdf.io> | 2016-08-17 16:22:15 -0400 |
| commit | 01e33e1c74619fc8d262e2dedbd45a20bdb24245 (patch) | |
| tree | 1f053d05a71a94ec4a57e122b073cb2728d0f22c /runtime/doc | |
| parent | dfb6a5133b92ffb38bfb7201e91f3de328652558 (diff) | |
| download | rneovim-01e33e1c74619fc8d262e2dedbd45a20bdb24245.tar.gz rneovim-01e33e1c74619fc8d262e2dedbd45a20bdb24245.tar.bz2 rneovim-01e33e1c74619fc8d262e2dedbd45a20bdb24245.zip | |
runtime: rplugin manifest written to $XDG_DATA_HOME
Uses $NVIM_RPLUGIN_MANIFEST if available
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/remote_plugin.txt | 26 |
1 files changed, 18 insertions, 8 deletions
diff --git a/runtime/doc/remote_plugin.txt b/runtime/doc/remote_plugin.txt index d906096a86..25fd638b10 100644 --- a/runtime/doc/remote_plugin.txt +++ b/runtime/doc/remote_plugin.txt @@ -93,22 +93,22 @@ approach with |rpcnotify()|, meaning return values or exceptions raised in the handler function are ignored. To test the above plugin, it must be saved in "rplugin/python" in a -'runtimepath' directory (~/.config/nvim/rplugin/python/limit.py for example). -Then, the remote plugin manifest must be generated with -`:UpdateRemotePlugins`. +'runtimepath' directory (~/.config/nvim/rplugin/python/limit.py for example). +Then, the remote plugin manifest must be generated with +|:UpdateRemotePlugins|. ============================================================================== 4. Remote plugin manifest *remote-plugin-manifest* + *:UpdateRemotePlugins* Just installing remote plugins to "rplugin/{host}" isn't enough for them to be -automatically loaded when required. You must execute `:UpdateRemotePlugins` +automatically loaded when required. You must execute |:UpdateRemotePlugins| every time a remote plugin is installed, updated, or deleted. -`:UpdateRemotePlugins` generates the remote plugin manifest, a special +|:UpdateRemotePlugins| generates the remote plugin manifest, a special Vimscript file containing declarations for all Vimscript entities (commands/autocommands/functions) defined by all remote plugins, with each -entity associated with the host and plugin path. The manifest is a generated -extension to the user's vimrc (it even has the vimrc filename prepended). +entity associated with the host and plugin path. Manifest declarations are just calls to the `remote#host#RegisterPlugin` function, which takes care of bootstrapping the host as soon as the declared @@ -125,10 +125,20 @@ the example, say the Java plugin is a semantic completion engine for Java code. If it defines the autocommand "BufEnter *.java", then the Java host is spawned only when Nvim loads a buffer matching "*.java". -If the explicit call to `:UpdateRemotePlugins` seems incovenient, try to see it +If the explicit call to |:UpdateRemotePlugins| seems incovenient, try to see it like this: It's a way to provide IDE capabilities in Nvim while still keeping it fast and lightweight for general use. It's also analogous to the |:helptags| command. +Unless a path is set in the `$NVIM_RPLUGIN_MANIFEST` environment variable, the +manifest will be written to a file named `rplugin.vim` in one of the following +directories: + + Unix ~ + $XDG_DATA_HOME/nvim/ or ~/.local/share/nvim/ + + Windows ~ + $LOCALAPPDATA/nvim/ or ~/AppData/Local/nvim/ + ============================================================================== vim:tw=78:ts=8:noet:ft=help:norl: |