1- *options.txt* For Vim version 7.3. Last change: 2011 Sep 30
1+ *options.txt* For Vim version 7.3. Last change: 2011 Dec 14
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -401,6 +401,9 @@ On Unix systems the form "${HOME}" can be used too. The name between {} can
401401contain non-id characters then. Note that if you want to use this for the
402402"gf" command, you need to add the '{' and '}' characters to 'isfname' .
403403
404+ On MS-Windows, if $HOME is not defined as an environment variable, then
405+ at runtime Vim will set it to the expansion of $HOMEDRIVE$HOMEPATH.
406+
404407NOTE: expanding environment variables and "~/" is only done with the ":set"
405408command, not when assigning a value to an option with ":let".
406409
@@ -1217,7 +1220,8 @@ A jump table for the options with a short description can be found at |Q_op|.
12171220 | :bwipeout |
12181221
12191222 CAREFUL: when "unload", "delete" or "wipe" is used changes in a buffer
1220- are lost without a warning.
1223+ are lost without a warning. Also, these values may break autocommands
1224+ that switch between buffers temporarily.
12211225 This option is used together with 'buftype' and 'swapfile' to specify
12221226 special kinds of buffers. See | special-buffers | .
12231227
@@ -3554,8 +3558,8 @@ A jump table for the options with a short description can be found at |Q_op|.
35543558 screen.
35553559
35563560 *'guioptions'* *'go'*
3557- 'guioptions' 'go' string (default "gmrLtT " (MS-Windows),
3558- "agimrLtT " (GTK, Motif and Athena))
3561+ 'guioptions' 'go' string (default "egmrLtT " (MS-Windows),
3562+ "aegimrLtT " (GTK, Motif and Athena))
35593563 global
35603564 {not in Vi}
35613565 {only available when compiled with GUI enabled}
@@ -3858,14 +3862,16 @@ A jump table for the options with a short description can be found at |Q_op|.
38583862 are not applied.
38593863 See also: 'incsearch' and | :match | .
38603864 When you get bored looking at the highlighted matches, you can turn it
3861- off with | :nohlsearch | . As soon as you use a search command, the
3862- highlighting comes back.
3865+ off with | :nohlsearch | . This does not change the option value, as
3866+ soon as you use a search command, the highlighting comes back.
38633867 'redrawtime' specifies the maximum time spent on finding matches.
38643868 When the search pattern can match an end-of-line, Vim will try to
38653869 highlight all of the matched text. However, this depends on where the
38663870 search starts. This will be the first line in the window or the first
38673871 line below a closed fold. A match in a previous line which is not
38683872 drawn may not continue in a newly drawn line.
3873+ You can specify whether the highlight status is restored on startup
3874+ with the 'h' flag in 'viminfo' | viminfo-h | .
38693875 NOTE: This option is reset when 'compatible' is set.
38703876
38713877 *'history'* *'hi'*
@@ -5241,7 +5247,7 @@ A jump table for the options with a short description can be found at |Q_op|.
52415247 recognized as a compressed file.
52425248 Only normal file name characters can be used, "/\*?[|<>" are illegal.
52435249
5244- *'path'* *'pa'* *E343* *E345* *E347*
5250+ *'path'* *'pa'* *E343* *E345* *E347* *E854 *
52455251'path' 'pa' string (default on Unix: ".,/usr/include,,"
52465252 on OS/2: ".,/emx/include,,"
52475253 other systems: ".,,")
@@ -7368,6 +7374,8 @@ A jump table for the options with a short description can be found at |Q_op|.
73687374 jsbterm JSB term mouse handling.
73697375 *pterm-mouse*
73707376 pterm QNX pterm mouse handling.
7377+ *urxvt-mouse*
7378+ urxvt Mouse handling for the urxvt (rxvt-unicode) terminal.
73717379
73727380 The mouse handling must be enabled at compile time | +mouse_xterm |
73737381 | +mouse_dec | | +mouse_netterm | .
@@ -7584,15 +7592,18 @@ A jump table for the options with a short description can be found at |Q_op|.
75847592 parameter. The following is a list of the identifying characters and
75857593 the effect of their value.
75867594 CHAR VALUE ~
7595+ *viminfo-!*
75877596 ! When included, save and restore global variables that start
75887597 with an uppercase letter, and don't contain a lowercase
75897598 letter. Thus "KEEPTHIS and "K_L_M" are stored, but "KeepThis"
75907599 and "_K_L_M" are not. Nested List and Dict items may not be
75917600 read back correctly, you end up with an empty item.
7601+ *viminfo-quote*
75927602 " Maximum number of lines saved for each register. Old name of
75937603 the '<' item, with the disadvantage that you need to put a
75947604 backslash before the ", otherwise it will be recognized as the
75957605 start of a comment!
7606+ *viminfo-%*
75967607 % When included, save and restore the buffer list. If Vim is
75977608 started with a file name argument, the buffer list is not
75987609 restored. If Vim is started without a file name argument, the
@@ -7602,38 +7613,48 @@ A jump table for the options with a short description can be found at |Q_op|.
76027613 When followed by a number, the number specifies the maximum
76037614 number of buffers that are stored. Without a number all
76047615 buffers are stored.
7616+ *viminfo-'*
76057617 ' Maximum number of previously edited files for which the marks
76067618 are remembered. This parameter must always be included when
76077619 'viminfo' is non-empty.
76087620 Including this item also means that the | jumplist | and the
76097621 | changelist | are stored in the viminfo file.
7622+ *viminfo-/*
76107623 / Maximum number of items in the search pattern history to be
76117624 saved. If non-zero, then the previous search and substitute
76127625 patterns are also saved. When not included, the value of
76137626 'history' is used.
7627+ *viminfo-:*
76147628 : Maximum number of items in the command-line history to be
76157629 saved. When not included, the value of 'history' is used.
7630+ *viminfo-<*
76167631 < Maximum number of lines saved for each register. If zero then
76177632 registers are not saved. When not included, all lines are
76187633 saved. '"' is the old name for this item.
76197634 Also see the 's' item below: limit specified in Kbyte.
7635+ *viminfo-@*
76207636 @ Maximum number of items in the input-line history to be
76217637 saved. When not included, the value of 'history' is used.
7638+ *viminfo-c*
76227639 c When included, convert the text in the viminfo file from the
76237640 'encoding' used when writing the file to the current
76247641 'encoding' . See | viminfo-encoding | .
7642+ *viminfo-f*
76257643 f Whether file marks need to be stored. If zero, file marks ('0
76267644 to '9, 'A to 'Z) are not stored. When not present or when
76277645 non-zero, they are all stored. '0 is used for the current
76287646 cursor position (when exiting or when doing ":wviminfo").
7647+ *viminfo-h*
76297648 h Disable the effect of 'hlsearch' when loading the viminfo
76307649 file. When not included, it depends on whether ":nohlsearch"
76317650 has been used since the last search command.
7651+ *viminfo-n*
76327652 n Name of the viminfo file. The name must immediately follow
76337653 the 'n'. Must be the last one! If the "-i" argument was
76347654 given when starting Vim, that file name overrides the one
76357655 given here with 'viminfo' . Environment variables are expanded
76367656 when opening the file, not when setting the option.
7657+ *viminfo-r*
76377658 r Removable media. The argument is a string (up to the next
76387659 ','). This parameter can be given several times. Each
76397660 specifies the start of a path for which no marks will be
@@ -7642,6 +7663,7 @@ A jump table for the options with a short description can be found at |Q_op|.
76427663 also use it for temp files, e.g., for Unix: "r/tmp". Case is
76437664 ignored. Maximum length of each 'r' argument is 50
76447665 characters.
7666+ *viminfo-s*
76457667 s Maximum size of an item in Kbyte. If zero then registers are
76467668 not saved. Currently only applies to registers. The default
76477669 "s10" will exclude registers with more than 10 Kbyte of text.
0 commit comments