Mercurial > vim
annotate runtime/doc/pi_paren.txt @ 2577:073ff46fe397
Fold Vim 7.2 default branch back to trunk to avoid two heads. (Tony
Mechelynck)
| author | Bram Moolenaar <bram@vim.org> |
|---|---|
| date | Fri, 20 Aug 2010 11:11:57 +0200 |
| parents | ee53a39d5896 733f0dc510c3 |
| children | eb6ab7e78925 |
| rev | line source |
|---|---|
|
2572
ee53a39d5896
Last changes for the 7.3 release!
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
1 *pi_paren.txt* For Vim version 7.3. Last change: 2008 Jun 16 |
| 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. |
| 818 | 49 |
| 1621 | 50 |
| 51 If you would like the |%| command to work better, the matchit plugin can be | |
| 52 used, see |matchit-install|. This plugin also helps to skip matches in | |
| 53 comments. This is unrelated to the matchparen highlighting, they use a | |
| 54 different mechanism. | |
| 55 | |
| 694 | 56 ============================================================================== |
| 57 vim:tw=78:ts=8:ft=help:norl: |