annotate runtime/doc/various.txt @ 9464:be72f4201a1d

commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa Author: Bram Moolenaar <Bram@vim.org> Date: Sat Jul 9 20:21:48 2016 +0200 Updated runtime files.
author Christian Brabandt <cb@256bit.org>
date Sat, 09 Jul 2016 20:30:06 +0200
parents 32e34e574716
children 35ce559b8553
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9464
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
1 *various.txt* For Vim version 7.4. Last change: 2016 Jul 09
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 Various commands *various*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 1. Various commands |various-cmds|
2246
1e48f569b03d Move text from various.txt to a new helphelp.txt help file.
Bram Moolenaar <bram@vim.org>
parents: 2214
diff changeset
10 2. Using Vim like less or more |less|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 1. Various commands *various-cmds*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 *CTRL-L*
348
7e819e81117e updated for version 7.0090
vimboss
parents: 305
diff changeset
16 CTRL-L Clear and redraw the screen. The redraw may happen
7e819e81117e updated for version 7.0090
vimboss
parents: 305
diff changeset
17 later, after processing typeahead.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 *:redr* *:redraw*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 :redr[aw][!] Redraw the screen right now. When ! is included it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 cleared first.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 Useful to update the screen halfway executing a script
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 or function. Also when halfway a mapping and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 'lazyredraw' is set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 *:redraws* *:redrawstatus*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 :redraws[tatus][!] Redraw the status line of the current window. When !
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 is included all status lines are redrawn.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Useful to update the status line(s) when 'statusline'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 includes an item that doesn't cause automatic
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 updating.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 *N<Del>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 <Del> When entering a number: Remove the last digit.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 Note: if you like to use <BS> for this, add this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 mapping to your .vimrc: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 :map CTRL-V <BS> CTRL-V <Del>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 < See |:fixdel| if your <Del> key does not do what you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 want.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 :as[cii] or *ga* *:as* *:ascii*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 ga Print the ascii value of the character under the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 cursor in decimal, hexadecimal and octal. For
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 example, when the cursor is on a 'R':
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 <R> 82, Hex 52, Octal 122 ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 When the character is a non-standard ASCII character,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 but printable according to the 'isprint' option, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 non-printable version is also given. When the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 character is larger than 127, the <M-x> form is also
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 printed. For example:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 <~A> <M-^A> 129, Hex 81, Octal 201 ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 <p> <|~> <M-~> 254, Hex fe, Octal 376 ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 (where <p> is a special character)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 The <Nul> character in a file is stored internally as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 <NL>, but it will be shown as:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 <^@> 0, Hex 00, Octal 000 ~
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 677
diff changeset
57 If the character has composing characters these are
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 677
diff changeset
58 also shown. The value of 'maxcombine' doesn't matter.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 Mnemonic: Get Ascii value. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 *g8*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 g8 Print the hex values of the bytes used in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 character under the cursor, assuming it is in |UTF-8|
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 677
diff changeset
64 encoding. This also shows composing characters. The
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 677
diff changeset
65 value of 'maxcombine' doesn't matter.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 677
diff changeset
66 Example of a character with two composing characters:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 e0 b8 81 + e0 b8 b9 + e0 b9 89 ~
777
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
68 {not in Vi} {only when compiled with the |+multi_byte|
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
69 feature}
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
70
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
71 *8g8*
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
72 8g8 Find an illegal UTF-8 byte sequence at or after the
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
73 cursor. This works in two situations:
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
74 1. when 'encoding' is any 8-bit encoding
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
75 2. when 'encoding' is "utf-8" and 'fileencoding' is
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
76 any 8-bit encoding
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
77 Thus it can be used when editing a file that was
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
78 supposed to be UTF-8 but was read as if it is an 8-bit
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
79 encoding because it contains illegal bytes.
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
80 Does not wrap around the end of the file.
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
81 Note that when the cursor is on an illegal byte or the
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
82 cursor is halfway a multi-byte character the command
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
83 won't move the cursor.
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
84 {not in Vi} {only when compiled with the |+multi_byte|
f664cc974a7a updated for version 7.0227
vimboss
parents: 714
diff changeset
85 feature}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86
843
9f279ebda751 updated for version 7.0f01
vimboss
parents: 842
diff changeset
87 *:p* *:pr* *:print* *E749*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
88 :[range]p[rint] [flags]
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
89 Print [range] lines (default current line).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 Note: If you are looking for a way to print your text
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
91 on paper see |:hardcopy|. In the GUI you can use the
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
92 File.Print menu entry.
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
93 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
95 :[range]p[rint] {count} [flags]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 Print {count} lines, starting with [range] (default
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 current line |cmdline-ranges|).
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
98 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 *:P* *:Print*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
101 :[range]P[rint] [count] [flags]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 Just as ":print". Was apparently added to Vi for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 people that keep the shift key pressed too long...
2642
840c3cadb842 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
104 Note: A user command can overrule this command.
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
105 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 *:l* *:list*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
108 :[range]l[ist] [count] [flags]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 Same as :print, but display unprintable characters
2458
22a6f99e6477 Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2413
diff changeset
110 with '^' and put $ after the line. This can be
2698
b6471224d2af Updated runtime files and translations.
Bram Moolenaar <bram@vim.org>
parents: 2642
diff changeset
111 further changed with the 'listchars' option.
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
112 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 *:nu* *:number*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
115 :[range]nu[mber] [count] [flags]
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 Same as :print, but precede each line with its line
677
e649c78407e6 updated for version 7.0202
vimboss
parents: 659
diff changeset
117 number. (See also 'highlight' and 'numberwidth'
e649c78407e6 updated for version 7.0202
vimboss
parents: 659
diff changeset
118 option).
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
119 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 *:#*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
122 :[range]# [count] [flags]
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
123 synonym for :number.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
125 *:#!*
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
126 :#!{anything} Ignored, so that you can start a Vim script with: >
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
127 #!vim -S
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
128 echo "this is a Vim script"
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
129 quit
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
130 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 *:z* *E144*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 :{range}z[+-^.=]{count} Display several lines of text surrounding the line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 specified with {range}, or around the current line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 if there is no {range}. If there is a {count}, that's
164
8b0ee9d57d7f updated for version 7.0050
vimboss
parents: 161
diff changeset
135 how many lines you'll see; if there is only one window
2725
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
136 then twice the value of the 'scroll' option is used,
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
137 otherwise the current window height minus 3 is used.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138
3237
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
139 If there is a {count} the 'window' option is set to
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
140 its value.
91e53bcb7946 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3224
diff changeset
141
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 :z can be used either alone or followed by any of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 several punctuation marks. These have the following
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144 effect:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145
2725
6f63330ec225 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2698
diff changeset
146 mark first line last line new cursor line ~
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 ---- ---------- --------- ------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 + current line 1 scr forward 1 scr forward
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 - 1 scr back current line current line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 ^ 2 scr back 1 scr back 1 scr back
159
389c8abd5925 updated for version 7.0048
vimboss
parents: 140
diff changeset
151 . 1/2 scr back 1/2 scr fwd 1/2 scr fwd
389c8abd5925 updated for version 7.0048
vimboss
parents: 140
diff changeset
152 = 1/2 scr back 1/2 scr fwd current line
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 Specifying no mark at all is the same as "+".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 If the mark is "=", a line of dashes is printed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156 around the current line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 :{range}z#[+-^.=]{count} *:z#*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 Like ":z", but number the lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 {not in all versions of Vi, not with these arguments}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 *:=*
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
163 := [flags] Print the last line number.
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
164 See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
166 :{range}= [flags] Prints the last line number in {range}. For example,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 this prints the current line number: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 :.=
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
169 < See |ex-flags| for [flags].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 :norm[al][!] {commands} *:norm* *:normal*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 Execute Normal mode commands {commands}. This makes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 it possible to execute Normal mode commands typed on
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
174 the command-line. {commands} are executed like they
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2581
diff changeset
175 are typed. For undo all commands are undone together.
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
176 Execution stops when an error is encountered.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
177
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 If the [!] is given, mappings will not be used.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
179 Without it, when this command is called from a
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
180 non-remappable mapping (|:noremap|), the argument can
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
181 be mapped anyway.
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
182
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 {commands} should be a complete command. If
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 {commands} does not finish a command, the last one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 will be aborted as if <Esc> or <C-C> was typed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 This implies that an insert command must be completed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 (to start Insert mode, see |:startinsert|). A ":"
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 159
diff changeset
188 command must be completed as well. And you can't use
6df0106fc595 updated for version 7.0049
vimboss
parents: 159
diff changeset
189 "Q" or "gQ" to start Ex mode.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
190
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
191 The display is not updated while ":normal" is busy.
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
192
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1989
diff changeset
193 {commands} cannot start with a space. Put a count of
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1989
diff changeset
194 1 (one) before it, "1 " is one space.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
195
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 The 'insertmode' option is ignored for {commands}.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
197
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 This command cannot be followed by another command,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199 since any '|' is considered part of the command.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
200
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 This command can be used recursively, but the depth is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 limited by 'maxmapdepth'.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
203
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 An alternative is to use |:execute|, which uses an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 expression as argument. This allows the use of
2264
0256b9c93e87 Update help files.
Bram Moolenaar <bram@vim.org>
parents: 2250
diff changeset
206 printable characters to represent special characters.
4073
e362db8b2d7b Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3996
diff changeset
207
2264
0256b9c93e87 Update help files.
Bram Moolenaar <bram@vim.org>
parents: 2250
diff changeset
208 Example: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 :exe "normal \<c-w>\<c-w>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 < {not in Vi, of course}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 :{range}norm[al][!] {commands} *:normal-range*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 Execute Normal mode commands {commands} for each line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214 in the {range}. Before executing the {commands}, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 cursor is positioned in the first column of the range,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 for each line. Otherwise it's the same as the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 ":normal" command without a range.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 *:sh* *:shell* *E371*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 :sh[ell] This command starts a shell. When the shell exits
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 (after the "exit" command) you return to Vim. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 name for the shell command comes from 'shell' option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 *E360*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 Note: This doesn't work when Vim on the Amiga was
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 started in QuickFix mode from a compiler, because the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 compiler will have set stdin to a non-interactive
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 *:!cmd* *:!* *E34*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 :!{cmd} Execute {cmd} with the shell. See also the 'shell'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 and 'shelltype' option.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
233
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 Any '!' in {cmd} is replaced with the previous
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 external command (see also 'cpoptions'). But not when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 there is a backslash before the '!', then that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 backslash is removed. Example: ":!ls" followed by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 ":!echo ! \! \\!" executes "echo ls ! \!".
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
239
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
240 A '|' in {cmd} is passed to the shell, you cannot use
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
241 it to append a Vim command. See |:bar|.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
242
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
243 If {cmd} contains "%" it is expanded to the current
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
244 file name. Special characters are not escaped, use
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
245 quotes to avoid their special meaning: >
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
246 :!ls "%"
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
247 < If the file name contains a "$" single quotes might
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
248 work better (but a single quote causes trouble): >
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
249 :!ls '%'
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
250 < This should always work, but it's more typing: >
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
251 :exe "!ls " . shellescape(expand("%"))
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
252 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 A newline character ends {cmd}, what follows is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 interpreted as a following ":" command. However, if
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 there is a backslash before the newline it is removed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 and {cmd} continues. It doesn't matter how many
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 backslashes are before the newline, only one is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 removed.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
259
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 On Unix the command normally runs in a non-interactive
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 shell. If you want an interactive shell to be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262 (to use aliases) set 'shellcmdflag' to "-ic".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 For Win32 also see |:!start|.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
264
5908
32de51778c27 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5814
diff changeset
265 After the command has been executed, the timestamp and
32de51778c27 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5814
diff changeset
266 size of the current file is checked |timestamp|.
5814
755931e042e4 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5763
diff changeset
267
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268 Vim redraws the screen after the command is finished,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269 because it may have printed any text. This requires a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 hit-enter prompt, so that you can read any messages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 To avoid this use: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 :silent !{cmd}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 < The screen is not redrawn then, thus you have to use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 CTRL-L or ":redraw!" if the command did display
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 something.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 Also see |shell-window|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 *:!!*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 :!! Repeat last ":!{cmd}".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 *:ve* *:version*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 :ve[rsion] Print the version number of the editor. If the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 compiler used understands "__DATE__" the compilation
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 date is mentioned. Otherwise a fixed release-date is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 shown.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 The following lines contain information about which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 features were enabled when Vim was compiled. When
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 there is a preceding '+', the feature is included,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 when there is a '-' it is excluded. To change this,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 you have to edit feature.h and recompile Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 To check for this in an expression, see |has()|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 Here is an overview of the features.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 The first column shows the smallest version in which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 they are included:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 T tiny
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 S small
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 N normal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 B big
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 H huge
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 m manually enabled or depends on other features
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 (none) system dependent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 Thus if a feature is marked with "N", it is included
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 in the normal, big and huge versions of Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 *+feature-list*
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
306 *+acl* |ACL| support included
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 *+ARP* Amiga only: ARP support included
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308 B *+arabic* |Arabic| language support
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 N *+autocmd* |:autocmd|, automatic commands
191
2174ed5a186e updated for version 7.0057
vimboss
parents: 179
diff changeset
310 m *+balloon_eval* |balloon-eval| support. Included when compiling with
2174ed5a186e updated for version 7.0057
vimboss
parents: 179
diff changeset
311 supported GUI (Motif, GTK, GUI) and either
2174ed5a186e updated for version 7.0057
vimboss
parents: 179
diff changeset
312 Netbeans/Sun Workshop integration or |+eval| feature.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 N *+browse* |:browse| command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 N *+builtin_terms* some terminals builtin |builtin-terms|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 B *++builtin_terms* maximal terminals builtin |builtin-terms|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 N *+byte_offset* support for 'o' flag in 'statusline' option, "go"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 and ":goto" commands.
7790
ca19726d5e83 commit https://github.com/vim/vim/commit/298b440930ecece38d6ea0505a3e582dc817e79b
Christian Brabandt <cb@256bit.org>
parents: 7597
diff changeset
318 m *+channel* inter process communication |channel|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 N *+cindent* |'cindent'|, C indenting
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 N *+clientserver* Unix and Win32: Remote invocation |clientserver|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 *+clipboard* |clipboard| support
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 N *+cmdline_compl* command line completion |cmdline-completion|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323 N *+cmdline_hist* command line history |cmdline-history|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 N *+cmdline_info* |'showcmd'| and |'ruler'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325 N *+comments* |'comments'| support
2382
3a5ededa240a Add the 'c' flag to 'concealcursor'.
Bram Moolenaar <bram@vim.org>
parents: 2368
diff changeset
326 B *+conceal* "conceal" support, see |conceal| |:syn-conceal| etc.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327 N *+cryptv* encryption support |encryption|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 B *+cscope* |cscope| support
2250
1bac28a53fae Add the conceal patch from Vince Negri.
Bram Moolenaar <bram@vim.org>
parents: 2246
diff changeset
329 m *+cursorbind* |'cursorbind'| support
500
4772a5e3f9fa updated for version 7.0138
vimboss
parents: 484
diff changeset
330 m *+cursorshape* |termcap-cursor-shape| support
4772a5e3f9fa updated for version 7.0138
vimboss
parents: 484
diff changeset
331 m *+debug* Compiled for debugging.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 N *+dialog_gui* Support for |:confirm| with GUI dialog.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333 N *+dialog_con* Support for |:confirm| with console dialog.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 N *+dialog_con_gui* Support for |:confirm| with GUI and console dialog.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 N *+diff* |vimdiff| and 'diff'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 N *+digraphs* |digraphs| *E196*
6110
1bff71d20262 updated for version 7.4.393
Bram Moolenaar <bram@vim.org>
parents: 5929
diff changeset
337 m *+directx* Win32 GUI only: DirectX and |'renderoptions'|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 *+dnd* Support for DnD into the "~ register |quote_~|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339 B *+emacs_tags* |emacs-tags| files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 N *+eval* expression evaluation |eval.txt|
7876
93f747af7b58 commit https://github.com/vim/vim/commit/5e9b2fa9bb0e6061cf18457c173cd141a5dc9c92
Christian Brabandt <cb@256bit.org>
parents: 7790
diff changeset
341 N *+ex_extra* always on now, used to be for Vim's extra Ex commands
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
342 N *+extra_search* |'hlsearch'| and |'incsearch'| options.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343 B *+farsi* |farsi| language
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 N *+file_in_path* |gf|, |CTRL-W_f| and |<cfile>|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
345 N *+find_in_path* include file searches: |[I|, |:isearch|,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 |CTRL-W_CTRL-I|, |:checkpath|, etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 N *+folding* |folding|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 *+footer* |gui-footer|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 *+fork* Unix only: |fork| shell commands
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
350 *+float* Floating point support
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 N *+gettext* message translations |multi-lang|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 *+GUI_Athena* Unix only: Athena |GUI|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 *+GUI_neXtaw* Unix only: neXtaw |GUI|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 *+GUI_GTK* Unix only: GTK+ |GUI|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 *+GUI_Motif* Unix only: Motif |GUI|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 *+GUI_Photon* QNX only: Photon |GUI|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 m *+hangul_input* Hangul input support |hangul|
557
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
358 *+iconv* Compiled with the |iconv()| function
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
359 *+iconv/dyn* Likewise |iconv-dynamic| |/dyn|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 N *+insert_expand* |insert_expand| Insert mode completion
8061
abd64cf67bcf commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents: 7876
diff changeset
361 m *+job* starting and stopping jobs |job|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 N *+jumplist* |jumplist|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 B *+keymap* |'keymap'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364 B *+langmap* |'langmap'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365 N *+libcall* |libcall()|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
366 N *+linebreak* |'linebreak'|, |'breakat'| and |'showbreak'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 N *+lispindent* |'lisp'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
368 N *+listcmds* Vim commands for the list of buffers |buffer-hidden|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 and argument list |:argdelete|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370 N *+localmap* Support for mappings local to a buffer |:map-local|
2320
966a5609669e Added Lua interfae. (Luis Carvalho)
Bram Moolenaar <bram@vim.org>
parents: 2264
diff changeset
371 m *+lua* |Lua| interface
966a5609669e Added Lua interfae. (Luis Carvalho)
Bram Moolenaar <bram@vim.org>
parents: 2264
diff changeset
372 m *+lua/dyn* |Lua| interface |/dyn|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 N *+menu* |:menu|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374 N *+mksession* |:mksession|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 N *+modify_fname* |filename-modifiers|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 N *+mouse* Mouse handling |mouse-using|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 N *+mouseshape* |'mouseshape'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 B *+mouse_dec* Unix only: Dec terminal mouse handling |dec-mouse|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379 N *+mouse_gpm* Unix only: Linux console mouse handling |gpm-mouse|
5929
16d26051085a Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 5908
diff changeset
380 N *+mouse_jsbterm* JSB mouse handling |jsbterm-mouse|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 B *+mouse_netterm* Unix only: netterm mouse handling |netterm-mouse|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
382 N *+mouse_pterm* QNX only: pterm mouse handling |qnx-terminal|
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
383 N *+mouse_sysmouse* Unix only: *BSD console mouse handling |sysmouse|
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3281
diff changeset
384 B *+mouse_sgr* Unix only: sgr mouse handling |sgr-mouse|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
385 B *+mouse_urxvt* Unix only: urxvt mouse handling |urxvt-mouse|
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
386 N *+mouse_xterm* Unix only: xterm mouse handling |xterm-mouse|
4502
605c9ce57ec3 Updated runtime files, language files and translations.
Bram Moolenaar <bram@vim.org>
parents: 4073
diff changeset
387 N *+multi_byte* 16 and 32 bit characters |multibyte|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 *+multi_byte_ime* Win32 input method for multibyte chars |multibyte-ime|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
389 N *+multi_lang* non-English language support |multi-lang|
14
946da5994c01 updated for version 7.0006
vimboss
parents: 9
diff changeset
390 m *+mzscheme* Mzscheme interface |mzscheme|
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 557
diff changeset
391 m *+mzscheme/dyn* Mzscheme interface |mzscheme-dynamic| |/dyn|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 m *+netbeans_intg* |netbeans|
9389
32e34e574716 commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents: 9116
diff changeset
393 *+num64* 64-bit Number support |Number|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
394 m *+ole* Win32 GUI only: |ole-interface|
9076
9305a1251e51 commit https://github.com/vim/vim/commit/91c4937be15b0b743b6bc495df602c1abbff6b87
Christian Brabandt <cb@256bit.org>
parents: 9027
diff changeset
395 N *+packages* Loading |packages|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
396 N *+path_extra* Up/downwards search in 'path' and 'tags'
557
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
397 m *+perl* Perl interface |perl|
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
398 m *+perl/dyn* Perl interface |perl-dynamic| |/dyn|
2535
31e51111bd14 Runtime file updates. Fix tar plugin window split.
Bram Moolenaar <bram@vim.org>
parents: 2527
diff changeset
399 N *+persistent_undo* Persistent undo |undo-persistence|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
400 *+postscript* |:hardcopy| writes a PostScript file
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 N *+printer* |:hardcopy| command
179
7fd70926e2e1 updated for version 7.0055
vimboss
parents: 169
diff changeset
402 H *+profile* |:profile| command
2368
9973354ee964 Small docs fixes.
Bram Moolenaar <bram@vim.org>
parents: 2365
diff changeset
403 m *+python* Python 2 interface |python|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
404 m *+python/dyn* Python 2 interface |python-dynamic| |/dyn|
2368
9973354ee964 Small docs fixes.
Bram Moolenaar <bram@vim.org>
parents: 2365
diff changeset
405 m *+python3* Python 3 interface |python|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
406 m *+python3/dyn* Python 3 interface |python-dynamic| |/dyn|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 N *+quickfix* |:make| and |quickfix| commands
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
408 N *+reltime* |reltime()| function, 'hlsearch'/'incsearch' timeout,
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
409 'redrawtime' option
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 B *+rightleft* Right to left typing |'rightleft'|
557
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
411 m *+ruby* Ruby interface |ruby|
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
412 m *+ruby/dyn* Ruby interface |ruby-dynamic| |/dyn|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
413 N *+scrollbind* |'scrollbind'|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 B *+signs* |:sign|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
415 N *+smartindent* |'smartindent'|
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
416 N *+startuptime* |--startuptime| argument
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
417 N *+statusline* Options 'statusline', 'rulerformat' and special
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 formats of 'titlestring' and 'iconstring'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419 m *+sun_workshop* |workshop|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 N *+syntax* Syntax highlighting |syntax|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 *+system()* Unix only: opposite of |+fork|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
422 N *+tag_binary* binary searching in tags file |tag-binary-search|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423 N *+tag_old_static* old method for static tags |tag-old-static|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424 m *+tag_any_white* any white space allowed in tags file |tag-any-white|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
425 m *+tcl* Tcl interface |tcl|
557
862863033fdd updated for version 7.0158
vimboss
parents: 502
diff changeset
426 m *+tcl/dyn* Tcl interface |tcl-dynamic| |/dyn|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 *+terminfo* uses |terminfo| instead of termcap
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 N *+termresponse* support for |t_RV| and |v:termresponse|
9027
773d627cac0b commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents: 8969
diff changeset
429 B *+termguicolors* 24-bit color in xterm-compatible terminals support
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
430 N *+textobjects* |text-objects| selection
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 *+tgetent* non-Unix only: able to use external termcap
8673
ed7251c3e2d3 commit https://github.com/vim/vim/commit/e18c0b39815c5a746887a509c2cd9f11fadaba07
Christian Brabandt <cb@256bit.org>
parents: 8303
diff changeset
432 N *+timers* the |timer_start()| function
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
433 N *+title* Setting the window 'title' and 'icon'
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 N *+toolbar* |gui-toolbar|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 N *+user_commands* User-defined commands. |user-commands|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 N *+viminfo* |'viminfo'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 N *+vertsplit* Vertically split windows |:vsplit|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
438 N *+virtualedit* |'virtualedit'|
5763
c52a655d927d Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5340
diff changeset
439 S *+visual* Visual mode |Visual-mode| Always enabled since 7.4.200.
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
440 N *+visualextra* extra Visual mode commands |blockwise-operators|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 N *+vreplace* |gR| and |gr|
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
442 N *+wildignore* |'wildignore'|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 N *+wildmenu* |'wildmenu'|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 S *+windows* more than one window
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
445 m *+writebackup* |'writebackup'| is default on
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
446 m *+xim* X input method |xim|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447 *+xfontset* X fontset support |xfontset|
5340
22da5ab9aaa1 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 5294
diff changeset
448 *+xpm* pixmap support
3750
536aa8b0c934 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3281
diff changeset
449 m *+xpm_w32* Win32 GUI only: pixmap support |w32-xpm-support|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
450 *+xsmp* XSMP (X session management) support
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451 *+xsmp_interact* interactive XSMP (X session management) support
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
452 N *+xterm_clipboard* Unix only: xterm clipboard handling
3996
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
453 m *+xterm_save* save and restore xterm screen |xterm-screens|
b3f3237a3d72 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3750
diff changeset
454 N *+X11* Unix only: can restore window title |X11|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
455
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
456 */dyn* *E370* *E448*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
457 To some of the features "/dyn" is added when the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
458 feature is only available when the related library can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
459 be dynamically loaded.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
460
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
461 :ve[rsion] {nr} Is now ignored. This was previously used to check the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
462 version number of a .vimrc file. It was removed,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
463 because you can now use the ":if" command for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
464 version-dependent behavior. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
465
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 *:redi* *:redir*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
467 :redi[r][!] > {file} Redirect messages to file {file}. The messages which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 are the output of commands are written to that file,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469 until redirection ends. The messages are also still
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
470 shown on the screen. When [!] is included, an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 existing file is overwritten. When [!] is omitted,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472 and {file} exists, this command fails.
9464
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
473
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474 Only one ":redir" can be active at a time. Calls to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475 ":redir" will close any active redirection before
9464
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
476 starting redirection to the new target. For recursive
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
477 use check out |execute()|.
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
478
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
479 To stop the messages and commands from being echoed to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480 the screen, put the commands in a function and call it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 with ":silent call Function()".
294
1c1cbdc42f75 updated for version 7.0077
vimboss
parents: 271
diff changeset
482 An alternative is to use the 'verbosefile' option,
1c1cbdc42f75 updated for version 7.0077
vimboss
parents: 271
diff changeset
483 this can be used in combination with ":redir".
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
484 {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
485
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486 :redi[r] >> {file} Redirect messages to file {file}. Append if {file}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 already exists. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
489 :redi[r] @{a-zA-Z}
298
f9de3e679a04 updated for version 7.0078
vimboss
parents: 294
diff changeset
490 :redi[r] @{a-zA-Z}> Redirect messages to register {a-z}. Append to the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
491 contents of the register if its name is given
1624
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
492 uppercase {A-Z}. The ">" after the register name is
18ee39301b82 updated for version 7.2a
vimboss
parents: 1502
diff changeset
493 optional. {not in Vi}
271
8d34af900bae updated for version 7.0072
vimboss
parents: 237
diff changeset
494 :redi[r] @{a-z}>> Append messages to register {a-z}. {not in Vi}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
495
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
496 :redi[r] @*>
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
497 :redi[r] @+> Redirect messages to the selection or clipboard. For
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
498 backward compatibility, the ">" after the register
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
499 name can be omitted. See |quotestar| and |quoteplus|.
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
500 {not in Vi}
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
501 :redi[r] @*>>
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
502 :redi[r] @+>> Append messages to the selection or clipboard.
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
503 {not in Vi}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
504
298
f9de3e679a04 updated for version 7.0078
vimboss
parents: 294
diff changeset
505 :redi[r] @"> Redirect messages to the unnamed register. For
f9de3e679a04 updated for version 7.0078
vimboss
parents: 294
diff changeset
506 backward compatibility, the ">" after the register
f9de3e679a04 updated for version 7.0078
vimboss
parents: 294
diff changeset
507 name can be omitted. {not in Vi}
271
8d34af900bae updated for version 7.0072
vimboss
parents: 237
diff changeset
508 :redi[r] @">> Append messages to the unnamed register. {not in Vi}
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
509
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
510 :redi[r] => {var} Redirect messages to a variable. If the variable
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
511 doesn't exist, then it is created. If the variable
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
512 exists, then it is initialized to an empty string.
1125
96cd8222a819 updated for version 7.1a
vimboss
parents: 874
diff changeset
513 The variable will remain empty until redirection ends.
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
514 Only string variables can be used. After the
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
515 redirection starts, if the variable is removed or
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
516 locked or the variable type is changed, then further
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
517 command output messages will cause errors. {not in Vi}
9464
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
518 To get the output of one command the |execute()|
be72f4201a1d commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents: 9389
diff changeset
519 function can be used.
169
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
520
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
521 :redi[r] =>> {var} Append messages to an existing variable. Only string
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
522 variables can be used. {not in Vi}
0e902b8f511f updated for version 7.0051
vimboss
parents: 164
diff changeset
523
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
524 :redi[r] END End redirecting messages. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
525
8148
f5da459c5698 commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents: 8061
diff changeset
526 *:sil* *:silent* *:silent!*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
527 :sil[ent][!] {command} Execute {command} silently. Normal messages will not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
528 be given or added to the message history.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
529 When [!] is added, error messages will also be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
530 skipped, and commands and mappings will not be aborted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
531 when an error is detected. |v:errmsg| is still set.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
532 When [!] is not used, an error message will cause
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
533 further messages to be displayed normally.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
534 Redirection, started with |:redir|, will continue as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
535 usual, although there might be small differences.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
536 This will allow redirecting the output of a command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
537 without seeing it on the screen. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
538 :redir >/tmp/foobar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
539 :silent g/Aap/p
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
540 :redir END
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
541 < To execute a Normal mode command silently, use the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
542 |:normal| command. For example, to search for a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
543 string without messages: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
544 :silent exe "normal /path\<CR>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
545 < ":silent!" is useful to execute a command that may
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
546 fail, but the failure is to be ignored. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
547 :let v:errmsg = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
548 :silent! /^begin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
549 :if v:errmsg != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
550 : ... pattern was not found
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
551 < ":silent" will also avoid the hit-enter prompt. When
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
552 using this for an external command, this may cause the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
553 screen to be messed up. Use |CTRL-L| to clean it up
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
554 then.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
555 ":silent menu ..." defines a menu that will not echo a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
556 Command-line command. The command will still produce
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
557 messages though. Use ":silent" in the command itself
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
558 to avoid that: ":silent menu .... :silent command".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
559
1926
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
560 *:uns* *:unsilent*
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
561 :uns[ilent] {command} Execute {command} not silently. Only makes a
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
562 difference when |:silent| was used to get to this
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
563 command.
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
564 Use this for giving a message even when |:silent| was
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
565 used. In this example |:silent| is used to avoid the
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
566 message about reading the file and |:unsilent| to be
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
567 able to list the first line of each file. >
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
568 :silent argdo unsilent echo expand('%') . ": " . getline(1)
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
569 <
43d337097e4c updated for version 7.2-223
vimboss
parents: 1702
diff changeset
570
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
571 *:verb* *:verbose*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
572 :[count]verb[ose] {command}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
573 Execute {command} with 'verbose' set to [count]. If
8
7edf9b6e4c36 Various changes
vimboss
parents: 7
diff changeset
574 [count] is omitted one is used. ":0verbose" can be
7edf9b6e4c36 Various changes
vimboss
parents: 7
diff changeset
575 used to set 'verbose' to zero.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
576 The additional use of ":silent" makes messages
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
577 generated but not displayed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
578 The combination of ":silent" and ":verbose" can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
579 used to generate messages and check them with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
580 |v:statusmsg| and friends. For example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
581 :let v:statusmsg = ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
582 :silent verbose runtime foobar.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
583 :if v:statusmsg != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
584 : " foobar.vim could not be found
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
585 :endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
586 < When concatenating another command, the ":verbose"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
587 only applies to the first one: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
588 :4verbose set verbose | set verbose
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
589 < verbose=4 ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
590 verbose=0 ~
294
1c1cbdc42f75 updated for version 7.0077
vimboss
parents: 271
diff changeset
591 For logging verbose messages in a file use the
1c1cbdc42f75 updated for version 7.0077
vimboss
parents: 271
diff changeset
592 'verbosefile' option.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
593
484
f012c4ed8c38 updated for version 7.0132
vimboss
parents: 348
diff changeset
594 *:verbose-cmd*
f012c4ed8c38 updated for version 7.0132
vimboss
parents: 348
diff changeset
595 When 'verbose' is non-zero, listing the value of a Vim option or a key map or
502
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 500
diff changeset
596 an abbreviation or a user-defined function or a command or a highlight group
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 500
diff changeset
597 or an autocommand will also display where it was last defined. If it was
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 500
diff changeset
598 defined manually then there will be no "Last set" message. When it was
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 500
diff changeset
599 defined while executing a function, user command or autocommand, the script in
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 500
diff changeset
600 which it was defined is reported.
2570
71b56b4e7785 Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents: 2561
diff changeset
601 {not available when compiled without the |+eval| feature}
484
f012c4ed8c38 updated for version 7.0132
vimboss
parents: 348
diff changeset
602
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
603 *K*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
604 K Run a program to lookup the keyword under the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
605 cursor. The name of the program is given with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
606 'keywordprg' (kp) option (default is "man"). The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
607 keyword is formed of letters, numbers and the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
608 characters in 'iskeyword'. The keyword under or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
609 right of the cursor is used. The same can be done
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
610 with the command >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
611 :!{program} {keyword}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
612 < There is an example of a program to use in the tools
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
613 directory of Vim. It is called 'ref' and does a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
614 simple spelling check.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
615 Special cases:
9116
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
616 - If 'keywordprg' begins with ":" it is invoked as
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
617 a Vim Ex command with [count].
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
618 - If 'keywordprg' is empty, the ":help" command is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
619 used. It's a good idea to include more characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
620 in 'iskeyword' then, to be able to find more help.
9116
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
621 - When 'keywordprg' is equal to "man" or starts with
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
622 ":", a [count] before "K" is inserted after
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
623 keywordprg and before the keyword. For example,
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
624 using "2K" while the cursor is on "mkdir", results
bc38030aec7d commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents: 9076
diff changeset
625 in: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
626 !man 2 mkdir
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
627 < - When 'keywordprg' is equal to "man -s", a count
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
628 before "K" is inserted after the "-s". If there is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
629 no count, the "-s" is removed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
630 {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
631
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
632 *v_K*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
633 {Visual}K Like "K", but use the visually highlighted text for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
634 the keyword. Only works when the highlighted text is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
635 not more than one line. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
636
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
637 [N]gs *gs* *:sl* *:sleep*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
638 :[N]sl[eep] [N] [m] Do nothing for [N] seconds. When [m] is included,
237
73354c21f1e4 updated for version 7.0066
vimboss
parents: 191
diff changeset
639 sleep for [N] milliseconds. The count for "gs" always
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
640 uses seconds. The default is one second. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
641 :sleep "sleep for one second
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
642 :5sleep "sleep for five seconds
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
643 :sleep 100m "sleep for a hundred milliseconds
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
644 10gs "sleep for ten seconds
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
645 < Can be interrupted with CTRL-C (CTRL-Break on MS-DOS).
140
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 123
diff changeset
646 "gs" stands for "goto sleep".
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 123
diff changeset
647 While sleeping the cursor is positioned in the text,
8ecb0db93e9a updated for version 7.0045
vimboss
parents: 123
diff changeset
648 if at a visible position. {not in Vi}
3153
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
649 Also process the received netbeans messages. {only
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
650 available when compiled with the |+netbeans_intg|
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
651 feature}
37ecb8ff4560 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2908
diff changeset
652
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
653
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
654 *g_CTRL-A*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
655 g CTRL-A Only when Vim was compiled with MEM_PROFILING defined
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
656 (which is very rare): print memory usage statistics.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
657 Only useful for debugging Vim.
7597
3012eaddb6b2 commit https://github.com/vim/vim/commit/345efa013dc6d1754ba06e5596a26c48c9935937
Christian Brabandt <cb@256bit.org>
parents: 7245
diff changeset
658 For incrementing in Visual mode see |v_g_CTRL-A|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
659
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
660 ==============================================================================
2581
e8a482a7fa6c Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
661 2. Using Vim like less or more *less*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
662
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
663 If you use the less or more program to view a file, you don't get syntax
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
664 highlighting. Thus you would like to use Vim instead. You can do this by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
665 using the shell script "$VIMRUNTIME/macros/less.sh".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
666
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
667 This shell script uses the Vim script "$VIMRUNTIME/macros/less.vim". It sets
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
668 up mappings to simulate the commands that less supports. Otherwise, you can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
669 still use the Vim commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
670
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
671 This isn't perfect. For example, when viewing a short file Vim will still use
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
672 the whole screen. But it works good enough for most uses, and you get syntax
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
673 highlighting.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
674
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
675 The "h" key will give you a short overview of the available commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
676
7245
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
677 If you want to set options differently when using less, define the
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
678 LessInitFunc in your vimrc, for example: >
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
679
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
680 func LessInitFunc()
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
681 set nocursorcolumn nocursorline
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
682 endfunc
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
683 <
8896150aba23 commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents: 6153
diff changeset
684
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
685 vim:tw=78:ts=8:ft=help:norl: