Mercurial > public > dotfiles
comparison vim/vimfiles/doc/ctrlp.txt @ 0:48859d9c82c5
Initial commit, based on settings used at work (minus NERD tree & some
tagging plugins).
author | Brian Neal <bgneal@gmail.com> |
---|---|
date | Tue, 03 Jan 2012 20:53:13 -0600 |
parents | |
children | 92af3257a261 |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:48859d9c82c5 |
---|---|
1 *ctrlp.txt* Fuzzy file, buffer, mru and tag finder. v1.6.4 | |
2 *CtrlP* *ControlP* *'ctrlp'* *'ctrl-p'* | |
3 =============================================================================== | |
4 # # | |
5 # :::::::: ::::::::::: ::::::::: ::: ::::::::: # | |
6 # :+: :+: :+: :+: :+: :+: :+: :+: # | |
7 # +:+ +:+ +:+ +:+ +:+ +:+ +:+ # | |
8 # +#+ +#+ +#++:++#: +#+ +#++:++#+ # | |
9 # +#+ +#+ +#+ +#+ +#+ +#+ # | |
10 # #+# #+# #+# #+# #+# #+# #+# # | |
11 # ######## ### ### ### ########## ### # | |
12 # # | |
13 =============================================================================== | |
14 CONTENTS *ctrlp-contents* | |
15 | |
16 1. Intro........................................|ctrlp-intro| | |
17 2. Options......................................|ctrlp-options| | |
18 3. Commands.....................................|ctrlp-commands| | |
19 4. Mappings.....................................|ctrlp-mappings| | |
20 5. Input Formats................................|ctrlp-input-formats| | |
21 6. Extensions...................................|ctrlp-extensions| | |
22 | |
23 =============================================================================== | |
24 1. Intro *ctrlp-intro* | |
25 | |
26 Full path fuzzy file, buffer and MRU file finder with an intuitive interface. | |
27 Written in pure Vimscript for MacVim and Vim version 7.0+. Has full support for | |
28 Vim’s |regexp| as search pattern, built-in MRU monitoring, project’s root | |
29 finder, and more. | |
30 | |
31 To enable optional extensions (tag, quickfix, dir...), see |ctrlp-extensions|. | |
32 | |
33 =============================================================================== | |
34 2. Options *ctrlp-options* | |
35 | |
36 Below are the available options and their default values:~ | |
37 | |
38 *'g:ctrlp_map'* | |
39 Use this option to change the mapping to invoke |CtrlP| in |Normal| mode: > | |
40 let g:ctrlp_map = '<c-p>' | |
41 < | |
42 | |
43 *'g:loaded_ctrlp'* | |
44 Use this option to disable the plugin completely: > | |
45 let g:loaded_ctrlp = 1 | |
46 < | |
47 | |
48 *'g:ctrlp_by_filename'* | |
49 Set this to 1 to set search by filename (not full path) as the default: > | |
50 let g:ctrlp_by_filename = 0 | |
51 < | |
52 | |
53 *'g:ctrlp_regexp_search'* | |
54 Set this to 1 to set |regexp| search as the default: > | |
55 let g:ctrlp_regexp_search = 0 | |
56 < | |
57 | |
58 *'g:ctrlp_match_window_bottom'* | |
59 Set this to 0 to show the match window at the top of the screen: > | |
60 let g:ctrlp_match_window_bottom = 1 | |
61 < | |
62 | |
63 *'g:ctrlp_match_window_reversed'* | |
64 Reverse the sort order of the matched files in the match window. The default | |
65 setting is from bottom to top: > | |
66 let g:ctrlp_match_window_reversed = 1 | |
67 < | |
68 | |
69 *'g:ctrlp_max_height'* | |
70 Set the maximum height of the match window: > | |
71 let g:ctrlp_max_height = 10 | |
72 < | |
73 | |
74 *'g:ctrlp_jump_to_buffer'* | |
75 Set this to 0 to disable the jump-to-open-buffer feature. Set to 2 to also jump | |
76 tab if the selected buffer’s opened in another tab: > | |
77 let g:ctrlp_jump_to_buffer = 1 | |
78 < | |
79 | |
80 *'g:ctrlp_working_path_mode'* | |
81 When starting up the prompt, temporarily set the working directory (i.e. the | |
82 |current-directory|) to: | |
83 1 - the parent directory of the current file. | |
84 2 - the nearest ancestor that contains one of these directories/files: | |
85 .git/ | |
86 .hg/ | |
87 .bzr/ | |
88 _darcs/ | |
89 root.dir | |
90 .vimprojects | |
91 0 - don’t manage working directory. | |
92 > | |
93 let g:ctrlp_working_path_mode = 2 | |
94 < | |
95 | |
96 *'g:ctrlp_root_markers'* | |
97 Use this to set your own root markers in addition to the default ones. Your | |
98 markers will take precedence: > | |
99 let g:ctrlp_root_markers = [''] | |
100 < | |
101 These markers (builtins and yours) will serve as identifiers for the '/' and | |
102 '\' special inputs (section 5.e) | |
103 | |
104 *'g:ctrlp_use_caching'* | |
105 Set this to 0 to disable per-session caching. When disabled, caching will still | |
106 be enabled for directories that have more than 4000 files: > | |
107 let g:ctrlp_use_caching = 1 | |
108 < | |
109 Note: you can quickly purge the cache by pressing <F5> while inside |CtrlP|. | |
110 | |
111 *'g:ctrlp_clear_cache_on_exit'* | |
112 Set this to 0 to enable cross-sessions caching: > | |
113 let g:ctrlp_clear_cache_on_exit = 1 | |
114 < | |
115 | |
116 *'g:ctrlp_cache_dir'* | |
117 Set the directory to store the cache files: > | |
118 let g:ctrlp_cache_dir = $HOME.'/.ctrlp_cache' | |
119 < | |
120 | |
121 *'g:ctrlp_prompt_mappings'* | |
122 Use this to customize the mappings inside |CtrlP|’s prompt to your liking. You | |
123 only need to keep the lines that you’ve changed the values (inside []): > | |
124 let g:ctrlp_prompt_mappings = { | |
125 \ 'PrtBS()': ['<bs>'], | |
126 \ 'PrtDelete()': ['<del>'], | |
127 \ 'PrtDeleteWord()': ['<c-w>'], | |
128 \ 'PrtClear()': ['<c-u>'], | |
129 \ 'PrtSelectMove("j")': ['<c-j>', '<down>'], | |
130 \ 'PrtSelectMove("k")': ['<c-k>', '<up>'], | |
131 \ 'PrtHistory(-1)': ['<c-n>'], | |
132 \ 'PrtHistory(1)': ['<c-p>'], | |
133 \ 'AcceptSelection("e")': ['<cr>', '<2-LeftMouse>'], | |
134 \ 'AcceptSelection("h")': ['<c-x>', '<c-cr>', '<c-s>'], | |
135 \ 'AcceptSelection("t")': ['<c-t>', '<MiddleMouse>'], | |
136 \ 'AcceptSelection("v")': ['<c-v>', '<c-q>', '<RightMouse>'], | |
137 \ 'ToggleFocus()': ['<tab>'], | |
138 \ 'ToggleRegex()': ['<c-r>'], | |
139 \ 'ToggleByFname()': ['<c-d>'], | |
140 \ 'ToggleType(1)': ['<c-f>', '<c-up'], | |
141 \ 'ToggleType(-1)': ['<c-b>', '<c-down>'], | |
142 \ 'PrtCurStart()': ['<c-a>'], | |
143 \ 'PrtCurEnd()': ['<c-e>'], | |
144 \ 'PrtCurLeft()': ['<c-h>', '<left>'], | |
145 \ 'PrtCurRight()': ['<c-l>', '<right>'], | |
146 \ 'PrtClearCache()': ['<F5>'], | |
147 \ 'PrtDeleteMRU()': ['<F7>'], | |
148 \ 'CreateNewFile()': ['<c-y>'], | |
149 \ 'MarkToOpen()': ['<c-z>'], | |
150 \ 'OpenMulti()': ['<c-o>'], | |
151 \ 'PrtExit()': ['<esc>', '<c-c>', '<c-g>'], | |
152 \ } | |
153 < | |
154 If you have problem with <bs> moving left instead of deleting a char, add this | |
155 to your |vimrc|: > | |
156 let g:ctrlp_prompt_mappings = { | |
157 \ 'PrtBS()': ['<c-h>'], | |
158 \ 'PrtCurLeft()': ['<left>'], | |
159 \ } | |
160 < | |
161 | |
162 *'g:ctrlp_mruf_max'* | |
163 Specify the number of recently opened files you want |CtrlP| to remember: > | |
164 let g:ctrlp_mruf_max = 250 | |
165 < | |
166 | |
167 *'g:ctrlp_mruf_exclude'* | |
168 Files you don’t want |CtrlP| to remember; use |regexp| to specify the patterns: | |
169 > | |
170 let g:ctrlp_mruf_exclude = '' | |
171 < | |
172 Examples: > | |
173 let g:ctrlp_mruf_exclude = '/tmp/.*\|/temp/.*' " MacOSX/Linux | |
174 let g:ctrlp_mruf_exclude = '^C:\\dev\\tmp\\.*' " Windows | |
175 < | |
176 | |
177 *'g:ctrlp_mruf_include'* | |
178 And if you want |CtrlP| to only remember some files, specify them here: > | |
179 let g:ctrlp_mruf_include = '' | |
180 < | |
181 Example: > | |
182 let g:ctrlp_mruf_include = '\.py$\|\.rb$' | |
183 < | |
184 | |
185 *'g:ctrlp_mruf_case_sensitive'* | |
186 Match this with your file system case-sensitivity setting to avoid duplicate | |
187 MRU entries: > | |
188 let g:ctrlp_mruf_case_sensitive = 1 | |
189 < | |
190 | |
191 *'g:ctrlp_dotfiles'* | |
192 Set this to 0 if you don’t want |CtrlP| to search for dotfiles and dotdirs: > | |
193 let g:ctrlp_dotfiles = 1 | |
194 < | |
195 You can also use |'wildignore'| to exclude anything from the search. | |
196 e.g. exclude version control directories from the results: > | |
197 set wildignore+=*/.git/*,*/.hg/*,*/.svn/* " Linux/MacOSX | |
198 set wildignore+=.git\*,.hg\*,.svn\* " Windows | |
199 < | |
200 Note: the `*/` in front of each dotfile glob is required for the dotfiles | |
201 search feature to work correctly along side with |wildignore|. If you’ve | |
202 disabled dotfiles search (set |g:ctrlp_dotfiles| to 0), then you can ignore | |
203 this. | |
204 | |
205 Other note: |wildignore| influences the result of |expand()|, |globpath()| and | |
206 |glob()| which many plugins use to find stuff on the system (e.g. fugitive.vim | |
207 looks for .git/, some other plugins look for external exe tools on Windows). | |
208 So be a little mindful of what you put in your |wildignore|. | |
209 | |
210 *'g:ctrlp_highlight_match'* | |
211 Use this to enable/disable highlighting of the matched patterns and to specify | |
212 the highlight group that’ll be used: > | |
213 let g:ctrlp_highlight_match = [1, 'Identifier'] | |
214 < | |
215 | |
216 *'g:ctrlp_max_files'* | |
217 The maximum number of files to scan, set to 0 for no limit: > | |
218 let g:ctrlp_max_files = 20000 | |
219 < | |
220 | |
221 *'g:ctrlp_max_depth'* | |
222 The maximum depth of a directory tree to recurse into: > | |
223 let g:ctrlp_max_depth = 40 | |
224 < | |
225 Note: the larger these values, the more memory Vim uses. | |
226 | |
227 *'g:ctrlp_user_command'* | |
228 Specify an external tool to use for listing files instead of Vim’s globpath(). | |
229 Use %s in place of the target directory: > | |
230 let g:ctrlp_user_command = '' | |
231 < | |
232 Examples: > | |
233 let g:ctrlp_user_command = 'find %s -type f' " MacOSX/Linux | |
234 let g:ctrlp_user_command = 'dir %s /-n /b /s /a-d' " Windows | |
235 < | |
236 You can also use 'grep', 'findstr' or something else to filter the results. | |
237 Examples: > | |
238 let g:ctrlp_user_command = 'find %s -type f | grep (?!tmp/.*)' | |
239 let g:ctrlp_user_command = 'dir %s /-n /b /s /a-d | findstr .*\.py$' | |
240 < | |
241 Use a version control listing command when inside a repository, this is a lot | |
242 faster when working with large projects: > | |
243 let g:ctrlp_user_command = [repo_marker, vcs_ls_command, fallback_command] | |
244 < | |
245 If the fallback_command is empty or not defined, globpath() will then be used | |
246 when searching outside a repo. | |
247 Examples: > | |
248 let g:ctrlp_user_command = ['.git/', 'cd %s && git ls-files'] | |
249 let g:ctrlp_user_command = ['.hg/', 'hg --cwd %s locate --fullpath -I .'] | |
250 < | |
251 | |
252 *'g:ctrlp_open_new_file'* | |
253 Use this option to specify how the newly created file is to be opened when | |
254 pressing <c-y>: | |
255 1 - in a new tab | |
256 2 - in a new horizontal split | |
257 3 - in a new vertical split | |
258 0 - in the current window | |
259 > | |
260 let g:ctrlp_open_new_file = 3 | |
261 < | |
262 | |
263 *'g:ctrlp_max_history'* | |
264 The maximum number of input strings you want |CtrlP| to remember. The default | |
265 value mirrors Vim’s global |'history'| option: > | |
266 let g:ctrlp_max_history = &history | |
267 < | |
268 Set to 0 to disable prompt’s history. | |
269 | |
270 *'g:ctrlp_open_multi'* | |
271 If non-zero, this will enable opening multiple files with <c-z> and <c-o>: > | |
272 let g:ctrlp_open_multi = '1v' | |
273 < | |
274 For the number: | |
275 If bigger than 1, it’ll be used as the maximum number of windows or tabs to | |
276 create when opening the files (the rest will be hidden buffers). If is 1, | |
277 <c-o> will open all files, each in a new window or new tab. | |
278 For the letter: | |
279 t - each in a tab | |
280 h - each in a horizontal split | |
281 v - each in a vertical split | |
282 | |
283 *'g:ctrlp_dont_split'* | |
284 When opening a file with <cr>, |CtrlP| avoids opening it in windows created by | |
285 plugins, help and quickfix. Use this to setup some exceptions: > | |
286 let g:ctrlp_dont_split = '' | |
287 < | |
288 Acceptable values are partial names or filetypes of the special buffers. Use | |
289 |regexp| to specify the pattern. Example: > | |
290 let g:ctrlp_dont_split = 'netrw\|help' | |
291 < | |
292 | |
293 *'g:ctrlp_follow_symlinks'* | |
294 Set this to 1 to follow symbolic links when listing files: > | |
295 let g:ctrlp_follow_symlinks = 0 | |
296 < | |
297 | |
298 *'g:ctrlp_lazy_update'* | |
299 Set this to 1 to enable the lazy-update feature: only update the match window | |
300 after typing’s been stopped for a certain amount of time: > | |
301 let g:ctrlp_lazy_update = 0 | |
302 < | |
303 If is 1, update after 250ms. If bigger than 1, the number will be used as the | |
304 delay time in milliseconds. | |
305 | |
306 *'g:ctrlp_use_migemo'* | |
307 Set this to 1 to use Migemo Pattern for Japanese filenames. Migemo Search only | |
308 works in |regexp| mode. To split the pattern, separate words with space: > | |
309 let g:ctrlp_use_migemo = 0 | |
310 < | |
311 | |
312 =============================================================================== | |
313 3. Commands *ctrlp-commands* | |
314 | |
315 *:CtrlP* | |
316 :CtrlP [starting-directory] | |
317 Open |CtrlP| in find file mode. | |
318 | |
319 If no argument is given, the value of |g:ctrlp_working_path_mode| will be | |
320 used to determine the starting directory. | |
321 You can use <tab> to auto-complete the [starting-directory] when typing it. | |
322 | |
323 *:CtrlPBuffer* | |
324 :CtrlPBuffer | |
325 Open |CtrlP| in find buffer mode. | |
326 | |
327 *:CtrlPMRU* | |
328 :CtrlPMRU | |
329 Open |CtrlP| in find Most-Recently-Used file mode. | |
330 | |
331 *:ClearCtrlPCache* | |
332 :ClearCtrlPCache | |
333 Flush the cache for the current working directory. The same as pressing <F5> | |
334 inside |CtrlP|. | |
335 | |
336 *:ClearAllCtrlPCaches* | |
337 :ClearAllCtrlPCaches | |
338 Delete all the cache files saved in |ctrlp_cache_dir|. | |
339 | |
340 *:ResetCtrlP* | |
341 :ResetCtrlP | |
342 Reset all options, take in new values of the option variables in section 2. | |
343 | |
344 ------------------------------------------------------------------------------- | |
345 The following commands ignore the current value of |g:ctrlp_working_path_mode|: | |
346 | |
347 :CtrlPCurWD *:CtrlPCurWD* | |
348 This acts like |:CtrlP| with |path_mode| = 0 | |
349 | |
350 :CtrlPCurFile *:CtrlPCurFile* | |
351 This acts like |:CtrlP| with |path_mode| = 1 | |
352 | |
353 :CtrlPRoot *:CtrlPRoot* | |
354 This acts like |:CtrlP| with |path_mode| = 2 | |
355 | |
356 =============================================================================== | |
357 4. Mappings *ctrlp-mappings* | |
358 | |
359 *'ctrlp-<c-p>'* | |
360 <c-p> | |
361 Default |Normal| mode mapping to open the |CtrlP| prompt in find file mode. | |
362 | |
363 Once inside the prompt:~ | |
364 | |
365 <c-r> *'ctrlp-fullregexp'* | |
366 Toggle between the string mode (section 5.a & b) and full |regexp| mode. | |
367 (note: in full |regexp| mode, the prompt’s base is 'r>>' instead of '>>>') | |
368 | |
369 See also |input-formats| and |g:ctrlp_regexp_search|. | |
370 | |
371 <c-d> | |
372 Toggle between full path search and filename only search. | |
373 (note: in filename mode, the prompt’s base is '>d>' instead of '>>>') | |
374 | |
375 <c-f>, 'forward' | |
376 <c-up> | |
377 Scroll to the 'next' search mode in the sequence. | |
378 | |
379 <c-b>, 'backward' | |
380 <c-down> | |
381 Scroll to the 'previous' search mode in the sequence. | |
382 | |
383 <tab> | |
384 Toggle the focus between the match window and the prompt. | |
385 | |
386 <c-j>, | |
387 <down> | |
388 Move selection down | |
389 | |
390 <c-k>, | |
391 <up> | |
392 Move selection up | |
393 | |
394 <c-a> | |
395 Move the cursor to the 'start' of the prompt | |
396 | |
397 <c-e> | |
398 Move the cursor to the 'end' of the prompt | |
399 | |
400 <c-h>, | |
401 <left> | |
402 Move the cursor one character to the 'left' | |
403 | |
404 <c-l>, | |
405 <right> | |
406 Move the cursor one character to the 'right' | |
407 | |
408 <c-w> | |
409 Delete a preceding inner word | |
410 | |
411 <c-u> | |
412 Clear the input field | |
413 | |
414 <cr> | |
415 Open selected file in the active window if possible. | |
416 | |
417 <c-t> | |
418 Open selected file in a new 'tab' | |
419 | |
420 <c-v> | |
421 Open selected file in a 'vertical' split | |
422 | |
423 <c-cr>, | |
424 <c-s>, | |
425 <c-x> | |
426 Open selected file in a 'horizontal' split | |
427 | |
428 <c-y> | |
429 Create a new file and its parent directories. | |
430 | |
431 <c-n> | |
432 Next string in the prompt’s history | |
433 | |
434 <c-p> | |
435 Previous string in the prompt’s history | |
436 | |
437 <c-z> | |
438 Mark/unmark a file to be opened with <c-o>. | |
439 | |
440 <c-o> | |
441 Open files marked by <c-z>. | |
442 | |
443 <F5> | |
444 - Refresh the match window and purge the cache for the current directory. | |
445 - Remove deleted files from MRU list. | |
446 | |
447 <F7> | |
448 Clear MRU list. | |
449 | |
450 <esc>, | |
451 <c-c>, | |
452 <c-g> | |
453 Exit |CtrlP|. <c-c> can also be used to stop the file scan. | |
454 | |
455 Choose your own mappings with |g:ctrlp_prompt_mappings|. | |
456 | |
457 When inside the match window (press <tab> to switch):~ | |
458 | |
459 a-z | |
460 0-9 | |
461 ~^-=;`',.+!@#$%&_(){}[] | |
462 Cycle through the lines with the first letter (of paths or filenames) that | |
463 matches that key. | |
464 | |
465 =============================================================================== | |
466 5. Input Formats *ctrlp-input-formats* | |
467 | |
468 Formats for inputting in the prompt:~ | |
469 | |
470 a) Simple string. | |
471 e.g. 'abc' is understood internally as 'a[^a]\{-}b[^b]\{-}c' | |
472 | |
473 b) Vim |regexp|. If the input string contains '*' or '|', it’ll be treated as | |
474 a Vim’s |regexp| |pattern| without any modification. | |
475 e.g. 'abc\d*efg' will be read as 'abc\d*efg'. | |
476 | |
477 See also |ctrlp-fullregexp| (key map) and |g:ctrlp_regexp_search| (option). | |
478 | |
479 c) End the string with a colon ':' followed by a Vim command to execute that | |
480 command after opening the file. If you need to use ':' in the command, | |
481 escape it with a backslash: '\:'. | |
482 e.g. 'abc:45' will open the selected file and jump to line 45. | |
483 'abc:/my\:function' will open the selected file and jump to the first | |
484 instance of 'my:function'. | |
485 'abc:+setf\ myfiletype|50' will open the selected file and set its | |
486 filetype to 'myfiletype' then jump to line 50. | |
487 | |
488 See also Vim’s |++opt| and |+cmd|. | |
489 | |
490 d) Type exactly two dots '..' at the start of the prompt and press enter to go | |
491 backward in the directory tree by 1 level. If the parent directory is | |
492 large, this might be slow. | |
493 | |
494 e) Similarly submit '/' or '\' to find and go to the project’s root. If the | |
495 project is large, using a VCS listing command to look for files might help | |
496 speeding up the intial scan (see |g:ctrlp_user_command| for more details). | |
497 | |
498 f) Type the name of a non-existent file and press <c-y> to create it. | |
499 e.g. 'parentdir/file.txt' will create a directory named 'parentdir' as well | |
500 as 'file.txt'. | |
501 Use '\' in place of '/' on Windows (if |'ssl'| is not set). | |
502 | |
503 g) Submit ? to open this help file. | |
504 | |
505 =============================================================================== | |
506 6. Extensions *g:ctrlp-extensions* | |
507 | |
508 Extensions are optional. To enable an extension, add its name to the variable | |
509 g:ctrlp_extensions: > | |
510 let g:ctrlp_extensions = ['tag', 'quickfix', 'dir'] | |
511 < | |
512 The order of the items will be the order they appear on the statusline and when | |
513 using <c-f>, <c-b>. | |
514 | |
515 Available extensions:~ | |
516 | |
517 *:CtrlPTag* | |
518 * Tag mode:~ | |
519 - Name: 'tag' | |
520 - Command: ':CtrlPTag' | |
521 - Search for a tag within a generated central tags file, and jump to the | |
522 definition. Use the Vim’s option |'tags'| to specify the names and the | |
523 locations of the tags file(s). Example: `set tags+=tags/help,doc/tags` | |
524 | |
525 *:CtrlPQuickfix* | |
526 * Quickfix mode:~ | |
527 - Name: 'quickfix' | |
528 - Command: ':CtrlPQuickfix' | |
529 - Search for an entry in the current quickfix errors and jump to it. | |
530 | |
531 *:CtrlPDir* | |
532 * Directory mode:~ | |
533 - Name: 'dir' | |
534 - Command: ':CtrlPDir' | |
535 - Search for a directory and change the working directory to it. | |
536 - Mappings: | |
537 + <cr> change the local working directory for |CtrlP| and keep it open. | |
538 + <c-t> change the global working directory (exit). | |
539 + <c-v> change the local working directory for the current window (exit). | |
540 + <c-x> change the global working directory to |CtrlP|’s current local | |
541 working directory (exit). | |
542 | |
543 =============================================================================== | |
544 EXTENDING *ctrlp-extending* | |
545 | |
546 Extending |CtrlP| is very simple. Simply create a vim file following a short | |
547 guidelines, place it in autoload/ctrlp/ and add its name to your .vimrc. | |
548 | |
549 To see how it works, get the sample.vim from the extensions branch on the main | |
550 git repository (https://github.com/kien/ctrlp.vim/tree/extensions), and place | |
551 it along with the parent directories somewhere in your runtimepath. Then put | |
552 this into your .vimrc: > | |
553 let g:ctrlp_extensions = ['sample'] | |
554 < | |
555 A new search type will show up the next time you open |CtrlP|. | |
556 | |
557 For more details, check out the comments inside sample.vim.~ | |
558 | |
559 =============================================================================== | |
560 CREDITS *ctrlp-credits* | |
561 | |
562 Developed by Kien Nguyen <github.com/kien>, initially based on the Command-T | |
563 and the LustyExplorer plugins. No code was taken from these plugins, but I did | |
564 clone the majority of their (awesome) interfaces and the way they work. | |
565 | |
566 This was originally written as a module for a would-be larger plugin called | |
567 AutoDoc.vim which I’ve stopped developing because of lost of interest. I really | |
568 liked the way Command-T and LustyExplorer deal with user’s input, so I wrote a | |
569 pure Vimscript version of their prompt window, intended to use it for the | |
570 aforementioned plugin. | |
571 | |
572 Homepage: http://kien.github.com/ctrlp.vim | |
573 Git repository: https://github.com/kien/ctrlp.vim | |
574 Mercurial repository: https://bitbucket.org/kien/ctrlp.vim | |
575 | |
576 =============================================================================== | |
577 THANKS *ctrlp-thanks* | |
578 | |
579 Thanks to everyone that has submitted ideas, bug reports or helped debugging on | |
580 gibhub, bitbucket, and through email. | |
581 | |
582 Special thanks:~ | |
583 | |
584 * Woojong Koh <github.com/wjkoh> | |
585 Forked and suggested the support for VCS listing commands. | |
586 | |
587 * Yasuhiro Matsumoto <github.com/mattn> | |
588 Added option to use Migemo for Japanese language. | |
589 | |
590 =============================================================================== | |
591 CHANGELOG *ctrlp-changelog* | |
592 | |
593 Before 2011/11/30~ | |
594 | |
595 + New features: Tag, Quickfix and Directory extensions. | |
596 + New commands: |:CtrlPTag|, |:CtrlPQuickfix|, |:CtrlPDir|. | |
597 + New options: |g:ctrlp_use_migemo|, | |
598 |g:ctrlp_lazy_update|, | |
599 |g:ctrlp_follow_symlinks| | |
600 | |
601 Before 2011/11/13~ | |
602 | |
603 + New special input: '/' and '\' find root (section 5.e) | |
604 + Remove ctrlp#SetWorkingPath(). | |
605 + Remove |g:ctrlp_mru_files|, make MRU permanent. | |
606 + Extend |g:ctrlp_open_multi|, add new ways to open files. | |
607 + New option: |g:ctrlp_dont_split|, | |
608 |g:ctrlp_mruf_case_sensitive| | |
609 | |
610 Before 2011/10/30~ | |
611 | |
612 + New feature: Support for custom extensions. | |
613 <F5> also removes non-existent files from MRU list. | |
614 + New option: |g:ctrlp_jump_to_buffer| | |
615 | |
616 Before 2011/10/12~ | |
617 | |
618 + New features: Open multiple files. | |
619 Pass Vim’s |++opt| and |+cmd| to the opening file | |
620 (section 5.c) | |
621 Auto-complete each dir for |:CtrlP| [starting-directory] | |
622 + New mappings: <c-z> mark/unmark a file to be opened with <c-o>. | |
623 <c-o> open all marked files. | |
624 + New option: |g:ctrlp_open_multi| | |
625 + Remove |g:ctrlp_persistent_input|, |g:ctrlp_live_update| and <c-^>. | |
626 | |
627 Before 2011/09/29~ | |
628 | |
629 + New mappings: <c-n>, <c-p> next/prev string in the input history. | |
630 <c-y> create a new file and its parent dirs. | |
631 + New options: |g:ctrlp_open_new_file|, | |
632 |g:ctrlp_max_history| | |
633 + Added a new open-in-horizontal-split mapping: <c-x> | |
634 | |
635 Before 2011/09/19~ | |
636 | |
637 + New command: |ResetCtrlP| | |
638 + New options: |g:ctrlp_max_files|, | |
639 |g:ctrlp_max_depth|, | |
640 |g:ctrlp_live_update| | |
641 + New mapping: <c-^> | |
642 | |
643 Before 2011/09/12~ | |
644 | |
645 + Ability to cycle through matched lines in the match window. | |
646 + Extend the behavior of |g:ctrlp_persistent_input| | |
647 + Extend the behavior of |:CtrlP| | |
648 + New options: |g:ctrlp_dotfiles|, | |
649 |g:ctrlp_clear_cache_on_exit|, | |
650 |g:ctrlp_highlight_match|, | |
651 |g:ctrlp_user_command| | |
652 + New special input: '..' (section 5.d) | |
653 + New mapping: <F5>. | |
654 + New commands: |:CtrlPCurWD|, | |
655 |:CtrlPCurFile|, | |
656 |:CtrlPRoot| | |
657 | |
658 + New feature: Search in most recently used (MRU) files | |
659 + New mapping: <c-b>. | |
660 + Extended the behavior of <c-f>. | |
661 + New options: |g:ctrlp_mru_files|, | |
662 |g:ctrlp_mruf_max|, | |
663 |g:ctrlp_mruf_exclude|, | |
664 |g:ctrlp_mruf_include| | |
665 + New command: |:CtrlPMRUFiles| | |
666 | |
667 First public release: 2011/09/06~ | |
668 | |
669 =============================================================================== | |
670 vim:ft=help:et:ts=2:sw=2:sts=2:norl |