comparison runtime/doc/options.txt @ 856:8cd729851562 v7.0g

updated for version 7.0g
author vimboss
date Sun, 30 Apr 2006 18:54:39 +0000
parents d10fbefd3bc1
children b933657f7c9d
comparison
equal deleted inserted replaced
855:d2a4f08396fe 856:8cd729851562
1 *options.txt* For Vim version 7.0f. Last change: 2006 Apr 29 1 *options.txt* For Vim version 7.0g. Last change: 2006 Apr 30
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
1190 <empty> normal buffer 1190 <empty> normal buffer
1191 nofile buffer which is not related to a file and will not be 1191 nofile buffer which is not related to a file and will not be
1192 written 1192 written
1193 nowrite buffer which will not be written 1193 nowrite buffer which will not be written
1194 acwrite buffer which will always be written with BufWriteCmd 1194 acwrite buffer which will always be written with BufWriteCmd
1195 autocommands. {not available when compiled without the 1195 autocommands. {not available when compiled without the
1196 |+autocmd| feature} 1196 |+autocmd| feature}
1197 quickfix quickfix buffer, contains list of errors |:cwindow| 1197 quickfix quickfix buffer, contains list of errors |:cwindow|
1198 or list of locations |:lwindow| 1198 or list of locations |:lwindow|
1199 help help buffer (you are not supposed to set this 1199 help help buffer (you are not supposed to set this
1200 manually) 1200 manually)
1646 menu Use a popup menu to show the possible completions. The 1646 menu Use a popup menu to show the possible completions. The
1647 menu is only shown when there is more than one match and 1647 menu is only shown when there is more than one match and
1648 sufficient colors are available. |ins-completion-menu| 1648 sufficient colors are available. |ins-completion-menu|
1649 1649
1650 menuone Use the popup menu also when there is only one match. 1650 menuone Use the popup menu also when there is only one match.
1651 Useful when there is additional information about the 1651 Useful when there is additional information about the
1652 match, e.g., what file it comes from. 1652 match, e.g., what file it comes from.
1653 1653
1654 longest Only insert the longest common text of the matches. If 1654 longest Only insert the longest common text of the matches. If
1655 the menu is displayed you can use CTRL-L to add more 1655 the menu is displayed you can use CTRL-L to add more
1656 characters. Whether case is ignored depends on the kind 1656 characters. Whether case is ignored depends on the kind
1657 of completion. For buffer text the 'ignorecase' option is 1657 of completion. For buffer text the 'ignorecase' option is
1658 used. 1658 used.
1659 1659
1660 preview Show extra information about the currently selected 1660 preview Show extra information about the currently selected
1661 completion in the preview window. 1661 completion in the preview window.
1662 1662
1663 *'confirm'* *'cf'* *'noconfirm'* *'nocf'* 1663 *'confirm'* *'cf'* *'noconfirm'* *'nocf'*
1664 'confirm' 'cf' boolean (default off) 1664 'confirm' 'cf' boolean (default off)
1665 global 1665 global
1666 {not in Vi} 1666 {not in Vi}
1952 CTRL-N, CTRL-J and ":1234". 1952 CTRL-N, CTRL-J and ":1234".
1953 *cpo-+* 1953 *cpo-+*
1954 + When included, a ":write file" command will reset the 1954 + When included, a ":write file" command will reset the
1955 'modified' flag of the buffer, even though the buffer 1955 'modified' flag of the buffer, even though the buffer
1956 itself may still be different from its file. 1956 itself may still be different from its file.
1957 *cpo-star* 1957 *cpo-star*
1958 * Use ":*" in the same way as ":@". When not included, 1958 * Use ":*" in the same way as ":@". When not included,
1959 ":*" is an alias for ":'<,'>", select the Visual area. 1959 ":*" is an alias for ":'<,'>", select the Visual area.
1960 *cpo-<* 1960 *cpo-<*
1961 < Disable the recognition of special key codes in |<>| 1961 < Disable the recognition of special key codes in |<>|
1962 form in mappings, abbreviations, and the "to" part of 1962 form in mappings, abbreviations, and the "to" part of
1971 1971
1972 POSIX flags. These are not included in the Vi default value, except 1972 POSIX flags. These are not included in the Vi default value, except
1973 when $VIM_POSIX was set on startup. |posix| 1973 when $VIM_POSIX was set on startup. |posix|
1974 1974
1975 contains behavior ~ 1975 contains behavior ~
1976 *cpo-#* 1976 *cpo-#*
1977 # A count before "D", "o" and "O" has no effect. 1977 # A count before "D", "o" and "O" has no effect.
1978 *cpo-&* 1978 *cpo-&*
1979 & When ":preserve" was used keep the swap file when 1979 & When ":preserve" was used keep the swap file when
1980 exiting normally while this buffer is still loaded. 1980 exiting normally while this buffer is still loaded.
1981 This flag is tested when exiting. 1981 This flag is tested when exiting.
2988 feature} 2988 feature}
2989 Expression which is evaluated to format a range of lines for the |gq| 2989 Expression which is evaluated to format a range of lines for the |gq|
2990 operator. When this option is empty 'formatprg' is used. 2990 operator. When this option is empty 'formatprg' is used.
2991 2991
2992 The |v:lnum| variable holds the first line to be formatted. 2992 The |v:lnum| variable holds the first line to be formatted.
2993 The |v:count| variable the number of lines to be formatted. 2993 The |v:count| variable holds the number of lines to be formatted.
2994 The |v:char| variable the character to be inserted. This can be 2994 The |v:char| variable holds the character that is going to be
2995 empty. Don't insert it yet! 2995 inserted. This can be empty. Don't insert it yet!
2996 2996
2997 Example: > 2997 Example: >
2998 :set formatexpr=mylang#Format() 2998 :set formatexpr=mylang#Format()
2999 < This will invoke the mylang#Format() function in the 2999 < This will invoke the mylang#Format() function in the
3000 autoload/mylang.vim file in 'runtimepath'. |autoload| 3000 autoload/mylang.vim file in 'runtimepath'. |autoload|
3368 Exception: Athena will always use grey menu items. 3368 Exception: Athena will always use grey menu items.
3369 3369
3370 't' Include tearoff menu items. Currently only works for Win32, 3370 't' Include tearoff menu items. Currently only works for Win32,
3371 GTK+, and Motif 1.2 GUI. 3371 GTK+, and Motif 1.2 GUI.
3372 'T' Include Toolbar. Currently only in Win32, GTK+, Motif, Photon 3372 'T' Include Toolbar. Currently only in Win32, GTK+, Motif, Photon
3373 and Athena GUIs. 3373 and Athena GUIs.
3374 3374
3375 'r' Right-hand scrollbar is always present. 3375 'r' Right-hand scrollbar is always present.
3376 'R' Right-hand scrollbar is present when there is a vertically 3376 'R' Right-hand scrollbar is present when there is a vertically
3377 split window. 3377 split window.
3378 'l' Left-hand scrollbar is always present. 3378 'l' Left-hand scrollbar is always present.
4292 screen. 4292 screen.
4293 precedes:c Character to show in the first column, when 'wrap' 4293 precedes:c Character to show in the first column, when 'wrap'
4294 is off and there is text preceding the character 4294 is off and there is text preceding the character
4295 visible in the first column. 4295 visible in the first column.
4296 nbsp:c Character to show for a non-breakable space (character 4296 nbsp:c Character to show for a non-breakable space (character
4297 0xA0, 160). Left blank when omitted. 4297 0xA0, 160). Left blank when omitted.
4298 4298
4299 The characters ':' and ',' should not be used. UTF-8 characters can 4299 The characters ':' and ',' should not be used. UTF-8 characters can
4300 be used when 'encoding' is "utf-8", otherwise only printable 4300 be used when 'encoding' is "utf-8", otherwise only printable
4301 characters are allowed. All characters must be single width. 4301 characters are allowed. All characters must be single width.
4302 4302
6406 This setting is checked with |quickfix| commands, when 6406 This setting is checked with |quickfix| commands, when
6407 jumping to errors (":cc", ":cn", "cp", etc.). It is 6407 jumping to errors (":cc", ":cn", "cp", etc.). It is
6408 also used in all buffer related split commands, for 6408 also used in all buffer related split commands, for
6409 example ":sbuffer", ":sbnext", or ":sbrewind". 6409 example ":sbuffer", ":sbnext", or ":sbrewind".
6410 usetab Like "useopen", but also consider windows in other tab 6410 usetab Like "useopen", but also consider windows in other tab
6411 pages. 6411 pages.
6412 split If included, split the current window before loading 6412 split If included, split the current window before loading
6413 a buffer. Otherwise: do not split, use current window. 6413 a buffer. Otherwise: do not split, use current window.
6414 Supported in |quickfix| commands that display errors. 6414 Supported in |quickfix| commands that display errors.
6415 6415
6416 *'synmaxcol'* *'smc'* 6416 *'synmaxcol'* *'smc'*
6986 xterm xterm-like mouse handling. The mouse generates 6986 xterm xterm-like mouse handling. The mouse generates
6987 "<Esc>[Mscr", where "scr" is three bytes: 6987 "<Esc>[Mscr", where "scr" is three bytes:
6988 "s" = button state 6988 "s" = button state
6989 "c" = column plus 33 6989 "c" = column plus 33
6990 "r" = row plus 33 6990 "r" = row plus 33
6991 This only works up to 223 columns! See "dec" for a 6991 This only works up to 223 columns! See "dec" for a
6992 solution. 6992 solution.
6993 xterm2 Works like "xterm", but with the xterm reporting the 6993 xterm2 Works like "xterm", but with the xterm reporting the
6994 mouse position while the mouse is dragged. This works 6994 mouse position while the mouse is dragged. This works
6995 much faster and more precise. Your xterm must at 6995 much faster and more precise. Your xterm must at
6996 least at patchlevel 88 / XFree 3.3.3 for this to 6996 least at patchlevel 88 / XFree 3.3.3 for this to
7477 {not available when compiled without the |+wildignore| 7477 {not available when compiled without the |+wildignore|
7478 feature} 7478 feature}
7479 A list of words that change how command line completion is done. 7479 A list of words that change how command line completion is done.
7480 Currently only one word is allowed: 7480 Currently only one word is allowed:
7481 tagfile When using CTRL-D to list matching tags, the kind of 7481 tagfile When using CTRL-D to list matching tags, the kind of
7482 tag and the file of the tag is listed. Only one match 7482 tag and the file of the tag is listed. Only one match
7483 is displayed per line. Often used tag kinds are: 7483 is displayed per line. Often used tag kinds are:
7484 d #define 7484 d #define
7485 f function 7485 f function
7486 Also see |cmdline-completion|. 7486 Also see |cmdline-completion|.
7487 7487