runtime/doc/pi_paren.txt

   1 *pi_paren.txt*  For Vim version 7.1.  Last change: 2006 Jun 14
   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
  15 The plugin installs CursorMoved, CursorMovedI and WinEnter autocommands to
  16 redefine the match highlighting.
  17
  18 To disable the plugin after it was loaded use this command: >
  19
  20         :NoMatchParen
  21
  22 And to enable it again: >
  23
  24         :DoMatchParen
  25
  26 The highlighting used is MatchParen.  You can specify different colors with
  27 the ":highlight" command.  Example: >
  28
  29         :hi MatchParen ctermbg=blue guibg=lightblue
  30
  31 The characters to be matched come from the 'matchpairs' option.  You can
  32 change the value to highlight different matches.  Note that not everything is
  33 possible.  For example, you can't highlight single or double quotes, because
  34 the start and end are equal.
  35
  36 The syntax highlighting attributes are used.  When the cursor currently is not
  37 in a string or comment syntax item, then matches inside string and comment
  38 syntax items are ignored.  Any syntax items with "string" or "comment"
  39 somewhere in their name are considered string or comment items.
  40
  41 The search is limited to avoid a delay when moving the cursor.  The limits
  42 are:
  43 - What is visible in the window.
  44 - 100 lines above or below the cursor to avoid a long delay when there are
  45   closed folds.
  46 - 'synmaxcol' times 2 bytes before or after the cursor to avoid a delay
  47   in a long line with syntax highlighting.
  48
  49 ==============================================================================
  50  vim:tw=78:ts=8:ft=help:norl: