]> git.r.bdr.sh - rbdr/dotfiles/blame - vim/doc/delimitMate.txt
Add gitignore
[rbdr/dotfiles] / vim / doc / delimitMate.txt
CommitLineData
0d23b6e5
BB
1*delimitMate.txt* Trying to keep those beasts at bay! v2.6 *delimitMate*
2
3
4
5 MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
6 MMMM MMMMMMMMM MMMMMMMMMMMMMMMMMMMMMMMMMM MMMMM MMMMMMMMMMMMMMMMMMMMM ~
7 MMMM MMMMMMMMM MMMMMMMMMMMMMMMMMMMMMMMMMM MMM MMMMMMMMMMMMMMMMMMMMM
8 MMMM MMMMMMMMM MMMMMMMMMMMMMMMMMMMMM MMM M M MMMMMMMMMM MMMMMMMMM ~
9 MMMM MMM MMM MM MM M M MMM MM MM MM MM MMM MMM MMM MM
10 MM MM M MM MMMMMM MMMMMMM MMM MMMMM MM M MMM MMM M M ~
11 M M MM MM MM MM M M MM MMM MMM MMMMM MMMMM MMM MMM M
12 M M MM MMMMM MM MM M M MM MMM MMM MMMMM MMM MMM MMM MMMM ~
13 M M MM M MM MM MM M M MM MMM MMM MMMMM MM M MMM MMM M M
14 MM MMM MMM MM MM M M MM MMM MM MMMMM MMM MMM MMM MM ~
15 MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
16
17
18
19==============================================================================
20 0.- CONTENTS *delimitMate-contents*
21
22 1. Introduction____________________________|delimitMateIntro|
23 2. Customization___________________________|delimitMateOptions|
24 2.1 Options summary____________________|delimitMateOptionSummary|
25 2.2 Options details____________________|delimitMateOptionDetails|
26 3. Functionality___________________________|delimitMateFunctionality|
27 3.1 Automatic closing & exiting________|delimitMateAutoClose|
28 3.2 Expansion of space and CR__________|delimitMateExpansion|
29 3.3 Backspace__________________________|delimitMateBackspace|
30 3.4 Smart Quotes_______________________|delimitMateSmartQuotes|
31 3.5 Balancing matching pairs___________|delimitMateBalance|
32 3.6 FileType based configuration_______|delimitMateFileType|
33 3.7 Syntax awareness___________________|delimitMateSyntax|
34 4. Commands________________________________|delimitMateCommands|
35 5. Mappings________________________________|delimitMateMappings|
36 6. Functions_______________________________|delimitMateFunctions|
37 7. TODO list_______________________________|delimitMateTodo|
38 8. Maintainer______________________________|delimitMateMaintainer|
39 9. Credits_________________________________|delimitMateCredits|
40 10. History_________________________________|delimitMateHistory|
41
42==============================================================================
43 1.- INTRODUCTION *delimitMateIntro*
44
45This plug-in provides automatic closing of quotes, parenthesis, brackets,
46etc.; besides some other related features that should make your time in insert
47mode a little bit easier.
48
49Most of the features can be modified or disabled permanently, using global
50variables, or on a FileType basis, using autocommands. With a couple of
51exceptions and limitations, this features don't brake undo, redo or history.
52
53NOTE 1: If you have any trouble with this plugin, please run |:DelimitMateTest|
54in a new buffer to see what is not working.
55
56NOTE 2: |'timeout'| needs to be set when working in the terminal, otherwise you
57might find weird behaviour with mappings including <Esc> or arrow keys.
58
59NOTE 3: Abbreiations set with |:iabbrev| will not be expanded by delimiters
60used on delimitMate, you should use <C-]> (read |i_CTRL-]|) to expand them on
61the go.
62
63==============================================================================
64 2. CUSTOMIZATION *delimitMateOptions*
65
66You can create your own mappings for some features using the global functions.
67Read |DelimitMateFunctions| for more info.
68
69------------------------------------------------------------------------------
70 2.1 OPTIONS SUMMARY *delimitMateOptionSummary*
71
72The behaviour of this script can be customized setting the following options
73in your vimrc file. You can use local options to set the configuration for
74specific file types, see |delimitMateOptionDetails| for examples.
75
76|'loaded_delimitMate'| Turns off the script.
77
78|'delimitMate_autoclose'| Tells delimitMate whether to automagically
79 insert the closing delimiter.
80
81|'delimitMate_matchpairs'| Tells delimitMate which characters are
82 matching pairs.
83
84|'delimitMate_quotes'| Tells delimitMate which quotes should be
85 used.
86
87|'delimitMate_nesting_quotes'| Tells delimitMate which quotes should be
88 allowed to be nested.
89
90|'delimitMate_expand_cr'| Turns on/off the expansion of <CR>.
91
92|'delimitMate_expand_space'| Turns on/off the expansion of <Space>.
93
94|'delimitMate_smart_quotes'| Turns on/off the "smart quotes" feature.
95
96|'delimitMate_smart_matchpairs'| Turns on/off the "smart matchpairs" feature.
97
98|'delimitMate_balance_matchpairs'|Turns on/off the "balance matching pairs"
99 feature.
100
101|'delimitMate_excluded_regions'| Turns off the script for the given regions or
102 syntax group names.
103
104|'delimitMate_excluded_ft'| Turns off the script for the given file types.
105
106|'delimitMate_apostrophes'| Tells delimitMate how it should "fix"
107 balancing of single quotes when used as
108 apostrophes. NOTE: Not needed any more, kept
109 for compatibility with older versions.
110
111------------------------------------------------------------------------------
112 2.2 OPTIONS DETAILS *delimitMateOptionDetails*
113
114Add the shown lines to your vimrc file in order to set the below options.
115Buffer variables take precedence over global ones and can be used along with
116autocmd to modify delimitMate's behavior for specific file types, read more in
117|delimitMateFileType|.
118
119Note: Use buffer variables only to set options for specific file types using
120:autocmd, use global variables to set options for every buffer. Read more in
121|g:var| and |b:var|.
122
123------------------------------------------------------------------------------
124 *'loaded_delimitMate'*
125 *'b:loaded_delimitMate'*
126This option prevents delimitMate from loading.
127e.g.: >
128 let loaded_delimitMate = 1
129 au FileType mail let b:loaded_delimitMate = 1
130<
131------------------------------------------------------------------------------
132 *'delimitMate_autoclose'*
133 *'b:delimitMate_autoclose'*
134Values: 0 or 1. ~
135Default: 1 ~
136
137If this option is set to 0, delimitMate will not add a closing delimiter
138automagically. See |delimitMateAutoClose| for details.
139e.g.: >
140 let delimitMate_autoclose = 0
141 au FileType mail let b:delimitMate_autoclose = 0
142<
143------------------------------------------------------------------------------
144 *'delimitMate_matchpairs'*
145 *'b:delimitMate_matchpairs'*
146Values: A string with |'matchpairs'| syntax, plus support for multi-byte~
147 characters.~
148Default: &matchpairs ~
149
150Use this option to tell delimitMate which characters should be considered
151matching pairs. Read |delimitMateAutoClose| for details.
152e.g: >
153 let delimitMate_matchpairs = "(:),[:],{:},<:>"
154 au FileType vim,html let b:delimitMate_matchpairs = "(:),[:],{:},<:>"
155<
156------------------------------------------------------------------------------
157 *'delimitMate_quotes'*
158 *'b:delimitMate_quotes'*
159Values: A string of characters separated by spaces. ~
160Default: "\" ' `" ~
161
162Use this option to tell delimitMate which characters should be considered as
163quotes. Read |delimitMateAutoClose| for details.
164e.g.: >
165 let delimitMate_quotes = "\" ' ` *"
166 au FileType html let b:delimitMate_quotes = "\" '"
167<
168------------------------------------------------------------------------------
169 *'delimitMate_nesting_quotes'*
170 *'b:delimitMate_nesting_quotes'*
171Values: A list of quotes. ~
172Default: [] ~
173
174Quotes listed here will not be able to jump out of the empty pair, thus
175allowing the autoclosed quotes to be nested.
176e.g.: >
177 let delimitMate_nesting_quotes = ['"','`']
178 au FileType python let b:delimitMate_nesting_quotes = ['"']
179<
180------------------------------------------------------------------------------
181 *'delimitMate_expand_cr'*
182 *'b:delimitMate_expand_cr'*
183Values: 1 or 0 ~
184Default: 0 ~
185
186This option turns on/off the expansion of <CR>. Read |delimitMateExpansion|
187for details. NOTE This feature requires that 'backspace' is either set to 2 or
188has "eol" and "start" as part of its value.
189e.g.: >
190 let delimitMate_expand_cr = 1
191 au FileType mail let b:delimitMate_expand_cr = 1
192<
193------------------------------------------------------------------------------
194 *'delimitMate_expand_space'*
195 *'b:delimitMate_expand_space'*
196Values: 1 or 0 ~
197Default: 0 ~
198This option turns on/off the expansion of <Space>. Read |delimitMateExpansion|
199for details.
200e.g.: >
201 let delimitMate_expand_space = 1
202 au FileType tcl let b:delimitMate_expand_space = 1
203<
204------------------------------------------------------------------------------
205 *'delimitMate_smart_quotes'*
206 *'b:delimitMate_smart_quotes'*
207Values: 1 or 0 ~
208Default: 1 ~
209
210This option turns on/off the smart quotes feature. Read
211|delimitMateSmartQuotes| for details.
212e.g.: >
213 let delimitMate_smart_quotes = 0
214 au FileType tcl let b:delimitMate_smart_quotes = 1
215<
216------------------------------------------------------------------------------
217 *'delimitMate_smart_matchpairs'*
218 *'b:delimitMate_smart_matchpairs'*
219Values: Regexp ~
220Default: '^\%(\w\|\!\|£\|\$\|_\|["'']\s*\S\)' ~
221
222This regex is matched against the text to the right of cursor, if it's not
223empty and there is a match delimitMate will not autoclose the pair. At the
224moment to match the text, an escaped bang (\!) in the regex will be replaced
225by the character being inserted, while an escaped number symbol (\#) will be
226replaced by the closing pair.
227e.g.: >
228 let delimitMate_smart_matchpairs = ''
229 au FileType tcl let b:delimitMate_smart_matchpairs = '^\%(\w\|\$\)'
230<
231------------------------------------------------------------------------------
232 *'delimitMate_balance_matchpairs'*
233 *'b:delimitMate_balance_matchpairs'*
234Values: 1 or 0 ~
235Default: 0 ~
236
237This option turns on/off the balancing of matching pairs. Read
238|delimitMateBalance| for details.
239e.g.: >
240 let delimitMate_balance_matchpairs = 1
241 au FileType tcl let b:delimitMate_balance_matchpairs = 1
242<
243------------------------------------------------------------------------------
244 *'delimitMate_excluded_regions'*
245Values: A string of syntax group names names separated by single commas. ~
246Default: Comment ~
247
248This options turns delimitMate off for the listed regions, read |group-name|
249for more info about what is a region.
250e.g.: >
251 let delimitMate_excluded_regions = "Comments,String"
252<
253------------------------------------------------------------------------------
254 *'delimitMate_excluded_ft'*
255Values: A string of file type names separated by single commas. ~
256Default: Empty. ~
257
258This options turns delimitMate off for the listed file types, use this option
259only if you don't want any of the features it provides on those file types.
260e.g.: >
261 let delimitMate_excluded_ft = "mail,txt"
262<
263------------------------------------------------------------------------------
264 *'delimitMate_apostrophes'*
265Values: Strings separated by ":". ~
266Default: No longer used. ~
267
268NOTE: This feature is turned off by default, it's been kept for compatibility
269with older version, read |delimitMateSmartQuotes| for details.
270If auto-close is enabled, this option tells delimitMate how to try to fix the
271balancing of single quotes when used as apostrophes. The values of this option
272are strings of text where a single quote would be used as an apostrophe (e.g.:
273the "n't" of wouldn't or can't) separated by ":". Set it to an empty string to
274disable this feature.
275e.g.: >
276 let delimitMate_apostrophes = ""
277 au FileType tcl let delimitMate_apostrophes = ""
278<
279==============================================================================
280 3. FUNCTIONALITY *delimitMateFunctionality*
281
282------------------------------------------------------------------------------
283 3.1 AUTOMATIC CLOSING AND EXITING *delimitMateAutoClose*
284
285With automatic closing enabled, if an opening delimiter is inserted the plugin
286inserts the closing delimiter and places the cursor between the pair. With
287automatic closing disabled, no closing delimiters is inserted by delimitMate,
288but when a pair of delimiters is typed, the cursor is placed in the middle.
289
290When the cursor is inside an empty pair or located next to the left of a
291closing delimiter, the cursor is placed outside the pair to the right of the
292closing delimiter.
293
294When |'delimitMate_smart_matchpairs'| is not empty and it matches the text to
295the right of the cursor, delimitMate will not automatically insert the closing
296pair.
297
298Unless |'delimitMate_matchpairs'| or |'delimitMate_quotes'| are set, this
299script uses the values in '&matchpairs' to identify the pairs, and ", ' and `
300for quotes respectively.
301
302<S-Tab> will jump over a single closing delimiter or quote, <C-G>g will jump
303over contiguous delimiters and/or quotes.
304
305The following table shows the behaviour, this applies to quotes too (the final
306position of the cursor is represented by a "|"):
307
308With auto-close: >
309 Type | You get
310 =======================
311 ( | (|)
312 –––––––––––|–––––––––––
313 () | ()|
314 –––––––––––|–––––––––––
315 (<S-Tab> | ()|
316 –––––––––––|–––––––––––
317 {("<C-G>g | {("")}|
318<
319Without auto-close: >
320
321 Type | You get
322 =========================
323 () | (|)
324 –––––––––-----|––––––––––
325 ()) | ()|
326 –––––––––-----|––––––––––
327 ()<S-Tab> | ()|
328 ––––––––––––––|–––––––––––
329 {}()""<C-G>g | {("")}|
330<
331NOTE: Abbreviations will not be expanded by delimiters used on delimitMate,
332you should use <C-]> (read |i_CTRL-]|) to expand them on the go.
333
334------------------------------------------------------------------------------
335 3.2 EXPANSION OF SPACE AND CAR RETURN *delimitMateExpansion*
336
337When the cursor is inside an empty pair of delimiters, <Space> and <CR> can be
338expanded, see |'delimitMate_expand_space'| and
339|'delimitMate_expand_cr'|:
340
341Expand <Space> to: >
342
343 <Space><Space><Left> | You get
344 ====================================
345 (|) | ( | )
346<
347Expand <CR> to: >
348
349 <CR><CR><Up> | You get
350 ============================
351 (|) | (
352 | |
353 | )
354<
355
356NOTE that the expansion of <CR> will brake the redo command.
357
358Since <Space> and <CR> are used everywhere, I have made the functions involved
359in expansions global, so they can be used to make custom mappings. Read
360|delimitMateFunctions| for more details.
361
362------------------------------------------------------------------------------
363 3.3 BACKSPACE *delimitMateBackspace*
364
365If you press backspace inside an empty pair, both delimiters are deleted. When
366expansions are enabled, <BS> will also delete the expansions. NOTE that
367deleting <CR> expansions will brake the redo command.
368
369If you type <S-BS> (shift + backspace) instead, only the closing delimiter
370will be deleted. NOTE that this will not usually work when using Vim from the
371terminal, see 'delimitMate#JumpAny()' below to see how to fix it.
372
373e.g. typing at the "|": >
374
375 What | Before | After
376 ==============================================
377 <BS> | call expand(|) | call expand|
378 ---------|-------------------|-----------------
379 <BS> | call expand( | ) | call expand(|)
380 ---------|-------------------|-----------------
381 <BS> | call expand( | call expand(|)
382 | | |
383 | ) |
384 ---------|-------------------|-----------------
385 <S-BS> | call expand(|) | call expand(|
386<
387
388------------------------------------------------------------------------------
389 3.4 SMART QUOTES *delimitMateSmartQuotes*
390
391Only one quote will be inserted following a quote, a "\" or, following or
392preceding a keyword character. This should cover closing quotes after a
393string, opening quotes before a string, escaped quotes and apostrophes. Except
394for apostrophes, this feature can be disabled setting the option
395|'delimitMate_smart_quotes'| to 0.
396
397e.g. typing at the "|": >
398
399 What | Before | After
400 =======================================
401 " | Text | | Text "|"
402 " | "String| | "String"|
403 " | let i = "| | let i = "|"
404 'm | I| | I'm|
405<
406------------------------------------------------------------------------------
407 3.4 SMART MATCHPAIRS *delimitMateSmartMatchpairs*
408
409This is similar to "smart quotes", but applied to the characters in
410|'delimitMate_matchpairs'|. The difference is that delimitMate will not
411auto-close the pair when the regex matches the text on the right of the
412cursor. See |'delimitMate_smart_matchpairs'| for more details.
413
414
415e.g. typing at the "|": >
416
417 What | Before | After
418 =======================================
419 ( | function| | function(|)
420 ( | |var | (|var
421<
422------------------------------------------------------------------------------
423 3.5 BALANCING MATCHING PAIRS *delimitMateBalance*
424
425When inserting an opening paren and |'delimitMate_balance_matchpairs'| is
426enabled, delimitMate will try to balance the closing pairs in the current
427line.
428
429e.g. typing at the "|": >
430
431 What | Before | After
432 =======================================
433 ( | | | (|)
434 ( | |) | (|)
435 (( | |) | ((|))
436<
437------------------------------------------------------------------------------
438 3.6 FILE TYPE BASED CONFIGURATION *delimitMateFileType*
439
440delimitMate options can be set globally for all buffers using global
441("regular") variables in your |vimrc| file. But |:autocmd| can be used to set
442options for specific file types (see |'filetype'|) using buffer variables in
443the following way: >
444
445 au FileType mail,text let b:delimitMate_autoclose = 0
446 ^ ^ ^ ^ ^
447 | | | | |
448 | | | | - Option value.
449 | | | - Option name.
450 | | - Buffer variable.
451 | - File types for which the option will be set.
452 - Don't forget to put this event.
453<
454NOTE that you should use buffer variables (|b:var|) only to set options with
455|:autocmd|, for global options use regular variables (|g:var|) in your vimrc.
456
457------------------------------------------------------------------------------
458 3.7 SYNTAX AWARENESS *delimitMateSyntax*
459
460The features of this plug-in might not be always helpful, comments and strings
461usualy don't need auto-completion. delimitMate monitors which region is being
462edited and if it detects that the cursor is in a comment it'll turn itself off
463until the cursor leaves the comment. The excluded regions can be set using the
464option |'delimitMate_excluded_regions'|. Read |group-name| for a list of
465regions or syntax group names.
466
467NOTE that this feature relies on a proper syntax file for the current file
468type, if the appropiate syntax file doesn't define a region, delimitMate won't
469know about it.
470
471==============================================================================
472 4. COMMANDS *delimitMateCommands*
473
474------------------------------------------------------------------------------
475:DelimitMateReload *:DelimitMateReload*
476
477Re-sets all the mappings used for this script, use it if any option has been
478changed or if the filetype option hasn't been set yet.
479
480------------------------------------------------------------------------------
481:DelimitMateSwitch *:DelimitMateSwitch*
482
483Switches the plug-in on and off.
484
485------------------------------------------------------------------------------
486:DelimitMateTest *:DelimitMateTest*
487
488This command tests every mapping set-up for this script, useful for testing
489custom configurations.
490
491The following output corresponds to the default values, it will be different
492depending on your configuration. "Open & close:" represents the final result
493when the closing delimiter has been inserted, either manually or
494automatically, see |delimitMateExpansion|. "Delete:" typing backspace in an
495empty pair, see |delimitMateBackspace|. "Exit:" typing a closing delimiter
496inside a pair of delimiters, see |delimitMateAutoclose|. "Space:" the
497expansion, if any, of space, see |delimitMateExpansion|. "Visual-L",
498"Visual-R" and "Visual" shows visual wrapping, see
499|delimitMateVisualWrapping|. "Car return:" the expansion of car return, see
500|delimitMateExpansion|. The cursor's position at the end of every test is
501represented by an "|": >
502
503 * AUTOCLOSE:
504 Open & close: (|)
505 Delete: |
506 Exit: ()|
507 Space: ( |)
508 Visual-L: (v)
509 Visual-R: (v)
510 Car return: (
511 |)
512
513 Open & close: {|}
514 Delete: |
515 Exit: {}|
516 Space: { |}
517 Visual-L: {v}
518 Visual-R: {v}
519 Car return: {
520 |}
521
522 Open & close: [|]
523 Delete: |
524 Exit: []|
525 Space: [ |]
526 Visual-L: [v]
527 Visual-R: [v]
528 Car return: [
529 |]
530
531 Open & close: "|"
532 Delete: |
533 Exit: ""|
534 Space: " |"
535 Visual: "v"
536 Car return: "
537 |"
538
539 Open & close: '|'
540 Delete: |
541 Exit: ''|
542 Space: ' |'
543 Visual: 'v'
544 Car return: '
545 |'
546
547 Open & close: `|`
548 Delete: |
549 Exit: ``|
550 Space: ` |`
551 Visual: `v`
552 Car return: `
553 |`
554<
555
556==============================================================================
557 5. MAPPINGS *delimitMateMappings*
558
559delimitMate doesn't override any existing map, so you may encounter that it
560doesn't work as expected because a mapping is missing. In that case, the
561conflicting mappings should be resolved by either disabling the conflicting
562mapping or creating a custom mappings.
563
564In order to make custom mappings easier and prevent overwritting existing
565ones, delimitMate uses the |<Plug>| + |hasmapto()| (|usr_41.txt|) construct
566for its mappings.
567
568These are the default mappings:
569
570<BS> is mapped to <Plug>delimitMateBS
571<S-BS> is mapped to <Plug>delimitMateS-BS
572<S-Tab> is mapped to <Plug>delimitMateS-Tab
573<C-G>g is mapped to <Plug>delimitMateJumpMany
574<Del> is mapped to <Plug>delimitMateDel
575<Esc> is mapped to <Plug>delimitMateEsc
576<Left> is mapped to <Plug>delimitMateLeft
577<Right> is mapped to <Plug>delimitMateRight
578<Home> is mapped to <Plug>delimitMateHome
579<End> is mapped to <Plug>delimitMateEnd
580<Up> is mapped to <Plug>delimitMateUp
581<Down> is mapped to <Plug>delimitMateDown
582<PageUp> is mapped to <Plug>delimitMatePageUp
583<PageDown> is mapped to <Plug>delimitMatePageDown
584<S-Down> is mapped to <Plug>delimitMateS-Down
585<S-Up> is mapped to <Plug>delimitMateS-Up
586<LeftMouse> is mapped to <Plug>delimitMateMLeftMouse
587<RightMouse> is mapped to <Plug>delimitMateMRightMouse
588
589The rest of the mappings correspond to parens, quotes, CR, Space, etc. and they
590depend on the values of the delimitMate options, they have the following form:
591
592<Plug>delimitMate + char
593
594e.g.: for "(":
595
596( is mapped to <Plug>delimitMate(
597
598e.g.: If you have <CR> expansion enabled, you might want to skip it on pop-up
599menus:
600
601 imap <expr> <CR> pumvisible() ?
602 \"\<c-y>" :
603 \ "<Plug>delimitMateCR"
604
605
606==============================================================================
607 6. FUNCTIONS *delimitMateFunctions*
608
609------------------------------------------------------------------------------
610delimitMate#WithinEmptyPair() *delimitMate#WithinEmptyPair()*
611
612Returns 1 if the cursor is inside an empty pair, 0 otherwise.
613e.g.: >
614
615 inoremap <expr> <CR> delimitMate#WithinEmptyPair() ?
616 \ "\<C-R>=delimitMate#ExpandReturn()\<CR>" :
617 \ "external_mapping"
618<
619
620------------------------------------------------------------------------------
621delimitMate#ShouldJump() *delimitMate#ShouldJump()*
622
623Returns 1 if there is a closing delimiter or a quote to the right of the
624cursor, 0 otherwise.
625
626------------------------------------------------------------------------------
627delimitMate#JumpAny(key) *delimitMate#JumpAny()*
628
629This function returns a mapping that will make the cursor jump to the right
630when delimitMate#ShouldJump() returns 1, returns the argument "key" otherwise.
631e.g.: You can use this to create your own mapping to jump over any delimiter.
632>
633 inoremap <C-Tab> <C-R>=delimitMate#JumpAny("\<C-Tab>")<CR>
634<
635
636==============================================================================
637 7. TODO LIST *delimitMateTodo*
638
639- Automatic set-up by file type.
640- Make block-wise visual wrapping work on un-even regions.
641
642==============================================================================
643 8. MAINTAINER *delimitMateMaintainer*
644
645Hi there! My name is Israel Chauca F. and I can be reached at:
646 mailto:israelchauca@gmail.com
647
648Feel free to send me any suggestions and/or comments about this plugin, I'll
649be very pleased to read them.
650
651==============================================================================
652 9. CREDITS *delimitMateCredits*
653
654Contributors: ~
655
656 - Kim Silkebækken ~
657 Fixed mappings being echoed in the terminal.
658
659 - Eric Van Dewoestine ~
660 Implemented smart matchpairs.
661
662Some of the code that makes this script was modified or just shamelessly
663copied from the following sources:
664
665 - Ian McCracken ~
666 Post titled: Vim, Part II: Matching Pairs:
667 http://concisionandconcinnity.blogspot.com/
668
669 - Aristotle Pagaltzis ~
670 From the comments on the previous blog post and from:
671 http://gist.github.com/144619
672
673 - Karl Guertin ~
674 AutoClose:
675 http://www.vim.org/scripts/script.php?script_id=1849
676
677 - Thiago Alves ~
678 AutoClose:
679 http://www.vim.org/scripts/script.php?script_id=2009
680
681 - Edoardo Vacchi ~
682 ClosePairs:
683 http://www.vim.org/scripts/script.php?script_id=2373
684
685This script was inspired by the auto-completion of delimiters on TextMate.
686
687==============================================================================
688 10. HISTORY *delimitMateHistory*
689
690 Version Date Release notes ~
691|---------|------------|-----------------------------------------------------|
692 2.6 2011-01-14 * Current release:
693 - Add smart_matchpairs feature.
694 - Add mapping to jump over contiguous delimiters.
695 - Fix behaviour of b:loaded_delimitMate.
696|---------|------------|-----------------------------------------------------|
697 2.5.1 2010-09-30 * - Remove visual wrapping. Surround.vim offers a much
698 better implementation.
699 - Minor mods to DelimitMateTest.
700|---------|------------|-----------------------------------------------------|
701 2.5 2010-09-22 * - Better handling of mappings.
702 - Add report for mappings in |:DelimitMateTest|.
703 - Allow the use of "|" and multi-byte characters in
704 |'delimitMate_quotes'| and |'delimitMate_matchpairs'|.
705 - Allow commands to be concatenated using |.
706|---------|------------|-----------------------------------------------------|
707 2.4.1 2010-07-31 * - Fix problem with <Home> and <End>.
708 - Add missing doc on |'delimitMate_smart_quotes'|,
709 |delimitMateBalance| and
710 |'delimitMate_balance_matchpairs'|.
711|---------|------------|-----------------------------------------------------|
712 2.4 2010-07-29 * - Unbalanced parens: see :help delimitMateBalance.
713 - Visual wrapping now works on block-wise visual
714 with some limitations.
715 - Arrow keys didn't work on terminal.
716 - Added option to allow nested quotes.
717 - Expand Smart Quotes to look for a string on the
718 right of the cursor.
719
720|---------|------------|-----------------------------------------------------|
721 2.3.1 2010-06-06 * - Fix: an extra <Space> is inserted after <Space>
722 expansion.
723
724|---------|------------|-----------------------------------------------------|
725 2.3 2010-06-06 * - Syntax aware: Will turn off when editing comments
726 or other regions, customizable.
727 - Changed format of most mappings.
728 - Fix: <CR> expansion doesn't brake automatic
729 indentation adjustments anymore.
730 - Fix: Arrow keys would insert A, B, C or D instead
731 of moving the cursor when using Vim on a terminal.
732
733|---------|------------|-----------------------------------------------------|
734 2.2 2010-05-16 * - Added command to switch the plug-in on and off.
735 - Fix: some problems with <Left>, <Right> and <CR>.
736 - Fix: A small problem when inserting a delimiter at
737 the beginning of the line.
738
739|---------|------------|-----------------------------------------------------|
740 2.1 2010-05-10 * - Most of the functions have been moved to an
741 autoload script to avoid loading unnecessary ones.
742 - Fixed a problem with the redo command.
743 - Many small fixes.
744
745|---------|------------|-----------------------------------------------------|
746 2.0 2010-04-01 * New features:
747 - All features are redo/undo-wise safe.
748 - A single quote typed after an alphanumeric
749 character is considered an apostrophe and one
750 single quote is inserted.
751 - A quote typed after another quote inserts a single
752 quote and the cursor jumps to the middle.
753 - <S-Tab> jumps out of any empty pair.
754 - <CR> and <Space> expansions are fixed, but the
755 functions used for it are global and can be used in
756 custom mappings. The previous system is still
757 active if you have any of the expansion options
758 set.
759 - <S-Backspace> deletes the closing delimiter.
760 * Fixed bug:
761 - s:vars were being used to store buffer options.
762
763|---------|------------|-----------------------------------------------------|
764 1.6 2009-10-10 * Now delimitMate tries to fix the balancing of single
765 quotes when used as apostrophes. You can read
766 |delimitMate_apostrophes| for details.
767 Fixed an error when |b:delimitMate_expand_space|
768 wasn't set but |delimitMate_expand_space| wasn't.
769
770|---------|------------|-----------------------------------------------------|
771 1.5 2009-10-05 * Fix: delimitMate should work correctly for files
772 passed as arguments to Vim. Thanks to Ben Beuchler
773 for helping to nail this bug.
774
775|---------|------------|-----------------------------------------------------|
776 1.4 2009-09-27 * Fix: delimitMate is now enabled on new buffers even
777 if they don't have set the file type option or were
778 opened directly from the terminal.
779
780|---------|------------|-----------------------------------------------------|
781 1.3 2009-09-24 * Now local options can be used along with autocmd
782 for specific file type configurations.
783 Fixes:
784 - Unnamed register content is not lost on visual
785 mode.
786 - Use noremap where appropiate.
787 - Wrapping a single empty line works as expected.
788
789|---------|------------|-----------------------------------------------------|
790 1.2 2009-09-07 * Fixes:
791 - When inside nested empty pairs, deleting the
792 innermost left delimiter would delete all right
793 contiguous delimiters.
794 - When inside an empty pair, inserting a left
795 delimiter wouldn't insert the right one, instead
796 the cursor would jump to the right.
797 - New buffer inside the current window wouldn't
798 have the mappings set.
799
800|---------|------------|-----------------------------------------------------|
801 1.1 2009-08-25 * Fixed an error that ocurred when mapleader wasn't
802 set and added support for GetLatestScripts
803 auto-detection.
804
805|---------|------------|-----------------------------------------------------|
806 1.0 2009-08-23 * Initial upload.
807
808|---------|------------|-----------------------------------------------------|
809
810
811 `\|||/´ MMM \|/ www __^__ ~
812 (o o) (o o) @ @ (O-O) /(o o)\\ ~
813ooO_(_)_Ooo__ ooO_(_)_Ooo___oOO_(_)_OOo___oOO__(_)__OOo___oOO__(_)__OOo_____ ~
814_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|____ ~
815__|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_ ~
816_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|____ ~
817
818vim:tw=78:et:ts=2:sw=2:ft=help:norl:formatoptions+=tcroqn:autoindent: