- Renamed documentation.

This commit is contained in:
Shougo Matsushita 2012-09-27 21:17:07 +09:00
parent 7f3241815d
commit 60eb5de99c

View File

@ -1,7 +1,7 @@
*neocomplcache-snippets-complete.txt* *neosnippet.txt*
neocomplcache complete snippets source neo-snippet plugin contains neocomplcache snippets source
Version: 2.0 Version: 3.0
Author : Shougo <Shougo.Matsu@gmail.com> Author : Shougo <Shougo.Matsu@gmail.com>
License: MIT license {{{ License: MIT license {{{
Permission is hereby granted, free of charge, to any person obtaining Permission is hereby granted, free of charge, to any person obtaining
@ -23,44 +23,46 @@ License: MIT license {{{
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
}}} }}}
CONTENTS *neocomplcache-snippets-complete-contents* CONTENTS *neosnippet-contents*
Introduction |neocomplcache-snippets-complete-introduction| Introduction |neosnippet-introduction|
Install |neocomplcache-snippets-complete-install| Install |neosnippet-install|
Interface |neocomplcache-snippets-complete-interface| Interface |neosnippet-interface|
Commands |neocomplcache-snippets-complete-commands| Commands |neosnippet-commands|
Variables |neocomplcache-snippets-complete-variables| Variables |neosnippet-variables|
Key mappings |neocomplcache-snippets-complete-key-mappings| Key mappings |neosnippet-key-mappings|
Functions |neocomplcache-snippets-complete-functions| Functions |neosnippet-functions|
Examples |neocomplcache-snippets-complete-examples| Examples |neosnippet-examples|
Snippet syntax |neocomplcache-snippets-complete-snippet-syntax| Snippet syntax |neosnippet-snippet-syntax|
Changelog |neocomplcache-snippets-complete-changelog| Changelog |neosnippet-changelog|
============================================================================== ==============================================================================
INTRODUCTION *neocomplcache-snippets-complete-introduction* INTRODUCTION *neosnippet-introduction*
This source analyzes snippet files for completion, offers functionality This source analyzes snippet files for completion, offers functionality
similar to snipMate.vim or snippetsEmu.vim. Since you can choose snippet with similar to snipMate.vim or snippetsEmu.vim. Since you can choose snippet with
neocomplcache interface, you might have less trouble learning it. neocomplcache interface, you might have less trouble learning it.
============================================================================== ==============================================================================
INSTALL *neocomplcache-snippets-complete-install* INSTALL *neosnippet-install*
1: Install neocomplcache (https://github.com/Shougo/neocomplcache). 1: Install neocomplcache (https://github.com/Shougo/neocomplcache).
2: Extract the file and put files in your Vim directory 2: Extract the file and put files in your Vim directory
(usually ~/.vim/ or Program Files/Vim/vimfiles on Windows). (usually ~/.vim/ or Program Files/Vim/vimfiles on Windows).
============================================================================== ==============================================================================
INTERFACE *neocomplcache-snippets-complete-interface* INTERFACE *neosnippet-interface*
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
COMMANDS *neocomplcache-snippets-complete-commands* COMMANDS *neosnippet-commands*
:NeoComplCacheCachingSnippets [filetype] *:NeoComplCacheCachingSnippets* :NeoComplCacheCachingSnippets [filetype]
*:NeoComplCacheCachingSnippets*
Makes cache of [filetype] snippets. It automatically selects Makes cache of [filetype] snippets. It automatically selects
current buffer's filetype unless you specify [filetype]. current buffer's filetype unless you specify [filetype].
:NeoComplCacheEditSnippets [filetype] *:NeoComplCacheEditSnippets* :NeoComplCacheEditSnippets [filetype]
*:NeoComplCacheEditSnippets*
Opens [filetype] snippets to edit. It automatically selects Opens [filetype] snippets to edit. It automatically selects
current buffer's filetype unless you specify [filetype]. current buffer's filetype unless you specify [filetype].
@ -71,7 +73,8 @@ COMMANDS *neocomplcache-snippets-complete-commands*
|g:neocomplcache_snippets_dir| with precedence. |g:neocomplcache_snippets_dir| with precedence.
Re-cache will be done automatically when you save the file. Re-cache will be done automatically when you save the file.
:NeoComplCacheEditRuntimeSnippets [filetype] *:NeoComplCacheEditRuntimeSnippets* :NeoComplCacheEditRuntimeSnippets [filetype]
*:NeoComplCacheEditRuntimeSnippets*
Opens [filetype] snippets to edit. It automatically selects Opens [filetype] snippets to edit. It automatically selects
current buffer's filetype unless you specify [filetype]. current buffer's filetype unless you specify [filetype].
@ -83,7 +86,7 @@ COMMANDS *neocomplcache-snippets-complete-commands*
you save the file. you save the file.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
VARIABLES *neocomplcache-snippets-complete-variables* VARIABLES *neosnippet-variables*
g:neocomplcache_snippets_dir *g:neocomplcache_snippets_dir* g:neocomplcache_snippets_dir *g:neocomplcache_snippets_dir*
This variable appoints a path to user-defined snippet files. This variable appoints a path to user-defined snippet files.
@ -95,7 +98,8 @@ g:neocomplcache_snippets_dir *g:neocomplcache_snippets_dir*
This variable doesn't exist unless you declare it. This variable doesn't exist unless you declare it.
g:neocomplcache_disable_select_mode_mappings *g:neocomplcache_disable_select_mode_mappings* g:neocomplcache_disable_select_mode_mappings
*g:neocomplcache_disable_select_mode_mappings*
This variable controls whether to disable Key-mappings in This variable controls whether to disable Key-mappings in
|Select-mode| when snippets_complete performs. Usually you |Select-mode| when snippets_complete performs. Usually you
had better enable it. had better enable it.
@ -110,27 +114,32 @@ g:neocomplcache_snippets_disable_runtime_snippets
Default value is 0. Default value is 0.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
KEY MAPPINGS *neocomplcache-snippets-complete-key-mappings* KEY MAPPINGS *neosnippet-key-mappings*
<Plug>(neocomplcache_snippets_expand) *<Plug>(neocomplcache_snippets_expand)* <Plug>(neocomplcache_snippets_expand)
*<Plug>(neocomplcache_snippets_expand)*
Expands a cursor snippet of plural lines. When there is no Expands a cursor snippet of plural lines. When there is no
snippet, jumps to the next placeholder. snippet, jumps to the next placeholder.
Note: It searches cursor snippet from keyword patterns in the Note: It searches cursor snippet from keyword patterns in the
first. first.
<Plug>(neocomplcache_snippets_jump) *<Plug>(neocomplcache_snippets_jump)* <Plug>(neocomplcache_snippets_jump)
*<Plug>(neocomplcache_snippets_jump)*
Jump to next placeholder. If there is no placeholder, expand a Jump to next placeholder. If there is no placeholder, expand a
multiline cursor snippet. multiline cursor snippet.
<Plug>(neocomplcache_snippets_force_expand) *<Plug>(neocomplcache_snippets_force_expand)* <Plug>(neocomplcache_snippets_force_expand)
*<Plug>(neocomplcache_snippets_force_expand)*
Expand a cursor snippet. Does nothing if there is no snippet. Expand a cursor snippet. Does nothing if there is no snippet.
<Plug>(neocomplcache_snippets_force_jump) *<Plug>(neocomplcache_snippets_force_jump)* <Plug>(neocomplcache_snippets_force_jump)
*<Plug>(neocomplcache_snippets_force_jump)*
Jump to next place holder. Do not expand any snippet. When Jump to next place holder. Do not expand any snippet. When
you do not want to expand a snippet name, use this keymapping. you do not want to expand a snippet name, use this keymapping.
<Plug>(neocomplcache_start_unite_snippet) *<Plug>(neocomplcache_start_unite_snippet)* <Plug>(neocomplcache_start_unite_snippet)
*<Plug>(neocomplcache_start_unite_snippet)*
Start unite snippet source. Start unite snippet source.
Note: This mappings is available in insert mode. Note: This mappings is available in insert mode.
@ -160,7 +169,7 @@ neocomplcache#sources#snippets_complete#jumpable()
Useful for saving keymappings. Useful for saving keymappings.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
FUNCTIONS *neocomplcache-snippets-complete-functions* FUNCTIONS *neosnippet-functions*
neocomplcache#sources#snippets_complete#get_snippets_dir() neocomplcache#sources#snippets_complete#get_snippets_dir()
*neocomplcache#sources#snippets_complete#get_snippets_dir()* *neocomplcache#sources#snippets_complete#get_snippets_dir()*
@ -169,7 +178,7 @@ neocomplcache#sources#snippets_complete#get_snippets_dir()
directories. directories.
============================================================================== ==============================================================================
EXAMPLES *neocomplcache-snippets-complete-examples* EXAMPLES *neosnippet-examples*
> >
" Plugin key-mappings. " Plugin key-mappings.
imap <C-k> <Plug>(neocomplcache_snippets_expand) imap <C-k> <Plug>(neocomplcache_snippets_expand)
@ -185,7 +194,7 @@ EXAMPLES *neocomplcache-snippets-complete-examples*
endif endif
< <
============================================================================== ==============================================================================
SNIPPET SYNTAX *neocomplcache-snippets-complete-snippet-syntax* SNIPPET SYNTAX *neosnippet-snippet-syntax*
The snippet syntax is similar to |snipMate|. The snippet syntax is similar to |snipMate|.
@ -199,7 +208,8 @@ Example:
endif endif
< <
snippet {snippet_name} syntax is the snippet name. snippet {snippet_name} syntax is the snippet name.
abbr {abbr_name} is the completion abbrevation (same to completion "abbr" key). abbr {abbr_name} is the completion abbrevation (same to completion "abbr"
key).
prev_word '^' means this snippet is enabled only in line head. prev_word '^' means this snippet is enabled only in line head.
By the way, it is warned that the snippet name was already defined by other By the way, it is warned that the snippet name was already defined by other
@ -284,12 +294,13 @@ languages' indent files can not work very well (e.g.: PHP, Python).
} }
< <
============================================================================== ==============================================================================
UNITE SOURCES *neocomplcache-snippets-complete-unite-sources* UNITE SOURCES *neosnippet-unite-sources*
*neocomplcache-snippets-complete-unite-source-snippet* *neosnippet-unite-source-snippet*
snippet snippet
The candidates are neocomplcache snippets. The kinds are "snippet". The candidates are neocomplcache snippets. The kinds are
Normally used in |<Plug>(neocomplcache_start_unite_snippet)| mappings. "snippet". Normally used in
|<Plug>(neocomplcache_start_unite_snippet)| mappings.
But you can execute it by ":Unite snippet". But you can execute it by ":Unite snippet".
You can edit snippet file in "edit" action. You can edit snippet file in "edit" action.
Examples: Examples:
@ -298,13 +309,20 @@ snippet
< <
source actions source actions
snippet *neocomplcache-snippets-complete-unite-action-snippet* snippet *neosnippet-unite-action-snippet*
expand Expand snippet (default action) expand Expand snippet (default action)
edit Edit snippet edit Edit snippet
preview View snippet definition preview View snippet definition
============================================================================== ==============================================================================
CHANGELOG *neocomplcache-snippets-complete-changelog* CHANGELOG *neosnippet-changelog*
2012-09-27
- Ver.3 development is started.
- Renamed documentation.
------------------------------------------------------------------------------
ChangeLog 2.0:
2012-09-27 2012-09-27
- Improved add placeholder behavior. - Improved add placeholder behavior.