dpp.txt

*dpp.txt*	Dark powered plugin manager for Vim/neovim

Author: Shougo <Shougo.Matsu at gmail.com>
License: MIT license

CONTENTS                                                        *dpp-contents*

Introduction		|dpp-introduction|
Install			|dpp-install|
Interface		|dpp-interface|
  Options		  |dpp-options|
  Functions		  |dpp-functions|
  Plugin options	  |dpp-plugin-options|
  Lua functions.	  |dpp-lua-functions|
Dpp Sources		|dpp-ddu-sources|
Examples		|dpp-examples|
Plugins merged feature	|dpp-merge|
Exts			|dpp-exts|
  Ext option	          |dpp-ext-options|
  Ext params	          |dpp-ext-params|
Protocols		|dpp-protocols|
  Protocol option	  |dpp-protocol-options|
  Protocol params	  |dpp-protocol-params|
Autocmds		|dpp-autocmds|
Create Ext		|dpp-create-ext|
  Ext attributes	  |dpp-ext-attributes|
Create Protocol		|dpp-create-protocol|
  Protocol attributes	  |dpp-protocol-attributes|
FAQ			|dpp-faq|
Compatibility		|dpp-compatibility|


==============================================================================
INTRODUCTION                                                *dpp-introduction*

*dpp* is the abbreviation of "Dark Powered Plugin manager".  It provides
extensible plugin manager features.

If you don't want to configure plugins, you don't have to use the plugin
manager. It does not work with zero configuration.  You can use other plugin
managers.


==============================================================================
INSTALL                                                          *dpp-install*

NOTE: dpp.vim requires Neovim (0.10.0+) or Vim 9.0.1276+ (latest is
recommended).

Please install both Deno and "denops.vim".

https://deno.land/
https://github.com/vim-denops/denops.vim

NOTE: To install plugins from remote, you need to install "dpp-ext-installer".

https://github.com/Shougo/dpp-ext-installer

NOTE: dpp.vim does not include any extensions.
You must install them you want manually.
You can search dpp.vim plugins from https://github.com/topics/dpp-vim.

==============================================================================
INTERFACE                                                      *dpp-interface*

------------------------------------------------------------------------------
OPTIONS                                                          *dpp-options*

                                                       *dpp-option-extOptions*
extOptions		(dictionary)
		It is a dictionary that maps ext names to its options.
		The options with the name "_" is used as the options for all
		names.
		See also |dpp-ext-options|.

		Default: {}

                                                        *dpp-option-extParams*
extParams		(dictionary)
		It is a dictionary that maps ext names to its parameters.
		See also |dpp-ext-params|.

		Default: {}

                                                  *dpp-option-hooksFileMarker*
hooksFileMarker		(string)
		The marker is used in |dpp-plugin-option-hooks_file|.

		Defaults: "{{{,}}}"

                                                     *dpp-option-inlineVimrcs*
inlineVimrcs		(string[])
		The vimrcs are sourced in |dpp#min#load_state()| before hooks.
		NOTE: It must be set before |dpp#make_state()|.
		NOTE: The files must not be included "<<" pattern(here
		document).  It breaks the parser.
		NOTE: It also supports ".lua" file for neovim.

		Defaults: []

                                                  *dpp-option-protocolOptions*
protocolOptions		(dictionary)
		It is a dictionary that maps protocol names to its options.
		The options with the name "_" is used as the options for all
		names.
		See also |dpp-protocol-options|.

		Default: {}

                                                   *dpp-option-protocolParams*
protocolParams		(dictionary)
		It is a dictionary that maps protocol names to its parameters.
		See also |dpp-protocol-params|.

		Default: {}
                                                     *dpp-option-protocols*
protocols		(string[])
		It is a list of protocol names.
		
		Default: []

------------------------------------------------------------------------------
FUNCTIONS                                                      *dpp-functions*

                                                      *dpp#async_ext_action()*
dpp#async_ext_action({ext-name}, {action-name}[, {action-params}])
		Fire {action-name} action with {action-params} by {ext-name}
		ext asynchronously.
		{action-params} behavior depends on {action-name}.
		NOTE: It must be executed after |dpp#min#load_state()|.
		NOTE: It must be called after |DenopsReady|.

                                                           *dpp#check_files()*
dpp#check_files([{name}])
		Check dpp.vim cache file is outdated.
		{name} is plugins profile name.  The default is "vim" or
		"nvim".
		If it is outdated, |dpp#make_state()| is called
		automatically.
		It should be called when |BufWritePost| autocmd.

                                                           *dpp#clear_state()*
dpp#clear_state([{name}])
		Remove state file which is created by |dpp#make_state()|.
		{name} is plugins profile name.  The default is "vim" or
		"nvim".

                                                                   *dpp#get()*
dpp#get([{plugin-name}])
		Get the plugin options dictionary for {plugin-name}.
		If you omit {plugin-name}, dpp will return the plugins
		dictionary.  The key is the plugin name.  The value is the
		plugin dictionary.

                                                            *dpp#make_state()*
dpp#make_state({base-path}, {config-path}[, {name}])
		Save dpp's state in the cache script.
		{base-path} is where your downloaded plugins will be placed.
		{config-path} is TypeScript configuration file path to make
		state.  It must be full path.
		{name} is plugins profile name.  The default is "vim" or
		"nvim".
		When the state file is created,
		|dpp-autocmd-Dpp:makeStatePost| event is fired.
		NOTE: It must be called after |DenopsReady|.
		NOTE: It saves your 'runtimepath' completely, you must not
		call it after change 'runtimepath' dynamically.

		The TypeScript configuration script must returns following
		object.

		checkFiles	(string[])	(Optional)
			Check files when update timestamp.
			Default: []

		plugins		(Plugin[])	(Required)
			Plugins list.

		stateLines	(string[])	(Optional)
			The additional state lines depends on exts.

                                                        *dpp#min#load_state()*
dpp#min#load_state({base-path}[, {name}])
		Load dpp's state from the cache script, {base-path} is where
		your downloaded plugins will be placed.
		{name} is plugins profile name.  The default is "vim" or
		"nvim".
		NOTE: It overwrites your 'runtimepath' completely, you must
		not call it after change 'runtimepath' dynamically.
		NOTE: The block is skipped if dpp's state is loaded.

		It returns 1, if the cache script is old or invalid or not
		found.
                                                                *dpp#source()*
dpp#source([{name}])
		|:source|  the plugins specified by {name}.
		{name} is the plugins name list.
		If you omit it, dpp will source all plugins.
		It returns sourced plugins list.

                                                       *dpp#sync_ext_action()*
dpp#sync_ext_action({ext-name}, {action-name}[, {action-params}])
		Fire {action-name} action with {action-params} by {ext-name}
		ext synchronously.
		{action-params} behavior depends on {action-name}.
		NOTE: It must be executed after |dpp#min#load_state()|.
		NOTE: It must be called after |DenopsReady|.

------------------------------------------------------------------------------
PLUGIN OPTIONS                                            *dpp-plugin-options*

		The {plugin-options} accepts the following keys:

                                                   *dpp-plugin-option-augroup*
augroup		(String)
		An augroup name that the plugin uses for |VimEnter| or
		|GUIEnter| autocmd events.

                                                    *dpp-plugin-option-build*
build		(String)
		Specify the build script.
		This command is executed by |system()| in the plugin
		runtimepath.
		NOTE: In previous versions of dpp, build could also be of
		type dictionary, but that is now deprecated.
		Please use |dpp-plugin-option-hook_post_update| instead.

                                              *dpp-plugin-option-denops_wait*
denops_wait	(Bool)
		If set to v:false, dpp doesn't wait until the denops plugin
		is loaded.

		NOTE: It is danger option.  The plugin does not work well.

                                                   *dpp-plugin-option-depends*
depends		(List or String)
		Specify a list of plugins a plugin depends on.
		List items are '{plugin-name}'.
		Those specified in the list are NOT installed automatically.
		NOTE: The loading order is not guaranteed in non lazy plugins.

                                                    *dpp-plugin-option-frozen*
frozen		(Bool)
		If set to v:true, dpp doesn't update it automatically. It is
		useful for outdated plugins that can no longer be updated.

                                                  *dpp-plugin-option-ftplugin*
ftplugin	(Dictionary)
		"_" key is executed after all ftplugin.
		"{filetype}" key is executed {filetype} ftplugin.
		"lua_{filetype}" key is executed {filetype} ftplugin as
		|:lua|.
		NOTE: You need to call |dpp#clear_state()| after vimrc is
		changed.

                                                        *dpp-plugin-option-if*
if		(Bool) or (String)
		If set to |v:false|, dpp doesn't load the plugin.
		If it is |String|, dpp will eval it.
		If you don't set it, dpp will register (enable) the plugin.
		NOTE: You cannot disable plugins register in dpp if you use
		the option.

                                                      *dpp-plugin-option-lazy*
lazy		(Bool)
		If set to v:true, dpp doesn't add the path to 'runtimepath'
		automatically.
		If you don't set it, dpp will set it automatically when the
		conditions are met.
		NOTE: You should not specify the plugins which have no
		"plugin/" directory as lazy load plugins.  It is meaningless
		and just increases the overhead.
		NOTE: To load lazy plugins, you need to install
		"dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                    *dpp-plugin-option-merged*
merged		(Bool)
		If set to v:false, dpp doesn't merge the plugin directory.
		It is useful for the plugin files conflicts.

		Default: See |dpp-merge|.

                                            *dpp-plugin-option-merge_ftdetect*
merge_ftdetect	(Bool)
		If set to v:true, dpp merge the plugin "ftdetect" directory.
		It is useful to enable file detection when lazy loaded plugin.
		NOTE: It does not work if ftdetect script depends on lazy
		plugin functions.

                                                      *dpp-plugin-option-name*
name		(String)
		Specify the name of the plugin.  This is used for dpp
		management and other functions.  If it is omitted, the tail of
		the repository name will be used.
		NOTE: Must be unique across the all plugin.  If the plugin
		name conflicts with another plugin, dpp will overwrite the
		previous settings with the new one.  If the repo tail is bound
		to conflict, you can set the "name" option manually to prevent
		overwriting an existing plugin setting.

                                           *dpp-plugin-option-normalized_name*
normalized_name	(String)
		Specify the normalized name of the plugin.  If omitted, dpp
		will normalize the tail of the repository name.
		NOTE: Must be unique across all plugins.
		Normalized name example:
		name            : normalized name

		denite.nvim       denite
		dpp.vim           dpp
		vim-quickrun      quickrun
		dps-dial          dial
		denops-foo        foo

                                                    *dpp-plugin-option-on_cmd*
on_cmd		(List) or (String)
		If it is matched to the executed command name, dpp will call
		|dpp#source()|.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

		Default: Prefix match name from |dpp-plugin-option-name|.

                                                  *dpp-plugin-option-on_event*
on_event	(String) or (List)
		dpp will call |dpp#source()| on the events.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                   *dpp-plugin-option-on_func*
on_func		(List) or (String)
		If it is matched to the called function name, dpp will call
		|dpp#source()|.
		NOTE: It does not work when Vim initialized.
		NOTE: It does not work for Vim9 script. It is |FuncUndefined|
		limitation.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

		Default: Prefix match name from |dpp-plugin-option-name|.

                                                     *dpp-plugin-option-on_ft*
on_ft		(List) or (String)
		If it is matched to 'filetype', dpp will call
		|dpp#source()|.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                     *dpp-plugin-option-on_if*
on_if		(String)
		If it is evaluated and it is non-zero, dpp will call
		|dpp#source()|.
		The default evaluate timings are "BufRead", "BufNewFile",
		"VimEnter" and "FileType".
		If |dpp-plugin-option-on_event| exists, it is evaluated when
		|dpp-plugin-option-on_event|.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                    *dpp-plugin-option-on_lua*
on_lua		(List) or (String)
		If it is matched to the required lua module root, dpp will
		call |dpp#source()|.
		NOTE: It is for neovim only.
		NOTE: It does not work for neovim standard modules and require
		in |vim.loop| modules.
		NOTE: You cannot require on_lua plugins in
		|dpp-plugin-option-hook_add|.  Because the plugins are not
		initialized.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                    *dpp-plugin-option-on_map*
