|
5294
|
1 *pi_paren.txt* For Vim version 7.4. Last change: 2013 May 08
|
|
694
|
2
|
|
|
3
|
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar
|
|
|
5
|
|
|
6
|
|
|
7 Highlighting matching parens *matchparen*
|
|
|
8
|
|
|
9 The functionality mentioned here is a |standard-plugin|.
|
|
|
10 This plugin is only available if 'compatible' is not set.
|
|
|
11
|
|
|
12 You can avoid loading this plugin by setting the "loaded_matchparen" variable: >
|
|
|
13 :let loaded_matchparen = 1
|
|
|
14
|
|
1368
|
15 The plugin installs CursorMoved, CursorMovedI and WinEnter autocommands to
|
|
|
16 redefine the match highlighting.
|
|
694
|
17
|
|
1621
|
18 *:NoMatchParen* *:DoMatchParen*
|
|
694
|
19 To disable the plugin after it was loaded use this command: >
|
|
|
20
|
|
|
21 :NoMatchParen
|
|
|
22
|
|
|
23 And to enable it again: >
|
|
|
24
|
|
|
25 :DoMatchParen
|
|
|
26
|
|
699
|
27 The highlighting used is MatchParen. You can specify different colors with
|
|
694
|
28 the ":highlight" command. Example: >
|
|
|
29
|
|
699
|
30 :hi MatchParen ctermbg=blue guibg=lightblue
|
|
694
|
31
|
|
|
32 The characters to be matched come from the 'matchpairs' option. You can
|
|
|
33 change the value to highlight different matches. Note that not everything is
|
|
|
34 possible. For example, you can't highlight single or double quotes, because
|
|
|
35 the start and end are equal.
|
|
|
36
|
|
|
37 The syntax highlighting attributes are used. When the cursor currently is not
|
|
|
38 in a string or comment syntax item, then matches inside string and comment
|
|
|
39 syntax items are ignored. Any syntax items with "string" or "comment"
|
|
|
40 somewhere in their name are considered string or comment items.
|
|
|
41
|
|
819
|
42 The search is limited to avoid a delay when moving the cursor. The limits
|
|
|
43 are:
|
|
|
44 - What is visible in the window.
|
|
|
45 - 100 lines above or below the cursor to avoid a long delay when there are
|
|
|
46 closed folds.
|
|
1121
|
47 - 'synmaxcol' times 2 bytes before or after the cursor to avoid a delay
|
|
819
|
48 in a long line with syntax highlighting.
|
|
4437
|
49 - A timeout of 300 msec (60 msec in Insert mode). This can be changed with the
|
|
|
50 g:matchparen_timeout and g:matchparen_insert_timeout variables and their
|
|
|
51 buffer-local equivalents b:matchparen_timeout and
|
|
|
52 b:matchparen_insert_timeout.
|
|
1621
|
53
|
|
|
54 If you would like the |%| command to work better, the matchit plugin can be
|
|
|
55 used, see |matchit-install|. This plugin also helps to skip matches in
|
|
|
56 comments. This is unrelated to the matchparen highlighting, they use a
|
|
|
57 different mechanism.
|
|
|
58
|
|
694
|
59 ==============================================================================
|
|
|
60 vim:tw=78:ts=8:ft=help:norl:
|
