Mercurial > vim
annotate runtime/doc/pi_paren.txt @ 13922:1a30d378b70b
Added tag v8.0.1831 for changeset 3b6c29f8c1a249a7b1501f47be88e7774d1b1b2b
| author | Christian Brabandt <cb@256bit.org> |
|---|---|
| date | Sun, 13 May 2018 15:30:08 +0200 |
| parents | 9f48eab77d62 |
| children | 1174611ad715 |
| rev | line source |
|---|---|
|
10198
9f48eab77d62
commit https://github.com/vim/vim/commit/bb76f24af2010943387ce696a7092175b4ecccf2
Christian Brabandt <cb@256bit.org>
parents:
5294
diff
changeset
|
1 *pi_paren.txt* For Vim version 8.0. 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: |