on_map		(Dictionary) or (List) or (String)
		If it is the Dictionary, the key is {mode} and the items are
		{mapping} or [{mapping1}, {mapping2}, ...].
		If it is the List, the items are {mapping} or [{mode},
		{mapping1}, [{mapping2}, ...]].
		If {mode} is omitted, "nxo" is used.
		NOTE: You can use plugin prefix mappings.
		For example, you can use "<Plug>(ref-" instead of
		"<Plug>(ref-back)" and so on.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                   *dpp-plugin-option-on_path*
on_path		(List) or (String)
		If set to ".*", dpp will call |dpp#source()| on editing all
		files.  Otherwise, dpp will call |dpp#source()| if the
		buffer name is matched to the string pattern.
		NOTE: It is useful for explorer behavior plugins.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                 *dpp-plugin-option-on_source*
on_source	(List) or (String)
		Load the plugin before the listed plugins are loaded.
		NOTE: The plugins must be lazy loaded plugins.
		NOTE: To use the feature, you need to install "dpp-ext-lazy".
		https://github.com/Shougo/dpp-ext-lazy

                                                      *dpp-plugin-option-path*
path		(String)
		Specify the plugin downloaded path.

		Default:
		"{base-path}/repos/{site-name}/{user-name}/{plugin-name}"

                                                       *dpp-plugin-option-rev*
rev		(String)
		Specify a revision number or branch/tag name.
		If it is "*" in "git" type, dpp will use latest released tag.
		You can specify the wildcards like "0.*".
		NOTE: If the type is "raw", rev must be hash number.

rtp		(String)
		Specify the runtime path.
		You can use it when the repository has the Vim plugin in a
		subdirectory.
		For example: https://github.com/rstacruz/sparkup
		If it is empty string, dpp will not add the path to
		'runtimepath'

		Default: Same of |dpp-plugin-option-path|


------------------------------------------------------------------------------
HOOKS                                                              *dpp-hooks*

		The string will be split by the lines.
		It is useful for the plugins initialization.

		NOTE: You cannot use function hooks in |dpp#make_state()|.
		NOTE: The loading order is not guaranteed in non lazy plugins.
		NOTE: The string is executed as Ex commands.

		You can use |Vim9| script for hooks.  But you cannot use
		|Vim9| script in global |dpp-plugin-option-hook_add|.  Because
		it may be merged for optimize.

		To use |Vim9| script, you need to use |:vim9script| or |:def|.
		NOTE: |Vim9| script syntax is very strict and it is hard to
		debug.  It is experimental feature.

                                                *dpp-plugin-option-hooks_file*
hooks_file	(String) or (List)
		Hooks file path.  It must be valid path.
		It is useful to define long hooks.

		The file format is:

		{hook_name} {start_marker}
		...
		{end_marker}

		{start_marker} and {end_marker} are from
		|dpp-option-hooksFileMarker|.
		{hook_name} is "hook_xxx" or "lua_xxx" or
		|dpp-plugin-option-ftplugin| filetype.

		Example:
>
		" hook_source {{{
		let g:foo = 'bar'
		" }}}
		" cpp {{{
		let g:bar = 'baz'
		" }}}
		" Use vim9script
		" hook_update {{{
		vim9script
		g:bar = 'baz'
		" }}}
<
                                                  *dpp-plugin-option-hook_add*
hook_add	(String)
		It is executed after the plugin is added.
		It is mainly used for defining mappings.
		NOTE: You cannot call plugin function in "hook_add".
		Because the plugin is not sourced when "hook_add".

                                       *dpp-plugin-option-hook_depends_update*
hook_depends_update (String)
		It is executed after |dpp-plugin-option-depends| plugins are
		updated.

                                          *dpp-plugin-option-hook_done_update*
hook_done_update (String)
		It is executed after plugins are updated.

                                          *dpp-plugin-option-hook_post_source*
hook_post_source (String)
		It is executed after the plugin script files are sourced.

		NOTE: In Vim initializing, you must call the
		"hook_post_source" hooks manually in |VimEnter| if needed.
