annotate runtime/doc/vi_diff.txt @ 19299:8b710057093c v8.2.0208

patch 8.2.0208: fnamemodify() does not apply ":~" when followed by ":." Commit: https://github.com/vim/vim/commit/d816cd94d87afb73c505bf1e5cd5e07522482113 Author: Bram Moolenaar <Bram@vim.org> Date: Tue Feb 4 22:23:09 2020 +0100 patch 8.2.0208: fnamemodify() does not apply ":~" when followed by ":." Problem: Fnamemodify() does not apply ":~" when followed by ":.". Solution: Don't let a failing ":." cause the ":~" to be skipped. (Yasuhiro Matsumoto, closes #5577)
author Bram Moolenaar <Bram@vim.org>
date Tue, 04 Feb 2020 22:30:03 +0100
parents 9b7f90e56753
children 47bfe07e06a3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18912
ccd16426a1f9 patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents: 18879
diff changeset
1 *vi_diff.txt* For Vim version 8.2. Last change: 2019 Dec 17
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 Differences between Vim and Vi *vi-differences*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
9 This file lists the differences between Vim and Vi/Ex and gives an overview of
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
10 what is in Vim that is not in Vi.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 Vim is mostly POSIX 1003.2-1 compliant. The only command known to be missing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 is ":open". There are probably a lot of small differences (either because Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 is missing something or because Posix is beside the mark).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
16 1. Simulated command |simulated-command|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 2. Missing options |missing-options|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 3. Limits |limits|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 4. The most interesting additions |vim-additions|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 5. Other vim features |other-features|
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
21 6. Supported Vi features |vi-features|
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
22 7. Command-line arguments |cmdline-arguments|
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
23 8. POSIX compliance |posix-compliance|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 ==============================================================================
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
26 1. Simulated command *simulated-command*
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
27
1118
2b8ff9e3c520 updated for version 7.1a
vimboss
parents: 874
diff changeset
28 This command is in Vi, but Vim only simulates it:
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
29
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
30 *:o* *:op* *:open*
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
31 :[range]o[pen] Works like |:visual|: end Ex mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
32 {Vi: start editing in open mode}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
34 :[range]o[pen] /pattern/ As above, additionally move the cursor to the
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
35 column where "pattern" matches in the cursor
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
36 line.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
38 Vim does not support open mode, since it's not really useful. For those
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
39 situations where ":open" would start open mode Vim will leave Ex mode, which
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
40 allows executing the same commands, but updates the whole screen instead of
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
41 only one line.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 2. Missing options *missing-options*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 These options are in the Unix Vi, but not in Vim. If you try to set one of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 them you won't get an error message, but the value is not used and cannot be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 printed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 autoprint (ap) boolean (default on) *'autoprint'* *'ap'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 beautify (bf) boolean (default off) *'beautify'* *'bf'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 flash (fl) boolean (default ??) *'flash'* *'fl'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 graphic (gr) boolean (default off) *'graphic'* *'gr'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 hardtabs (ht) number (default 8) *'hardtabs'* *'ht'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 number of spaces that a <Tab> moves on the display
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 mesg boolean (default on) *'mesg'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 novice boolean (default off) *'novice'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 open boolean (default on) *'open'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 optimize (op) boolean (default off) *'optimize'* *'op'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 redraw boolean (default off) *'redraw'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 slowopen (slow) boolean (default off) *'slowopen'* *'slow'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 sourceany boolean (default off) *'sourceany'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 w300 number (default 23) *'w300'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 w1200 number (default 23) *'w1200'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 w9600 number (default 23) *'w9600'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66
18343
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
67 Vi did not allow for changing the termcap entries, you would have to exit Vi,
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
68 edit the termcap entry and try again. Vim has the |terminal-options|.
375a7ecdb351 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18186
diff changeset
69
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 3. Limits *limits*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 Vim has only a few limits for the files that can be edited {Vi: can not handle
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 <Nul> characters and characters above 128, has limited line length, many other
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 limits}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 *E340*
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
77 Maximum line length 2147483647 characters. Longer lines are split.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 Maximum number of lines 2147483647 lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 Maximum file size 2147483647 bytes (2 Gbyte) when a long integer is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 32 bits. Much more for 64 bit longs. Also limited
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 by available disk space for the |swap-file|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 *E75*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 Length of a file path Unix and Win32: 1024 characters, otherwise 256
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 characters (or as much as the system supports).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 Length of an expanded string option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 Unix and Win32: 1024 characters, otherwise 256
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 Maximum display width Unix and Win32: 1024 characters, otherwise 255
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 Maximum lhs of a mapping 50 characters.
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 235
diff changeset
91 Number of different highlighting types: over 30000
3082
3502a7f991fc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
92 Range of a Number variable: -2147483648 to 2147483647 (might be more on 64
3502a7f991fc Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2608
diff changeset
93 bit systems)
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
94 Maximum length of a line in a tags file: 512 bytes.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 Information for undo and text in registers is kept in memory, thus when making
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 (big) changes the amount of (virtual) memory available limits the number of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 undo levels and the text that can be kept in registers. Other things are also
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 kept in memory: Command-line history, error messages for Quickfix mode, etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 Memory usage limits
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 -------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 The option 'maxmem' ('mm') is used to set the maximum memory used for one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 buffer (in kilobytes). 'maxmemtot' is used to set the maximum memory used for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 all buffers (in kilobytes). The defaults depend on the system used. For the
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
107 Amiga, 'maxmemtot' is set depending on the amount of memory available.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
108 These are not hard limits, but tell Vim when to move text into a swap file.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
109 If you don't like Vim to swap to a file, set 'maxmem' and 'maxmemtot' to a
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
110 very large value. The swap file will then only be used for recovery. If you
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
111 don't want a swap file at all, set 'updatecount' to 0, or use the "-n"
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
112 argument when starting Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 4. The most interesting additions *vim-additions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 Vi compatibility. |'compatible'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 Although Vim is 99% Vi compatible, some things in Vi can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 considered to be a bug, or at least need improvement. But still, Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 starts in a mode which behaves like the "real" Vi as much as possible.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 To make Vim behave a little bit better, try resetting the 'compatible'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 option:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 :set nocompatible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 Or start Vim with the "-N" argument:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 vim -N
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
126 Vim starts with 'nocompatible' automatically if you have a .vimrc
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
127 file. See |startup|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 The 'cpoptions' option can be used to set Vi compatibility on/off for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 a number of specific items.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 Support for different systems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 Vim can be used on:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 - All Unix systems (it works on all systems it was tested on, although
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 the GUI and Perl interface may not work everywhere).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 - Amiga (500, 1000, 1200, 2000, 3000, 4000, ...).
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18972
diff changeset
136 - MS-Windows
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 - VMS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 - BeOS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 - Macintosh
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 - IBM OS/390
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
141 Note that on some systems features need to be disabled to reduce
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
142 resource usage. For some outdated systems you need to use an older
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
143 Vim version.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
145 Multi level persistent undo. |undo|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 'u' goes backward in time, 'CTRL-R' goes forward again. Set option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 'undolevels' to the number of changes to be remembered (default 1000).
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
148 Set 'undolevels' to 0 for a Vi-compatible one level undo. Set it to
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 -1 for no undo at all.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 When all changes in a buffer have been undone, the buffer is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 considered changed anymore. You can exit it with :q, without <!>.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
152 When undoing a few changes and then making a new change Vim will
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
153 create a branch in the undo tree. This means you can go back to any
1186
2de44d8f2cf1 updated for version 7.1b
vimboss
parents: 1118
diff changeset
154 state of the text, there is no risk of a change causing text to be
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
155 lost forever. |undo-tree|
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
156 The undo information is stored in a file when the 'undofile' option is
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
157 set. This means you can exit Vim, start Vim on a previously edited
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
158 file and undo changes that were made before exiting Vim.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
160 Graphical User Interface (GUI). |gui|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 Included support for GUI: menu's, mouse, scrollbars, etc. You can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 define your own menus. Better support for CTRL/SHIFT/ALT keys in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 combination with special keys and mouse. Supported for various
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 platforms, such as X11 (with Motif and Athena interfaces), GTK, Win32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 (Windows 95 and later), BeOS, Amiga and Macintosh.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 Multiple windows and buffers. |windows.txt|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 Vim can split the screen into several windows, each editing a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 different buffer or the same buffer at a different location. Buffers
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 can still be loaded (and changed) but not displayed in a window. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 is called a hidden buffer. Many commands and options have been added
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 for this facility.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
173 Vim can also use multiple tab pages, each with one or more windows. A
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
174 line with tab labels can be used to quickly switch between these pages.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
175 |tab-page|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
177 Terminal window. |:terminal|
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
178 Vim can create a window in which a terminal emulator runs. This can
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
179 be used to execute an arbitrary command, a shell or a debugger.
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
180
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 Syntax highlighting. |:syntax|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 Vim can highlight keywords, patterns and other things. This is
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
183 defined by a number of |:syntax| commands, and can be made to
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 highlight most languages and file types. A number of files are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 included for highlighting the most common languages, like C, C++,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 Java, Pascal, Makefiles, shell scripts, etc. The colors used for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 highlighting can be defined for ordinary terminals, color terminals
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
188 and the GUI with the |:highlight| command. A convenient way to do
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
189 this is using a |:colorscheme| command.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
190 The highlighted text can be exported as HTML. |convert-to-HTML|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
191 Other items that can be highlighted are matches with the search string
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
192 |'hlsearch'|, matching parens |matchparen| and the cursor line and
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
193 column |'cursorline'| |'cursorcolumn'|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
195 Text properties |textprop.txt|
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
196 Vim supports highlighting text by a plugin. Property types can be
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
197 specified with |prop_type_add()| and properties can be placed with
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
198 |prop_add()|.
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
199
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
200 Spell checking. |spell|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
201 When the 'spell' option is set Vim will highlight spelling mistakes.
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3082
diff changeset
202 About 50 languages are currently supported, selected with the
1618
46bbe11644e0 updated for version 7.2a
vimboss
parents: 1376
diff changeset
203 'spelllang' option. In source code only comments and strings are
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
204 checked for spelling.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
205
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
206 Folding. |folding|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 A range of lines can be shown as one "folded" line. This allows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 overviewing a file and moving blocks of text around quickly.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 Folds can be created manually, from the syntax of the file, by indent,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
212 Diff mode. |diff|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
213 Vim can show two versions of a file with the differences highlighted.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
214 Parts of the text that are equal are folded away. Commands can be
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
215 used to move text from one version to the other.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
216
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
217 Plugins. |add-plugin|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 The functionality can be extended by dropping a plugin file in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219 right directory. That's an easy way to start using Vim scripts
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 written by others. Plugins can be for all kind of files, or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 specifically for a filetype.
9887
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
222 Packages make this even easier. |packages|
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
223
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
224 Asynchronous communication and timers. |channel| |job| |timer|
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
225 Vim can exchange messages with other processes in the background.
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
226 This makes it possible to have servers do work and send back the
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
227 results to Vim. |channel|
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
228 Vim can start a job, communicate with it and stop it. |job|
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
229 Timers can fire once or repeatedly and invoke a function to do any
b4da19b7539f commit https://github.com/vim/vim/commit/dc1f1645cb495fa6bfbe216d7359f23539a0e25d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
230 work. |timer|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 Repeat a series of commands. |q|
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
233 "q{c}" starts recording typed characters into named register {c}.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
234 A subsequent "q" stops recording. The register can then be executed
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
235 with the "@{c}" command. This is very useful to repeat a complex
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
236 action.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 Flexible insert mode. |ins-special-special|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 The arrow keys can be used in insert mode to move around in the file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 This breaks the insert in two parts as far as undo and redo is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 concerned.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
243 CTRL-O can be used to execute a single Normal mode command. This is
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
244 almost the same as hitting <Esc>, typing the command and doing |a|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 Visual mode. |Visual-mode|
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
247 Visual mode can be used to first highlight a piece of text and then
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
248 give a command to do something with it. This is an (easy to use)
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
249 alternative to first giving the operator and then moving to the end of
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
250 the text to be operated upon.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
251 |v| and |V| are used to start Visual mode. |v| works on characters
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
252 and |V| on lines. Move the cursor to extend the Visual area. It is
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
253 shown highlighted on the screen. By typing "o" the other end of the
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
254 Visual area can be moved. The Visual area can be affected by an
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
255 operator:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 d delete
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 c change
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 y yank
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 > or < insert or delete indent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 ! filter through external program
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 = filter through indent
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
262 : start |:| command for the Visual lines.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 gq format text to 'textwidth' columns
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264 J join lines
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265 ~ swap case
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266 u make lowercase
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 U make uppercase
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
268 {Vi has no Visual mode, the name "visual" is used for Normal mode, to
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
269 distinguish it from Ex mode}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 Block operators. |visual-block|
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
272 With Visual mode a rectangular block of text can be selected. Start
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
273 Visual mode with CTRL-V. The block can be deleted ("d"), yanked ("y")
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
274 or its case can be changed ("~", "u" and "U"). A deleted or yanked
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
275 block can be put into the text with the "p" and "P" commands.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
277 Help system. |:help|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 Help is displayed in a window. The usual commands can be used to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 move around, search for a string, etc. Tags can be used to jump
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
280 around in the help files, just like hypertext links. The |:help|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 command takes an argument to quickly jump to the info on a subject.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 <F1> is the quick access to the help system. The name of the help
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 index file can be set with the 'helpfile' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 Command-line editing and history. |cmdline-editing|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 You can insert or delete at any place in the command-line using the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 cursor keys. The right/left cursor keys can be used to move
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 forward/backward one character. The shifted right/left cursor keys
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 can be used to move forward/backward one word. CTRL-B/CTRL-E can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 used to go to the begin/end of the command-line.
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
291 {Vi: can only alter the last character in the line}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
292 {Vi: when hitting <Esc> the command-line is executed. This is
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
293 unexpected for most people; therefore it was changed in Vim. But when
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
294 the <Esc> is part of a mapping, the command-line is executed. If you
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
295 want the Vi behaviour also when typing <Esc>, use ":cmap ^V<Esc>
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
296 ^V^M"}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 |cmdline-history|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 The command-lines are remembered. The up/down cursor keys can be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 to recall previous command-lines. The 'history' option can be set to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 the number of lines that will be remembered. There is a separate
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 history for commands and for search patterns.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 Command-line completion. |cmdline-completion|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 While entering a command-line (on the bottom line of the screen)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 <Tab> can be typed to complete
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 what example ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 - command :e<Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308 - tag :ta scr<Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 - option :set sc<Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 - option value :set hf=<Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 - file name :e ve<Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 - etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 If there are multiple matches, CTRL-N (next) and CTRL-P (previous)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 will walk through the matches. <Tab> works like CTRL-N, but wraps
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 around to the first match.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318 The 'wildchar' option can be set to the character for command-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 completion, <Tab> is the default. CTRL-D can be typed after an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 (incomplete) wildcard; all matches will be listed. CTRL-A will insert
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 all matches. CTRL-L will insert the longest common part of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 matches.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
324 Insert-mode completion. |ins-completion|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
325 In Insert mode the CTRL-N and CTRL-P keys can be used to complete a
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
326 word that appears elsewhere. |i_CTRL-N|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327 With CTRL-X another mode is entered, through which completion can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 done for:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329 |i_CTRL-X_CTRL-F| file names
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330 |i_CTRL-X_CTRL-K| words from 'dictionary' files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 |i_CTRL-X_CTRL-T| words from 'thesaurus' files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 |i_CTRL-X_CTRL-I| words from included files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333 |i_CTRL-X_CTRL-L| whole lines
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 |i_CTRL-X_CTRL-]| words from the tags file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 |i_CTRL-X_CTRL-D| definitions or macros
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
336 |i_CTRL-X_CTRL-O| Omni completion: clever completion
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
337 specifically for a file type
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
338 etc.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
340 Long line support. |'wrap'| |'linebreak'|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341 If the 'wrap' option is off, long lines will not wrap and only part
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
342 of them will be shown. When the cursor is moved to a part that is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343 shown, the screen will scroll horizontally. The minimum number of
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
344 columns to scroll can be set with the 'sidescroll' option. The |zh|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
345 and |zl| commands can be used to scroll sideways.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 Alternatively, long lines are broken in between words when the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 'linebreak' option is set. This allows editing a single-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 paragraph conveniently (e.g. when the text is later read into a DTP
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
349 program). Move the cursor up/down with the |gk| and |gj| commands.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 Text formatting. |formatting|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 The 'textwidth' option can be used to automatically limit the line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 length. This supplements the 'wrapmargin' option of Vi, which was not
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
354 very useful. The |gq| operator can be used to format a piece of text
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
355 (for example, |gqap| formats the current paragraph). Commands for
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
356 text alignment: |:center|, |:left| and |:right|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
358 Extended search patterns. |pattern|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359 There are many extra items to match various text items. Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 A "\n" can be used in a search pattern to match a line break.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 "x\{2,4}" matches "x" 2 to 4 times.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 "\s" matches a white space character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
364 Directory, remote and archive browsing. |netrw|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
365 Vim can browse the file system. Simply edit a directory. Move around
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
366 in the list with the usual commands and press <Enter> to go to the
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
367 directory or file under the cursor.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
368 This also works for remote files over ftp, http, ssh, etc.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
369 Zip and tar archives can also be browsed. |tar| |zip|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
370
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371 Edit-compile-edit speedup. |quickfix|
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
372 The |:make| command can be used to run the compilation and jump to the
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
373 first error. A file with compiler error messages is interpreted. Vim
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
374 jumps to the first error.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 Each line in the error file is scanned for the name of a file, line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 number and error message. The 'errorformat' option can be set to a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 list of scanf-like strings to handle output from many compilers.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
380 The |:cn| command can be used to jump to the next error.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
381 |:cl| lists all the error messages. Other commands are available.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 The 'makeef' option has the name of the file with error messages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383 The 'makeprg' option contains the name of the program to be executed
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
384 with the |:make| command.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 The 'shellpipe' option contains the string to be used to put the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 output of the compiler into the errorfile.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
388 Finding matches in files. |:vimgrep|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
389 Vim can search for a pattern in multiple files. This uses the
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
390 advanced Vim regexp pattern, works on all systems and also works to
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
391 search in compressed files.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
392
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
393 Improved indenting for programs. |'cindent'|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394 When the 'cindent' option is on the indent of each line is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 automatically adjusted. C syntax is mostly recognized. The indent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396 for various styles can be set with 'cinoptions'. The keys to trigger
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397 indenting can be set with 'cinkeys'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399 Comments can be automatically formatted. The 'comments' option can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 set to the characters that start and end a comment. This works best
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 for C code, but also works for e-mail (">" at start of the line) and
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
402 other types of text. The |=| operator can be used to re-indent
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403 lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
405 For many other languages an indent plugin is present to support
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
406 automatic indenting. |30.3|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
407
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
408 Searching for words in included files. |include-search|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
409 The |[i| command can be used to search for a match of the word under
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 the cursor in the current and included files. The 'include' option
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1618
diff changeset
411 can be set to a pattern that describes a command to include a file
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412 (the default is for C programs).
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
413 The |[I| command lists all matches, the |[_CTRL-I| command jumps to
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 a match.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
415 The |[d|, |[D| and |[_CTRL-D| commands do the same, but only for
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416 lines where the pattern given with the 'define' option matches.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
417
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
418 Automatic commands. |autocommand|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419 Commands can be automatically executed when reading a file, writing a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 file, jumping to another buffer, etc., depending on the file name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 This is useful to set options and mappings for C programs,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
422 documentation, plain text, e-mail, etc. This also makes it possible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423 to edit compressed files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
425 Scripts and Expressions. |expression|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
426 Commands have been added to form up a powerful script language.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 |:if| Conditional execution, which can be used for example
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 to set options depending on the value of $TERM.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429 |:while| Repeat a number of commands.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
430 |:for| Loop over a list.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 |:echo| Print the result of an expression.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432 |:let| Assign a value to an internal variable, option, etc.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
433 Variable types are Number, String, List and Dictionary.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 |:execute| Execute a command formed by an expression.
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
435 |:try| Catch exceptions.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
436 etc., etc. See |eval|.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
437 Debugging and profiling are supported. |debug-scripts| |profile|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
438 If this is not enough, an interface is provided to |Python|, |Ruby|,
2320
966a5609669e Added Lua interfae. (Luis Carvalho)
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
439 |Tcl|, |Lua|, |Perl| and |MzScheme|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
441 Viminfo. |viminfo-file|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442 The command-line history, marks and registers can be stored in a file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 that is read on startup. This can be used to repeat a search command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 or command-line command after exiting and restarting Vim. It is also
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
445 possible to jump right back to where the last edit stopped with |'0|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 The 'viminfo' option can be set to select which items to store in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447 .viminfo file. This is off by default.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
449 Printing. |printing|
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
450 The |:hardcopy| command sends text to the printer. This can include
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
451 syntax highlighting.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
452
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
453 Mouse support. |mouse-using|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
454 The mouse is supported in the GUI version, in an xterm for Unix, for
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
455 BSDs with sysmouse, for Linux with gpm, and Win32. It can be used to
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
456 position the cursor, select the visual area, paste a register, etc.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
457
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
458 Usage of key names. |<>| |key-notation|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
459 Special keys now all have a name like <Up>, <End>, etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
460 This name can be used in mappings, to make it easy to edit them.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
461
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
462 Editing binary files. |edit-binary|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
463 Vim can edit binary files. You can change a few characters in an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
464 executable file, without corrupting it. Vim doesn't remove NUL
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
465 characters (they are represented as <NL> internally).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 |-b| command-line argument to start editing a binary file
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
467 |'binary'| Option set by |-b|. Prevents adding an <EOL> for the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 last line in the file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
470 Multi-language support. |multi-lang|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 Files in double-byte or multi-byte encodings can be edited. There is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472 UTF-8 support to be able to edit various languages at the same time,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
473 without switching fonts. |UTF-8|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474 Messages and menus are available in different languages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
476 Move cursor beyond lines.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
477 When the 'virtualedit' option is set the cursor can move all over the
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
478 screen, also where there is no text. This is useful to edit tables
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
479 and figures easily.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
480
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
482 5. Other vim features *other-features*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
484 A random collection of nice extra features.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
485
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 When Vim is started with "-s scriptfile", the characters read from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488 "scriptfile" are treated as if you typed them. If end of file is reached
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
489 before the editor exits, further characters are read from the console.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
490
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
491 The "-w" option can be used to record all typed characters in a script file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
492 This file can then be used to redo the editing, possibly on another file or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
493 after changing some commands in the script file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
494
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
495 The "-o" option opens a window for each argument. "-o4" opens four windows.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
496
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
497 Vi requires several termcap entries to be able to work full-screen. Vim only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
498 requires the "cm" entry (cursor motion).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
499
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
500
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
501 In command mode:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
502
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
503 When the 'showcmd' option is set, the command characters are shown in the last
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
504 line of the screen. They are removed when the command is finished.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
505
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
506 If the 'ruler' option is set, the current cursor position is shown in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
507 last line of the screen.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
508
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
509 "U" still works after having moved off the last changed line and after "u".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
510
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
511 Characters with the 8th bit set are displayed. The characters between '~' and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
512 0xa0 are displayed as "~?", "~@", "~A", etc., unless they are included in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
513 'isprint' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
514
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
515 "][" goes to the next ending of a C function ('}' in column 1).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
516 "[]" goes to the previous ending of a C function ('}' in column 1).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
517
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
518 "]f", "[f" and "gf" start editing the file whose name is under the cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
519 CTRL-W f splits the window and starts editing the file whose name is under
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
520 the cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
521
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
522 "*" searches forward for the identifier under the cursor, "#" backward.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
523 "K" runs the program defined by the 'keywordprg' option, with the identifier
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
524 under the cursor as argument.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
525
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
526 "%" can be preceded with a count. The cursor jumps to the line that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
527 percentage down in the file. The normal "%" function to jump to the matching
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
528 brace skips braces inside quotes.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
529
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
530 With the CTRL-] command, the cursor may be in the middle of the identifier.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
531
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
532 The used tags are remembered. Commands that can be used with the tag stack
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
533 are CTRL-T, ":pop" and ":tag". ":tags" lists the tag stack.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
534
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
535 Vi uses 'wrapscan' when searching for a tag. When jumping to a tag Vi starts
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
536 searching in line 2 of another file. It does not find a tag in line 1 of
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
537 another file when 'wrapscan' is not set.
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
538
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
539 The 'tags' option can be set to a list of tag file names. Thus multiple
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
540 tag files can be used. For file names that start with "./", the "./" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
541 replaced with the path of the current file. This makes it possible to use a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
542 tags file in the same directory as the file being edited.
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
543 {Vi: always uses binary search in some versions}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
544 {Vi does not have the security prevention for commands in tag files}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
545
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
546 Previously used file names are remembered in the alternate file name list.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
547 CTRL-^ accepts a count, which is an index in this list.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
548 ":files" command shows the list of alternate file names.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
549 "#<N>" is replaced with the <N>th alternate file name in the list.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
550 "#<" is replaced with the current file name without extension.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
551
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
552 Search patterns have more features. The <NL> character is seen as part of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
553 search pattern and the substitute string of ":s". Vi sees it as the end of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
554 the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
555
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
556 Searches can put the cursor on the end of a match and may include a character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
557 offset.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
558
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
559 Count added to "~", ":next", ":Next", "n" and "N".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
560
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
561 The command ":next!" with 'autowrite' set does not write the file. In vi the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
562 file was written, but this is considered to be a bug, because one does not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
563 expect it and the file is not written with ":rewind!".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
564
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
565 In Vi when entering a <CR> in replace mode deletes a character only when 'ai'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
566 is set (but does not show it until you hit <Esc>). Vim always deletes a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
567 character (and shows it immediately).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
568
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
569 Added :wnext command. Same as ":write" followed by ":next".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
570
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
571 The ":w!" command always writes, also when the file is write protected. In Vi
5690
40f18a1c1592 updated for version 7.4.191
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
572 you would have to do ":!chmod +w %:S" and ":set noro".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
573
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
574 When 'tildeop' has been set, "~" is an operator (must be followed by a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
575 movement command).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
576
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
577 With the "J" (join) command you can reset the 'joinspaces' option to have only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
578 one space after a period (Vi inserts two spaces).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
579
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
580 "cw" can be used to change white space formed by several characters (Vi is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
581 confusing: "cw" only changes one space, while "dw" deletes all white space).
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
582 {Vi: "cw" when on a blank followed by other blanks changes only the first
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
583 blank; this is probably a bug, because "dw" deletes all the blanks}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
584
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
585 "o" and "O" accept a count for repeating the insert (Vi clears a part of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
586 display).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
587
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
588 Flags after Ex commands not supported (no plans to include it).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
589
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
590 On non-UNIX systems ":cd" command shows current directory instead of going to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
591 the home directory (there isn't one). ":pwd" prints the current directory on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
592 all systems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
593
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
594 After a ":cd" command the file names (in the argument list, opened files)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
595 still point to the same files. In Vi ":cd" is not allowed in a changed file;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
596 otherwise the meaning of file names change.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
597
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
598 ":source!" command reads Vi commands from a file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
599
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
600 ":mkexrc" command writes current modified options and mappings to a ".exrc"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
601 file. ":mkvimrc" writes to a ".vimrc" file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
602
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
603 No check for "tail recursion" with mappings. This allows things like
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
604 ":map! foo ^]foo".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
605
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
606 When a mapping starts with number, vi loses the count typed before it (e.g.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
607 when using the mapping ":map g 4G" the command "7g" goes to line 4). This is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
608 considered a vi bug. Vim concatenates the counts (in the example it becomes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
609 "74G"), as most people would expect.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
610
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
611 The :put! command inserts the contents of a register above the current line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
612
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
613 The "p" and "P" commands of vi cannot be repeated with "." when the putted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
614 text is less than a line. In Vim they can always be repeated.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
615
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
616 ":noremap" command can be used to enter a mapping that will not be remapped.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
617 This is useful to exchange the meaning of two keys. ":cmap", ":cunmap" and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
618 ":cnoremap" can be used for mapping in command-line editing only. ":imap",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
619 ":iunmap" and ":inoremap" can be used for mapping in insert mode only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
620 Similar commands exist for abbreviations: ":noreabbrev", ":iabbrev"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
621 ":cabbrev", ":iunabbrev", ":cunabbrev", ":inoreabbrev", ":cnoreabbrev".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
622
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
623 In Vi the command ":map foo bar" would remove a previous mapping
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
624 ":map bug foo". This is considered a bug, so it is not included in Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
625 ":unmap! foo" does remove ":map! bug foo", because unmapping would be very
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
626 difficult otherwise (this is vi compatible).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
627
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
628 The ':' register contains the last command-line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
629 The '%' register contains the current file name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
630 The '.' register contains the last inserted text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
631
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
632 ":dis" command shows the contents of the yank registers.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
633
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
634 CTRL-O/CTRL-I can be used to jump to older/newer positions. These are the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
635 same positions as used with the '' command, but may be in another file. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
636 ":jumps" command lists the older positions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
637
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
638 If the 'shiftround' option is set, an indent is rounded to a multiple of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
639 'shiftwidth' with ">" and "<" commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
640
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
641 The 'scrolljump' option can be set to the minimum number of lines to scroll
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
642 when the cursor gets off the screen. Use this when scrolling is slow.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
643
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
644 The 'scrolloff' option can be set to the minimum number of lines to keep
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
645 above and below the cursor. This gives some context to where you are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
646 editing. When set to a large number the cursor line is always in the middle
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
647 of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
648
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
649 Uppercase marks can be used to jump between files. The ":marks" command lists
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
650 all currently set marks. The commands "']" and "`]" jump to the end of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
651 previous operator or end of the text inserted with the put command. "'[" and
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
652 "`[" do jump to the start. {Vi: no uppercase marks}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
653
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
654 The 'shelltype' option can be set to reflect the type of shell used on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
655 Amiga.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
656
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
657 The 'highlight' option can be set for the highlight mode to be used for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
658 several commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
659
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
660 The CTRL-A (add) and CTRL-X (subtract) commands are new. The count to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
661 command (default 1) is added to/subtracted from the number at or after the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
662 cursor. That number may be decimal, octal (starts with a '0') or hexadecimal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
663 (starts with '0x'). Very useful in macros.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
664
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
665 With the :set command the prefix "inv" can be used to invert boolean options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
666
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
667 In both Vi and Vim you can create a line break with the ":substitute" command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
668 by using a CTRL-M. For Vi this means you cannot insert a real CTRL-M in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
669 text. With Vim you can put a real CTRL-M in the text by preceding it with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
670 CTRL-V.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
671
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
672
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
673 In Insert mode:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
674
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
675 If the 'revins' option is set, insert happens backwards. This is for typing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
676 Hebrew. When inserting normal characters the cursor will not be shifted and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
677 the text moves rightwards. Backspace, CTRL-W and CTRL-U will also work in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
678 the opposite direction. CTRL-B toggles the 'revins' option. In replace mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
679 'revins' has no effect. Only when enabled at compile time.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
680
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
681 The backspace key can be used just like CTRL-D to remove auto-indents.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
682
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
683 You can backspace, CTRL-U and CTRL-W over line breaks if the 'backspace' (bs)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
684 option includes "eol". You can backspace over the start of insert if the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
685 'backspace' option includes "start".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
686
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3082
diff changeset
687 When the 'paste' option is set, a few options are reset and mapping in insert
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
688 mode and abbreviation are disabled. This allows for pasting text in windowing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
689 systems without unexpected results. When the 'paste' option is reset, the old
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
690 option values are restored.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
691
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
692 CTRL-T/CTRL-D always insert/delete an indent in the current line, no matter
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
693 what column the cursor is in.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
694
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
695 CTRL-@ (insert previously inserted text) works always (Vi: only when typed as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
696 first character).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
697
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
698 CTRL-A works like CTRL-@ but does not leave insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
699
18186
03b854983b14 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16808
diff changeset
700 CTRL-R {register} can be used to insert the contents of a register.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
701
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
702 When the 'smartindent' option is set, C programs will be better auto-indented.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
703 With 'cindent' even more.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
704
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
705 CTRL-Y and CTRL-E can be used to copy a character from above/below the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
706 current cursor position.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
707
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
708 After CTRL-V you can enter a three digit decimal number. This byte value is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
709 inserted in the text as a single character. Useful for international
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
710 characters that are not on your keyboard.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
711
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
712 When the 'expandtab' (et) option is set, a <Tab> is expanded to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
713 appropriate number of spaces.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
714
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
715 The window always reflects the contents of the buffer (Vi does not do this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
716 when changing text and in some other cases).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
717
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
718 If Vim is compiled with DIGRAPHS defined, digraphs are supported. A set of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
719 normal digraphs is included. They are shown with the ":digraph" command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
720 More can be added with ":digraph {char1}{char2} {number}". A digraph is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
721 entered with "CTRL-K {char1} {char2}" or "{char1} BS {char2}" (only when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
722 'digraph' option is set).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
723
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
724 When repeating an insert, e.g. "10atest <Esc>" vi would only handle wrapmargin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
725 for the first insert. Vim does it for all.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
726
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
727 A count to the "i" or "a" command is used for all the text. Vi uses the count
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
728 only for one line. "3iabc<NL>def<Esc>" would insert "abcabcabc<NL>def" in Vi
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
729 but "abc<NL>defabc<NL>defabc<NL>def" in Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
730
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
731
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
732 In Command-line mode:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
733
235
23d380e32c95 updated for version 7.0066
vimboss
parents: 166
diff changeset
734 <Esc> terminates the command-line without executing it. In vi the command
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
735 line would be executed, which is not what most people expect (hitting <Esc>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
736 should always get you back to command mode). To avoid problems with some
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
737 obscure macros, an <Esc> in a macro will execute the command. If you want a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
738 typed <Esc> to execute the command like vi does you can fix this with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
739 ":cmap ^V<Esc> ^V<CR>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
740
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
741 General:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
742
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
743 The 'ttimeout' option is like 'timeout', but only works for cursor and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
744 function keys, not for ordinary mapped characters. The 'timeoutlen' option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
745 gives the number of milliseconds that is waited for. If the 'esckeys' option
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
746 is not set, cursor and function keys that start with <Esc> are not recognized
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
747 in insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
748
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
749 There is an option for each terminal string. Can be used when termcap is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
750 supported or to change individual strings.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
751
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
752 The 'fileformat' option can be set to select the <EOL>: "dos" <CR><NL>, "unix"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
753 <NL> or "mac" <CR>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
754 When the 'fileformats' option is not empty, Vim tries to detect the type of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
755 <EOL> automatically. The 'fileformat' option is set accordingly.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
756
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
757 On systems that have no job control (older Unix systems and non-Unix systems)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
758 the CTRL-Z, ":stop" or ":suspend" command starts a new shell.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
759
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
760 If Vim is started on the Amiga without an interactive window for output, a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
761 window is opened (and :sh still works). You can give a device to use for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
762 editing with the |-d| argument, e.g. "-d con:20/20/600/150".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
763
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
764 The 'columns' and 'lines' options are used to set or get the width and height
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
765 of the display.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
766
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
767 Option settings are read from the first and last few lines of the file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
768 Option 'modelines' determines how many lines are tried (default is 5). Note
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
769 that this is different from the Vi versions that can execute any Ex command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
770 in a modeline (a major security problem). |trojan-horse|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
771
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
772 If the 'insertmode' option is set (e.g. in .exrc), Vim starts in insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
773 And it comes back there, when pressing <Esc>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
774
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
775 Undo information is kept in memory. Available memory limits the number and
18972
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
776 size of change that can be undone. This is hardly a problem on the Amiga and
130acb903dbe Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18912
diff changeset
777 almost never with Unix and Win32.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
778
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
779 If the 'backup' or 'writebackup' option is set: Before a file is overwritten,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
780 a backup file (.bak) is made. If the "backup" option is set it is left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
781 behind.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
782
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
783 Vim creates a file ending in ".swp" to store parts of the file that have been
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
784 changed or that do not fit in memory. This file can be used to recover from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
785 an aborted editing session with "vim -r file". Using the swap file can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
786 switched off by setting the 'updatecount' option to 0 or starting Vim with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
787 the "-n" option. Use the 'directory' option for placing the .swp file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
788 somewhere else.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
789
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
790 Vim is able to work correctly on filesystems with 8.3 file names, also when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
791 using messydos or crossdos filesystems on the Amiga, or any 8.3 mounted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
792 filesystem under Unix. See |'shortname'|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
793
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
794 Error messages are shown at least one second (Vi overwrites error messages).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
795
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
796 If Vim gives the |hit-enter| prompt, you can hit any key. Characters other
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
797 than <CR>, <NL> and <Space> are interpreted as the (start of) a command.
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
798 {Vi: only ":" commands are interpreted}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
799
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
800 The contents of the numbered and unnamed registers is remembered when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
801 changing files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
802
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
803 The "No lines in buffer" message is a normal message instead of an error
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
804 message, since that may cause a mapping to be aborted.
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
805 {Vi: error messages may be overwritten with other messages before you have a
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
806 chance to read them}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
807
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
808 The AUX: device of the Amiga is supported.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
809
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
810 ==============================================================================
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
811 6. Supported Vi features *vi-features*
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
812
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
813 Vim supports nearly all Vi commands and mostly in the same way. That is when
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
814 the 'compatible' option is set and 'cpoptions' contains all flags. What the
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
815 effect is of resetting 'compatible' and removing flags from 'cpoptions' can be
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
816 found at the help for the specific command.
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
817
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
818 The help files used to mark features that are in Vim but not in Vi with {not
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
819 in Vi}. However, since these remarks cluttered the help files we now do it
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
820 the other way around: Below is listed what Vi already supported. Anything
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
821 else has been added by Vim.
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
822
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
823
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
824 The following Ex commands are supported by Vi: ~
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
825
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
826 `:abbreviate` enter abbreviation
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
827 `:append` append text
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
828 `:args` print the argument list
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
829 `:cd` change directory; Vi: no "cd -"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
830 `:change` replace a line or series of lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
831 `:chdir` change directory
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
832 `:copy` copy lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
833 `:delete` delete lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
834 `:edit` edit a file
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
835 `:exit` same as `:xit`
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
836 `:file` show or set the current file name; Vi: without the column number
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
837 `:global` execute commands for matching lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
838 `:insert` insert text
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
839 `:join` join lines; Vi: not :join!
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
840 `:k` set a mark
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
841 `:list` print lines
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
842 `:map` show or enter a mapping
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
843 `:mark` set a mark
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
844 `:move` move lines
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
845 `:Next` go to previous file in the argument list {Vi: no count}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
846 `:next` go to next file in the argument list {Vi: no count}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
847 `:number` print lines with line number
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
848 `:open` start open mode (not implemented in Vim)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
849 `:pop` jump to older entry in tag stack (only in some versions)
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
850 `:preserve` write all text to swap file {Vi: might also exit}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
851 `:previous` same as `:Next` {Vi: only in some versions}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
852 `:print` print lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
853 `:put` insert contents of register in the text
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
854 `:quit` quit Vi
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
855 `:read` read file into the text
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
856 `:recover` recover a file from a swap file {Vi: recovers in another way
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
857 and sends mail if there is something to recover}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
858 `:rewind` go to the first file in the argument list; no ++opt
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
859 `:set` set option; but not `:set inv{option}`, `:set option&`,
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
860 `:set all&`, `:set option+=value`, `:set option^=value`
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
861 `:set option-=value` `:set option<`
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
862 `:shell` escape to a shell
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
863 `:source` read Vi or Ex commands from a file
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
864 `:stop` suspend the editor or escape to a shell
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
865 `:substitute` find and replace text; Vi: no '&', 'i', 's', 'r' or 'I' flag,
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
866 confirm prompt only supports 'y' and 'n', no highlighting
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
867 `:suspend` same as ":stop"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
868 `:t` same as ":copy"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
869 `:tag` jump to tag
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
870 `:unabbreviate` remove abbreviation
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
871 `:undo` undo last change {Vi: only one level}
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
872 `:unmap` remove mapping
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
873 `:vglobal` execute commands for not matching lines
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
874 `:version` print version number and other info
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
875 `:visual` same as ":edit", but turns off "Ex" mode
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
876 `:wq` write to a file and quit Vi
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
877 `:write` write to a file
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
878 `:xit` write if buffer changed and quit Vi
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
879 `:yank` yank lines into a register
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
880 `:z` print some lines {not in all versions of Vi}
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
881 `:!` filter lines or execute an external command
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
882 `:"` comment
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
883 `:#` same as ":number"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
884 `:*` execute contents of a register
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
885 `:&` repeat last ":substitute"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
886 `:<` shift lines one 'shiftwidth' left
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
887 `:=` print the cursor line number
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
888 `:>` shift lines one 'shiftwidth' right
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
889 `:@` execute contents of a register; but not `:@`; `:@@` only in
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
890 some versions
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
891
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
892 Common for these commands is that Vi doesn't support the ++opt argument on
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
893 `:edit` and other commands that open a file.
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
894
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
895
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
896 The following Normal mode commands are supported by Vi: ~
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
897
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
898 note: See the beginning of |normal-index| for the meaning of WORD, N, Nmove
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
899 and etc in the description text.
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
900
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
901 |CTRL-B| scroll N screens Backwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
902 |CTRL-C| interrupt current (search) command
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
903 |CTRL-D| scroll Down N lines (default: half a screen); Vim scrolls
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
904 'scroll' screen lines, Vi scrolls file lines; makes a
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
905 difference when lines wrap
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
906 |CTRL-E| scroll N lines upwards (N lines Extra)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
907 |CTRL-F| scroll N screens Forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
908 |CTRL-G| display current file name and position
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
909 |<BS>| same as "h"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
910 |CTRL-H| same as "h"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
911 |<NL>| same as "j"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
912 |CTRL-J| same as "j"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
913 |CTRL-L| redraw screen
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
914 |<CR>| cursor to the first CHAR N lines lower
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
915 |CTRL-M| same as <CR>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
916 |CTRL-N| same as "j"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
917 |CTRL-P| same as "k"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
918 |CTRL-R| in some Vi versions: same as CTRL-L
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
919 |CTRL-T| jump to N older Tag in tag list
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
920 |CTRL-U| N lines Upwards (default: half a screen) {Vi used file lines
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
921 while Vim scrolls 'scroll' screen lines; makes a difference
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
922 when lines wrap}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
923 |CTRL-Y| scroll N lines downwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
924 |CTRL-Z| suspend program (or start new shell)
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
925 |CTRL-]| :ta to ident under cursor {Vi: identifier after the cursor}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
926 |CTRL-^| edit alternate file {Vi: no count}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
927 |<Space>| same as "l"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
928 |!| filter Nmove text through the {filter} command
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
929 |!!| filter N lines through the {filter} command
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
930 " use register {a-zA-Z0-9.%#:-"} for next delete, yank or put
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
931 (uppercase to append) ({.%#:} only work with put)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
932 |$| cursor to the end of Nth next line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
933 |%| find the next (curly/square) bracket on this line and go to
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
934 its match, or go to matching comment bracket, or go to
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
935 matching preprocessor directive (Vi: no count supported)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
936 |&| repeat last :s
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
937 |'| jump to mark (Vi: only lowercase marks)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
938 |(| cursor N sentences backward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
939 |)| cursor N sentences forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
940 |+| same as <CR>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
941 |,| repeat latest f, t, F or T in opposite direction N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
942 |-| cursor to the first CHAR N lines higher
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
943 |.| repeat last change with count replaced with N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
944 |/| search forward for the Nth occurrence of {pattern}
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
945 |0| cursor to the first char of the line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
946 |:| start entering an Ex command
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
947 |;| repeat latest f, t, F or T N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
948 |<| shift Nmove lines one 'shiftwidth' leftwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
949 |<<| shift N lines one 'shiftwidth' leftwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
950 |=| filter Nmove lines through "indent"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
951 |==| filter N lines through "indent"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
952 |>| shift Nmove lines one 'shiftwidth' rightwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
953 |>>| shift N lines one 'shiftwidth' rightwards
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
954 |?| search backward for the Nth previous occurrence of {pattern}
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
955 |@| execute the contents of register {a-z} N times
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
956 {Vi: only named registers}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
957 |@@| repeat the previous @{a-z} N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
958 |A| append text after the end of the line N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
959 |B| cursor N WORDS backward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
960 |C| change from the cursor position to the end of the line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
961 |D| delete the characters under the cursor until the end of the
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
962 line and N-1 more lines [into register x]; synonym for "d$"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
963 |E| cursor forward to the end of WORD N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
964 |F| cursor to the Nth occurrence of {char} to the left
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
965 |G| cursor to line N, default last line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
966 |H| cursor to line N from top of screen
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
967 |I| insert text before the first CHAR on the line N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
968 |J| Join N lines; default is 2
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
969 |L| cursor to line N from bottom of screen
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
970 |M| cursor to middle line of screen
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
971 |N| repeat the latest '/' or '?' N times in opposite direction
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
972 |O| begin a new line above the cursor and insert text, repeat N
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
973 times {Vi: blank [count] screen lines}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
974 |P| put the text [from register x] before the cursor N times
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
975 {Vi: no count}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
976 |Q| switch to "Ex" mode
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
977 |R| enter replace mode: overtype existing characters, repeat the
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
978 entered text N-1 times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
979 |S| delete N lines [into register x] and start insert; synonym for
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
980 "cc".
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
981 |T| cursor till after Nth occurrence of {char} to the left
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
982 |U| undo all latest changes on one line
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
983 {Vi: while not moved off of the last modified line}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
984 |W| cursor N WORDS forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
985 |X| delete N characters before the cursor [into register x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
986 |Y| yank N lines [into register x]; synonym for "yy"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
987 |ZZ| store current file if modified, and exit
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
988 |[[| cursor N sections backward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
989 |]]| cursor N sections forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
990 |^| cursor to the first CHAR of the line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
991 |_| cursor to the first CHAR N - 1 lines lower
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
992 |`| cursor to the mark {a-zA-Z0-9}
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
993 |a| append text after the cursor N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
994 |b| cursor N words backward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
995 |c| delete Nmove text [into register x] and start insert
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
996 |cc| delete N lines [into register x] and start insert
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
997 |d| delete Nmove text [into register x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
998 |dd| delete N lines [into register x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
999 |e| cursor forward to the end of word N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1000 |f| cursor to Nth occurrence of {char} to the right
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1001 |h| cursor N chars to the left
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1002 |i| insert text before the cursor N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1003 |j| cursor N lines downward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1004 |k| cursor N lines upward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1005 |l| cursor N chars to the right
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1006 |m| set mark {A-Za-z} at cursor position
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1007 |n| repeat the latest '/' or '?' N times
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1008 |o| begin a new line below the cursor and insert text
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1009 {Vi: blank [count] screen lines}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1010 |p| put the text [from register x] after the cursor N times
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1011 {Vi: no count}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1012 |r| replace N chars with {char} {Vi: CTRL-V <CR> still replaces
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1013 with a line break, cannot replace something with a <CR>}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1014 |s| (substitute) delete N characters [into register x] and start
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1015 insert
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1016 |t| cursor till before Nth occurrence of {char} to the right
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1017 |u| undo changes {Vi: only one level}
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1018 |w| cursor N words forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1019 |x| delete N characters under and after the cursor [into register
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1020 x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1021 |y| yank Nmove text [into register x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1022 |yy| yank N lines [into register x]
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1023 |z<CR>| current line to the top
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1024 |z-| current line to the bottom
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1025 |z+| cursor on line N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1026 |z^| cursor on line N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1027 |{| cursor N paragraphs backward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1028 | cursor to column N
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1029 |}| cursor N paragraphs forward
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1030 |~| switch case of N characters under the cursor; Vim: depends on
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1031 'tildeop' {Vi: no count, no 'tildeop'}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1032 |<Del>| same as "x"
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1033
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1034
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1035 The following commands are supported in Insert mode by Vi: ~
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1036
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1037 CTRL-@ insert previously inserted text and stop insert
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1038 {Vi: only when typed as first char, only up to 128 chars}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1039 CTRL-C quit insert mode, without checking for abbreviation, unless
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1040 'insertmode' set.
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1041 CTRL-D delete one shiftwidth of indent in the current line
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1042 {Vi: CTRL-D works only when used after autoindent}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1043 <BS> delete character before the cursor {Vi: does not delete
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1044 autoindents, does not cross lines, does not delete past start
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1045 position of insert}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1046 CTRL-H same as <BS>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1047 <Tab> insert a <Tab> character
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1048 CTRL-I same as <Tab>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1049 <NL> same as <CR>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1050 CTRL-J same as <CR>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1051 <CR> begin new line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1052 CTRL-M same as <CR>
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1053 CTRL-T insert one shiftwidth of indent in current line {Vi: only when
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1054 in indent}
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1055 CTRL-V {char} insert next non-digit literally {Vi: no decimal byte entry}
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1056 CTRL-W delete word before the cursor
16808
c002c4899529 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 16610
diff changeset
1057 CTRL-Z when 'insertmode' set: suspend Vi
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1058 <Esc> end insert mode (unless 'insertmode' set)
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1059 CTRL-[ same as <Esc>
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1060 0 CTRL-D delete all indent in the current line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1061 ^ CTRL-D delete all indent in the current line, restore it in the next
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1062 line
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1063 <Del> delete character under the cursor
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1064
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1065
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1066 The following options are supported by Vi: ~
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1067
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1068 'autoindent' 'ai' take indent for new line from previous line
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1069 {Vi does this slightly differently: After the
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1070 indent is deleted when typing <Esc> or <CR>, the
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1071 cursor position when moving up or down is after
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1072 the deleted indent; Vi puts the cursor somewhere
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1073 in the deleted indent}.
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1074 'autowrite' 'aw' automatically write file if changed
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1075 'directory' 'dir' list of directory names for the swap file
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1076 {Vi: directory to put temp file in, defaults to
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1077 "/tmp"}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1078 'edcompatible' 'ed' toggle flags of ":substitute" command
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1079 'errorbells' 'eb' ring the bell for error messages
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1080 'ignorecase' 'ic' ignore case in search patterns
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1081 'lines' number of lines in the display
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1082 'lisp' automatic indenting for Lisp {Vi: Does it a little
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1083 bit differently}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1084 'list' show <Tab> and <EOL>
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1085 'magic' changes special characters in search patterns
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1086 'modeline' 'ml' recognize 'modelines' at start or end of file
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1087 {called modelines in some Vi versions}
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1088 'number' 'nu' print the line number in front of each line
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1089 'paragraphs' 'para' nroff macros that separate paragraphs
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1090 'prompt' 'prompt' enable prompt in Ex mode
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1091 'readonly' 'ro' disallow writing the buffer {Vim sets 'readonly'
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1092 when editing a file with `:view`}
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1093 'remap' allow mappings to work recursively
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1094 'report' threshold for reporting nr. of lines changed
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1095 'scroll' 'scr' lines to scroll with CTRL-U and CTRL-D
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1096 'sections' 'sect' nroff macros that separate sections
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1097 'shell' 'sh' name of shell to use for external commands
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1098 'shiftwidth' 'sw' number of spaces to use for (auto)indent step
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1099 'showmatch' 'sm' briefly jump to matching bracket if insert one
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1100 'showmode' 'smd' message on status line to show current mode
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1101 'tabstop' 'ts' number of spaces that <Tab> in file uses
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1102 'taglength' 'tl' number of significant characters for a tag
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1103 'tags' 'tag' list of file names used by the tag command
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1104 {Vi: default is "tags /usr/lib/tags"}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1105 'tagstack' 'tgst' push tags onto the tag stack {not in all versions
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1106 of Vi}
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1107 'term' name of the terminal
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1108 'terse' shorten some messages
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1109 'timeout' 'to' time out on mappings and key codes
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1110 'timeoutlen' 'tm' time for 'timeout' {only in some Vi versions}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1111 'ttytype' 'tty' alias for 'term'
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1112 'verbose' 'vbs' give informative messages {only in some Vi
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1113 versions as a boolean option}
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1114 'warn' warn for shell command when buffer was changed
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1115 'window' 'wi' nr of lines to scroll for CTRL-F and CTRL-B
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1116 {Vi also uses the option to specify the number of
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1117 displayed lines}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1118 'wrapmargin' 'wm' chars from the right where wrapping starts
16610
1eaf34420bb3 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 16553
diff changeset
1119 {Vi: works differently and less usefully}
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1120 'wrapscan' 'ws' searches wrap around the end of the file
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1121 'writeany' 'wa' write to file with no need for "!" override
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1122
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1123 Also see |missing-options|.
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1124
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1125 ==============================================================================
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1126 7. Command-line arguments *cmdline-arguments*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1127
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1128 Different versions of Vi have different command-line arguments. This can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1129 confusing. To help you, this section gives an overview of the differences.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1131 Five variants of Vi will be considered here:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1132 Elvis Elvis version 2.1b
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1133 Nvi Nvi version 1.79
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1134 Posix Posix 1003.2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1135 Vi Vi version 3.7 (for Sun 4.1.x)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1136 Vile Vile version 7.4 (incomplete)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1137 Vim Vim version 5.2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1138
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1139 Only Vim is able to accept options in between and after the file names.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1140
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1141 +{command} Elvis, Nvi, Posix, Vi, Vim: Same as "-c {command}".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1142
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1143 - Nvi, Posix, Vi: Run Ex in batch mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1144 Vim: Read file from stdin (use -s for batch mode).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1145
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1146 -- Vim: End of options, only file names are following.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1147
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1148 --cmd {command} Vim: execute {command} before sourcing vimrc files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1149
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1150 --echo-wid Vim: GTK+ echoes the Window ID on stdout
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1151
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1152 --help Vim: show help message and exit.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1153
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1154 --literal Vim: take file names literally, don't expand wildcards.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1155
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1156 --nofork Vim: same as |-f|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1157
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1158 --noplugin[s] Vim: Skip loading plugins.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1159
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1160 --remote Vim: edit the files in another Vim server
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1161
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1162 --remote-expr {expr} Vim: evaluate {expr} in another Vim server
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1163
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1164 --remote-send {keys} Vim: send {keys} to a Vim server and exit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1165
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1166 --remote-silent {file} Vim: edit the files in another Vim server if possible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1167
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1168 --remote-wait Vim: edit the files in another Vim server and wait for it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1169
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1170 --remote-wait-silent Vim: like --remote-wait, no complaints if not possible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1171
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1172 --role {role} Vim: GTK+ 2: set role of main window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1173
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1174 --serverlist Vim: Output a list of Vim servers and exit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1175
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1176 --servername {name} Vim: Specify Vim server name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1177
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1178 --socketid {id} Vim: GTK window socket to run Vim in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1179
1376
53b2bedccfdf updated for version 7.1-091
vimboss
parents: 1231
diff changeset
1180 --windowid {id} Vim: Win32 window ID to run Vim in
53b2bedccfdf updated for version 7.1-091
vimboss
parents: 1231
diff changeset
1181
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1182 --version Vim: show version message and exit.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1183
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1184 -? Vile: print usage summary and exit.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1185
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1186 -a Elvis: Load all specified file names into a window (use -o for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1187 Vim).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1188
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1189 -A Vim: Start in Arabic mode (when compiled with Arabic).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1190
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1191 -b {blksize} Elvis: Use {blksize} blocksize for the session file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1192 -b Vim: set 'binary' mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1193
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1194 -C Vim: Compatible mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1195
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1196 -c {command} Elvis, Nvi, Posix, Vim: run {command} as an Ex command after
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1197 loading the edit buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1198 Vim: allow up to 10 "-c" arguments
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1199
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1200 -d {device} Vim: Use {device} for I/O (Amiga only). {only when compiled
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1201 without the |+diff| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1202 -d Vim: start with 'diff' set. |vimdiff|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1203
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1204 -dev {device} Vim: Use {device} for I/O (Amiga only).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1205
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1206 -D Vim: debug mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1207
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1208 -e Elvis, Nvi, Vim: Start in Ex mode, as if the executable is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1209 called "ex".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1210
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1211 -E Vim: Start in improved Ex mode |gQ|, like "exim".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1212
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1213 -f Vim: Run GUI in foreground (Amiga: don't open new window).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1214 -f {session} Elvis: Use {session} as the session file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1215
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1216 -F Vim: Start in Farsi mode (when compiled with Farsi).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1217 Nvi: Fast start, don't read the entire file when editing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1218 starts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1219
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1220 -G {gui} Elvis: Use the {gui} as user interface.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1221
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1222 -g Vim: Start GUI.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1223 -g N Vile: start editing at line N
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1224
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1225 -h Vim: Give help message.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1226 Vile: edit the help file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1227
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1228 -H Vim: start Hebrew mode (when compiled with it).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1229
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1230 -i Elvis: Start each window in Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1231 -i {viminfo} Vim: Use {viminfo} for viminfo file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1232
16553
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1233 -L Vim: Same as "-r" {only in some versions of Vi: "List
0e473e9e70c2 patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents: 16443
diff changeset
1234 recoverable edit sessions"}.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1235
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1236 -l Nvi, Vi, Vim: Set 'lisp' and 'showmatch' options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1237
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1238 -m Vim: Modifications not allowed to be written, resets 'write'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1239 option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1240
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1241 -M Vim: Modifications not allowed, resets 'modifiable' and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1242 'write' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1243
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1244 -N Vim: No-compatible mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1245
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1246 -n Vim: No swap file used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1247
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1248 -nb[args] Vim: open a NetBeans interface connection
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1249
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1250 -O[N] Vim: Like -o, but use vertically split windows.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1251
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1252 -o[N] Vim: Open [N] windows, or one for each file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1253
827
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
1254 -p[N] Vim: Open [N] tab pages, or one for each file.
fd1b3406fd1c updated for version 7.0d02
vimboss
parents: 825
diff changeset
1255
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1256 -P {parent-title} Win32 Vim: open Vim inside a parent application window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1257
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1258 -q {name} Vim: Use {name} for quickfix error file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1259 -q{name} Vim: Idem.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1260
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1261 -R Elvis, Nvi, Posix, Vile, Vim: Set the 'readonly' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1262
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1263 -r Elvis, Nvi, Posix, Vi, Vim: Recovery mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1264
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1265 -S Nvi: Set 'secure' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1266 -S {script} Vim: source script after starting up.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1267
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1268 -s Nvi, Posix, Vim: Same as "-" (silent mode), when in Ex mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1269 Elvis: Sets the 'safer' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1270 -s {scriptin} Vim: Read from script file {scriptin}; only when not in Ex
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1271 mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1272 -s {pattern} Vile: search for {pattern}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1273
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1274 -t {tag} Elvis, Nvi, Posix, Vi, Vim: Edit the file containing {tag}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1275 -t{tag} Vim: Idem.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1276
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1277 -T {term} Vim: Set terminal name to {term}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1278
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1279 -u {vimrc} Vim: Read initializations from {vimrc} file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1280
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1281 -U {gvimrc} Vim: Read GUI initializations from {gvimrc} file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1282
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1283 -v Nvi, Posix, Vi, Vim: Begin in Normal mode (visual mode, in Vi
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1284 terms).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1285 Vile: View mode, no changes possible.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1286
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1287 -V Elvis, Vim: Verbose mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1288 -V{nr} Vim: Verbose mode with specified level.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1289
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1290 -w {size} Elvis, Posix, Nvi, Vi, Vim: Set value of 'window' to {size}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1291 -w{size} Nvi, Vi: Same as "-w {size}".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1292 -w {name} Vim: Write to script file {name} (must start with non-digit).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1293
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1294 -W {name} Vim: Append to script file {name}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1295
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1296 -x Vi, Vim: Ask for encryption key. See |encryption|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1297
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1298 -X Vim: Don't connect to the X server.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1299
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1300 -y Vim: Start in easy mode, like |evim|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1301
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1302 -Z Vim: restricted mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1303
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1304 @{cmdfile} Vile: use {cmdfile} as startup file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1305
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1306 ==============================================================================
16443
32a543152dc0 patch 8.1.1226: {not in Vi} remarks get in the way of useful help text
Bram Moolenaar <Bram@vim.org>
parents: 14519
diff changeset
1307 8. POSIX compliance *posix* *posix-compliance*
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1308
1118
2b8ff9e3c520 updated for version 7.1a
vimboss
parents: 874
diff changeset
1309 In 2005 the POSIX test suite was run to check the compatibility of Vim. Most
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1310 of the test was executed properly. There are the few things where Vim
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1311 is not POSIX compliant, even when run in Vi compatibility mode.
8061
abd64cf67bcf commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents: 7228
diff changeset
1312 *$VIM_POSIX*
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1313 Set the $VIM_POSIX environment variable to have 'cpoptions' include the POSIX
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1314 flags when Vim starts up. This makes Vim run as POSIX as it can. That's
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1315 a bit different from being Vi compatible.
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1316
18615
c4cdc715cb68 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
1317 You can find the Posix specification for Vi here:
c4cdc715cb68 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
1318 https://pubs.opengroup.org/onlinepubs/9699919799/utilities/vi.html
c4cdc715cb68 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
1319 And the related Ex specification:
c4cdc715cb68 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
1320 https://pubs.opengroup.org/onlinepubs/9699919799/utilities/ex.html
c4cdc715cb68 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 18343
diff changeset
1321
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1322 This is where Vim does not behave as POSIX specifies and why:
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1323
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1324 *posix-screen-size*
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1325 The $COLUMNS and $LINES environment variables are ignored by Vim if
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1326 the size can be obtained from the terminal in a more reliable way.
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1327 Add the '|' flag to 'cpoptions' to have $COLUMNS and $LINES overrule
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1328 sizes obtained in another way.
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1329
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1330 The "{" and "}" commands don't stop at a "{" in the original Vi, but
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1331 POSIX specifies it does. Add the '{' flag to 'cpoptions' if you want
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1332 it the POSIX way.
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1333
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1334 The "D", "o" and "O" commands accept a count. Also when repeated.
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 160
diff changeset
1335 Add the '#' flag to 'cpoptions' if you want to ignore the count.
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1336
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1337 The ":cd" command fails if the current buffer is modified when the '.'
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1338 flag is present in 'cpoptions'.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1339
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1340 There is no ATTENTION message, the "A" flag is added to 'shortmess'.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1341
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1342 These are remarks about running the POSIX test suite:
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1343 - vi test 33 sometimes fails for unknown reasons
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1344 - vi test 250 fails; behavior will be changed in a new revision
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1345 http://www.opengroup.org/austin/mailarchives/ag-review/msg01710.html
2608
7d8af31066c8 Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
1346 (link no longer works, perhaps it's now:
7d8af31066c8 Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
1347 https://www.opengroup.org/sophocles/show_mail.tpl?CALLER=show_archive.tpl&source=L&listname=austin-review-l&id=1711)
166
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1348 - vi test 310 fails; exit code non-zero when any error occurred?
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1349 - ex test 24 fails because test is wrong. Changed between SUSv2 and SUSv3.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1350 - ex tests 47, 48, 49, 72, 73 fail because .exrc file isn't read in silent
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1351 mode and $EXINIT isn't used.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1352 - ex tests 76, 78 fail because echo is used instead of printf. (fixed)
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1353 Also: problem with \s not changed to space.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1354 - ex test 355 fails because 'window' isn't used for "30z".
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1355 - ex test 368 fails because shell command isn't echoed in silent mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1356 - ex test 394 fails because "=" command output isn't visible in silent mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1357 - ex test 411 fails because test file is wrong, contains stray ':'.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1358 - ex test 475 and 476 fail because reprint output isn't visible in silent mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1359 - ex test 480 and 481 fail because the tags file has spaces instead of a tab.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1360 - ex test 502 fails because .exrc isn't read in silent mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1361 - ex test 509 fails because .exrc isn't read in silent mode. and exit code is
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1362 1 instead of 2.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1363 - ex test 534 fails because .exrc isn't read in silent mode.
3a28ed993bbe updated for version 7.0051
vimboss
parents: 164
diff changeset
1364
160
7c0820eed232 updated for version 7.0049
vimboss
parents: 7
diff changeset
1365
14519
5c5908e81e93 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 13963
diff changeset
1366 vim:tw=78:ts=8:noet:ft=help:norl: