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