>
		autocmd VimEnter * call dpp#call_hook('post_source')
<
                                          *dpp-plugin-option-hook_post_update*
hook_post_update (String)
		It is executed after are updated and before
		|dpp-plugin-option-build|.
		NOTE: The plugin may not be sourced.

                                               *dpp-plugin-option-hook_source*
hook_source	(String) or (Function)
		It is executed after plugin runtimepath is added and before
		the plugin script files are sourced.
		It is mainly used for plugin configure.
		NOTE: The "sourced" means after |dpp#min#load_state()| or when
		|VimEnter| or autoloaded.

                                                   *dpp-plugin-option-lua_add*
lua_add		(String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_add| key.
		NOTE: It works only for neovim or |+lua|.

                                        *dpp-plugin-option-lua_depends_update*
lua_depends_update (String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_depends_update|
		key.
		NOTE: It works only for neovim or |+lua|.

                                           *dpp-plugin-option-lua_done_update*
lua_done_update	(String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_done_update| key.
		NOTE: It works only for neovim or |+lua|.

                                           *dpp-plugin-option-lua_post_source*
lua_post_sources (String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_post_source| key.
		NOTE: It works only for neovim or |+lua|.

                                           *dpp-plugin-option-lua_post_update*
lua_post_update	(String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_post_update| key.
		NOTE: It works only for neovim or |+lua|.

                                                *dpp-plugin-option-lua_source*
lua_source	(String)
		Lua language string hook instead of Vim script.
		It is converted to |dpp-plugin-option-hook_source| key.
		NOTE: It works only for neovim or |+lua|.

------------------------------------------------------------------------------
LUA FUNCTIONS                                              *dpp-lua-functions*

                                                      *dpp.async_ext_action()*
dpp.async_ext_action({ext-name}, {action-name}[, {action-params}])
		Same as |dpp#async_ext_action()|.

                                                           *dpp.check_files()*
dpp.check_files([{name}])
		Same as |dpp#check_files()|.

                                                           *dpp.clear_state()*
dpp.clear_state([{name}])
		Same as |dpp#clear_state()|.

                                                                   *dpp.get()*
dpp.get([{plugin-name}])
		Same as |dpp#get()|.
                                                            *dpp.load_state()*
dpp.load_state({base-path}, {name})
		Same as |dpp#min#load_state()|.

                                                            *dpp.make_state()*
dpp.make_state({base-path}, {config-path}[, {name}])
		Same as |dpp#make_state()|.

                                                                *dpp.source()*
dpp.source([{name}])
		Same as |dpp#source()|.

                                                       *dpp.sync_ext_action()*
dpp.sync_ext_action({ext-name}, {action-name}[, {action-params}])
		Same as |dpp#sync_ext_action()|.

==============================================================================
DDU SOURCES                                                  *dpp-ddu-sources*

                                                          *dpp-ddu-source-dpp*
dpp
		Nominates dpp plugins as items.


==============================================================================
EXAMPLES                                                        *dpp-examples*
>
	" Ward off unexpected things that your distro might have made, as
	" well as sanely reset options when re-sourcing .vimrc
	set nocompatible
	
	" Set dpp base path (required)
	const s:dpp_base = '~/.cache/dpp/'
	
	" Set dpp source path (required)
	" NOTE: The plugins must be cloned before.
	const s:dpp_src = '~/.cache/dpp/repos/github.com/Shougo/dpp.vim'
	const s:denops_src = '~/.cache/dpp/repos/github.com/denops/denops.vim'

	" Set dpp runtime path (required)
	execute 'set runtimepath^=' .. s:dpp_src
	
	if s:dpp_base->dpp#min#load_state()
	  " NOTE: dpp#make_state() requires denops.vim
	  execute 'set runtimepath^=' .. s:denops_src
	  autocmd User DenopsReady
	  \ call dpp#make_state(s:dpp_base, '{TypeScript config file path}')
	endif
	
	" Attempt to determine the type of a file based on its name and
	" possibly its " contents. Use this to allow intelligent
	" auto-indenting " for each filetype, and for plugins that are
	" filetype specific.
	filetype indent plugin on
	
	" Enable syntax highlighting
	if has('syntax')
	  syntax on
	endif
<

==============================================================================
PLUGINS MERGED FEATURE                                             *dpp-merge*

dpp.vim copies the files of multiple plugins into a single directory and
loads them as plugins by default.  It expects to improve performance.

That path is usually `dpp_INSTALLED_DIR/.cache/init.vim/.dpp`.

Other plugin managers add a plugin path into 'runtimepath' to load external
plugins.  However, if the 'runtimepath' is very large then it will load
slowly.  This is because Vim needs to find and load all 'runtimepath' to load
plugins.  In dpp.vim, this problem does not exist.

The following plugins will not be merged to prevent merge problems
- |dpp-plugin-option-merged| is v:false
- local plugin (dpp-ext-local)
- lazy loaded plugin (|dpp-plugin-option-lazy|)
- uses |dpp-plugin-option-build|
- uses |dpp-plugin-option-hook_post_update|
- uses |dpp-plugin-option-if|

==============================================================================
EXTS                                                                *dpp-exts*

NOTE: The Exts are not bundled in dpp.vim.  You need to install them
to use dpp.vim.  Please search them by https://github.com/topics/dpp-ext


------------------------------------------------------------------------------
EXT OPTIONS                                                  *dpp-ext-options*

NOTE: The Exts cannot set default options.  If they need to specify the
recommended configuration, you should write it in the documentation instead.


------------------------------------------------------------------------------
EXT PARAMS                                                    *dpp-ext-params*

These are the parameters that each Ext can have.  Please read the Ext
documentation.


==============================================================================
PROTOCOLS                                                      *dpp-protocols*

NOTE: The Protocols are not bundled in dpp.vim.  You need to install them
to use dpp.vim.  Please search them by https://github.com/topics/dpp-protocol


------------------------------------------------------------------------------
PROTOCOL OPTIONS                                        *dpp-protocol-options*

NOTE: The Protocols cannot set default options.  If they need to specify the
recommended configuration, you should write it in the documentation instead.

------------------------------------------------------------------------------
PROTOCOL PARAMS                                          *dpp-protocol-params*

These are the parameters that each Protocol can have.  Please read the
Protocol documentation.


==============================================================================
AUTOCMDS                                                        *dpp-autocmds*

dpp.vim defines some |User| autocmds.

                                               *dpp-autocmd-Dpp:extActionPost*
Dpp:extActionPost:{ext-name}:{action-name}
		Called after |dpp#sync_ext_action()| or
		|dpp#async_ext_action()| is finished.

                                               *dpp-autocmd-Dpp:makeStatePost*
Dpp:makeStatePost
		Called after |dpp#make_state()| is finished.
>
		" Auto exit after dpp#make_state()
		autocmd User Dpp:makeStatePost quit!
<


==============================================================================
CREATE EXT                                                    *dpp-create-ext*

To create ext, you should read other exts implementation.

The ext must put under "denops/@dpp-exts/*.ts".

The ext class must extend the "BaseExt" class.

NOTE: It must be written in TypeScript language.

NOTE: If you call Vim functions, it is not asynchronous.


------------------------------------------------------------------------------
EXT ATTRIBUTES                                            *dpp-ext-attributes*

                                                   *dpp-ext-attribute-actions*
actions			(Record<string, function>)	(Required)
		Defines ext specific actions.

                                                    *dpp-ext-attribute-onInit*
onInit			(function)			(Optional)
		Called before call ext functions.

                                                    *dpp-ext-attribute-params*
params			(function)			(Required)
		Called to get ext params.


==============================================================================
CREATE PROTOCOL                                          *dpp-create-protocol*

To create protocol, you should read other protocols implementation.

The protocol must put under "denops/@dpp-protocols/*.ts".

The protocol class must extend the "BaseProtocol" class.

NOTE: It must be written in TypeScript language.

NOTE: If you call Vim functions, it is not asynchronous.


------------------------------------------------------------------------------
PROTOCOL ATTRIBUTES                                  *dpp-protocol-attributes*

                                               *dpp-protocol-attribute-detect*
detect			(function)			(Optional)
		Called to detect plugin's protocol.

                                       *dpp-protocol-attribute-getDiffCommand*
getDiffCommand		(function)			(Optional)
		Called to get updated diff command.

                                       *dpp-protocol-attribute-getLogCommand*
getLogCommand		(function)			(Optional)
		Called to get repository synchronous command.

                                          *dpp-protocol-attribute-getRevision*
getRevisionLockCommand	(function)			(Optional)
		Called to get current revision.

                               *dpp-protocol-attribute-getRevisionLockCommand*
getRevisionLockCommand	(function)			(Optional)
		Called to get revision lock command.

                                       *dpp-protocol-attribute-getSyncCommand*
getSyncCommand		(function)			(Optional)
		Called to get repository synchronous command.

                                               *dpp-protocol-attribute-onInit*
onInit			(function)			(Optional)
		Called before call protocol functions.

                                               *dpp-protocol-attribute-params*
params			(function)			(Required)
		Called to get protocol params.


==============================================================================
FAQ                                                                  *dpp-faq*

FAQ 1:							|dpp-faq-1|
	How to donate money to you?

FAQ 2:							|dpp-faq-2|
	What means "dark powered"?

FAQ 3:							|dpp-faq-3|
	Why dpp.vim uses Deno?

FAQ 4:							|dpp-faq-4|
	I want to update cache file automatically when the config is updated.

FAQ 5:							|dpp-faq-5|
	I want to use dpp functions in lua.

FAQ 6:							|dpp-faq-6|
	|DenopsReady| is not executed when |dpp#min#load_state()| is failed.

------------------------------------------------------------------------------
                                                                   *dpp-faq-1*
Q: How to donate money to you?

A: I have started github sponsorship to spend more time for Vim/neovim
plugins.  You can donate money to help me!

   https://github.com/sponsors/Shougo

                                                                   *dpp-faq-2*
Q: What means "dark powered"?

A: I think text editor is everything in the world. I want to do everything in
Vim(neovim) like Emacs. It is not allowed by |design-not| in Vim. It is not
the light way to use Vim. So I have defined it as the dark way. I am the dark
Vimmer. My plugins are dark powered.

                                                                   *dpp-faq-3*
Q: Why dpp.vim uses Deno?

A: Deno is asynchronous and faster than Vim script and it can be used in both
Vim and neovim.  The features are what I desired.
I have created some plugins by TypeScript.  The development is very fun and
easy to maintain.

                                                                   *dpp-faq-4*
Q: I want to update cache file automatically when the config is updated.

A: You need to set checkFiles when |dpp#make_state()| and you need to call
|dpp#check_files()| like this.
>
  autocmd BufWritePost *.lua,*.vim,*.toml,*.ts,vimrc,.vimrc
            \ call dpp#check_files()
<

                                                                   *dpp-faq-5*
Q: I want to use dpp functions in lua.

A: You can use |dpp-lua-functions| like this.

>
  lua <<END
  vim.opt.runtimepath:prepend({dpp src path})

  local dpp = require("dpp")

  local dppBase = "~/.cache/dpp"
  if dpp.load_state(dppBase) then
    vim.opt.runtimepath:prepend({denops src path})

    vim.api.nvim_create_autocmd("User", {
      pattern = "DenopsReady",
      callback = function()
        vim.notify("dpp load_state() is failed")
        dpp.make_state(dppBase, {TypeScript config file path})
      end,
    })
  end

  vim.api.nvim_create_autocmd("User", {
    pattern = "Dpp:makeStatePost",
    callback = function()
      vim.notify("dpp make_state() is done")
    end,
  })
END
<

                                                                   *dpp-faq-6*
Q: |DenopsReady| is not executed when |dpp#min#load_state()| is failed.

A: "plugin/denops.vim" is not loaded.  I think you have enabled "--noplugin".
You need to execute "plugin/denops.vim" manually by |:runtime| command.

>
  runtime! plugin/denops.vim
<

==============================================================================
COMPATIBILITY                                              *dpp-compatibility*

2023.12.06
* Remove "convertImportPaths".

==============================================================================
vim:tw=78:ts=8:ft=help:norl:noet:fen:noet: