blob: eed7d9c4c7a6e9950a85b9d5daa23f1683a9ff71 [file] [log] [blame]
Bram Moolenaarfff2bee2010-05-15 13:56:02 +02001*various.txt* For Vim version 7.3a. Last change: 2010 May 13
Bram Moolenaar071d4272004-06-13 20:20:40 +00002
3
4 VIM REFERENCE MANUAL by Bram Moolenaar
5
6
7Various commands *various*
8
91. Various commands |various-cmds|
Bram Moolenaar91604412010-06-03 20:25:18 +0200102. Using Vim like less or more |less|
Bram Moolenaar071d4272004-06-13 20:20:40 +000011
12==============================================================================
131. Various commands *various-cmds*
14
15 *CTRL-L*
Bram Moolenaar30abd282005-06-22 22:35:10 +000016CTRL-L Clear and redraw the screen. The redraw may happen
17 later, after processing typeahead.
Bram Moolenaar071d4272004-06-13 20:20:40 +000018
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*
42ga 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 ~
Bram Moolenaar362e1a32006-03-06 23:29:24 +000057 If the character has composing characters these are
58 also shown. The value of 'maxcombine' doesn't matter.
Bram Moolenaar071d4272004-06-13 20:20:40 +000059 Mnemonic: Get Ascii value. {not in Vi}
60
61 *g8*
62g8 Print the hex values of the bytes used in the
63 character under the cursor, assuming it is in |UTF-8|
Bram Moolenaar362e1a32006-03-06 23:29:24 +000064 encoding. This also shows composing characters. The
65 value of 'maxcombine' doesn't matter.
66 Example of a character with two composing characters:
Bram Moolenaar071d4272004-06-13 20:20:40 +000067 e0 b8 81 + e0 b8 b9 + e0 b9 89 ~
Bram Moolenaarca003e12006-03-17 23:19:38 +000068 {not in Vi} {only when compiled with the |+multi_byte|
69 feature}
70
71 *8g8*
728g8 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}
Bram Moolenaar071d4272004-06-13 20:20:40 +000086
Bram Moolenaar551dbcc2006-04-25 22:13:59 +000087 *:p* *:pr* *:print* *E749*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +000088:[range]p[rint] [flags]
89 Print [range] lines (default current line).
Bram Moolenaar071d4272004-06-13 20:20:40 +000090 Note: If you are looking for a way to print your text
Bram Moolenaar5313dcb2005-02-22 08:56:13 +000091 on paper see |:hardcopy|. In the GUI you can use the
92 File.Print menu entry.
93 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +000094
Bram Moolenaar5313dcb2005-02-22 08:56:13 +000095:[range]p[rint] {count} [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +000096 Print {count} lines, starting with [range] (default
97 current line |cmdline-ranges|).
Bram Moolenaar5313dcb2005-02-22 08:56:13 +000098 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +000099
100 *:P* *:Print*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000101:[range]P[rint] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000102 Just as ":print". Was apparently added to Vi for
103 people that keep the shift key pressed too long...
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000104 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000105
106 *:l* *:list*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000107:[range]l[ist] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000108 Same as :print, but display unprintable characters
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000109 with '^' and put $ after the line.
110 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000111
112 *:nu* *:number*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000113:[range]nu[mber] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000114 Same as :print, but precede each line with its line
Bram Moolenaarfaa959a2006-02-20 21:37:40 +0000115 number. (See also 'highlight' and 'numberwidth'
116 option).
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000117 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000118
119 *:#*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000120:[range]# [count] [flags]
121 synonym for :number.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000122
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000123 *:#!*
124:#!{anything} Ignored, so that you can start a Vim script with: >
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000125 #!vim -S
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000126 echo "this is a Vim script"
127 quit
128<
Bram Moolenaar071d4272004-06-13 20:20:40 +0000129 *:z* *E144*
130:{range}z[+-^.=]{count} Display several lines of text surrounding the line
131 specified with {range}, or around the current line
132 if there is no {range}. If there is a {count}, that's
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000133 how many lines you'll see; if there is only one window
134 then the 'window' option is used, otherwise the
135 current window size is used.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000136
137 :z can be used either alone or followed by any of
138 several punctuation marks. These have the following
139 effect:
140
141 mark first line last line new location ~
142 ---- ---------- --------- ------------
143 + current line 1 scr forward 1 scr forward
144 - 1 scr back current line current line
145 ^ 2 scr back 1 scr back 1 scr back
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000146 . 1/2 scr back 1/2 scr fwd 1/2 scr fwd
147 = 1/2 scr back 1/2 scr fwd current line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000148
149 Specifying no mark at all is the same as "+".
150 If the mark is "=", a line of dashes is printed
151 around the current line.
152
153:{range}z#[+-^.=]{count} *:z#*
154 Like ":z", but number the lines.
155 {not in all versions of Vi, not with these arguments}
156
157 *:=*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000158:= [flags] Print the last line number.
159 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000160
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000161:{range}= [flags] Prints the last line number in {range}. For example,
Bram Moolenaar071d4272004-06-13 20:20:40 +0000162 this prints the current line number: >
163 :.=
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000164< See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000165
166:norm[al][!] {commands} *:norm* *:normal*
167 Execute Normal mode commands {commands}. This makes
168 it possible to execute Normal mode commands typed on
169 the command-line. {commands} is executed like it is
170 typed. For undo all commands are undone together.
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000171 Execution stops when an error is encountered.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000172 If the [!] is given, mappings will not be used.
173 {commands} should be a complete command. If
174 {commands} does not finish a command, the last one
175 will be aborted as if <Esc> or <C-C> was typed.
176 The display isn't updated while ":normal" is busy.
177 This implies that an insert command must be completed
178 (to start Insert mode, see |:startinsert|). A ":"
Bram Moolenaar7c626922005-02-07 22:01:03 +0000179 command must be completed as well. And you can't use
180 "Q" or "gQ" to start Ex mode.
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100181 {commands} cannot start with a space. Put a count of
182 1 (one) before it, "1 " is one space.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000183 The 'insertmode' option is ignored for {commands}.
184 This command cannot be followed by another command,
185 since any '|' is considered part of the command.
186 This command can be used recursively, but the depth is
187 limited by 'maxmapdepth'.
188 When this command is called from a non-remappable
189 mapping |:noremap|, the argument can be mapped anyway.
190 An alternative is to use |:execute|, which uses an
191 expression as argument. This allows the use of
Bram Moolenaar46f9d492010-06-12 20:18:19 +0200192 printable characters to represent special characters.
193 Example: >
Bram Moolenaar071d4272004-06-13 20:20:40 +0000194 :exe "normal \<c-w>\<c-w>"
195< {not in Vi, of course}
196 {not available when the |+ex_extra| feature was
197 disabled at compile time}
198
199:{range}norm[al][!] {commands} *:normal-range*
200 Execute Normal mode commands {commands} for each line
201 in the {range}. Before executing the {commands}, the
202 cursor is positioned in the first column of the range,
203 for each line. Otherwise it's the same as the
204 ":normal" command without a range.
205 {not in Vi}
206 Not available when |+ex_extra| feature was disabled at
207 compile time.
208
209 *:sh* *:shell* *E371*
210:sh[ell] This command starts a shell. When the shell exits
211 (after the "exit" command) you return to Vim. The
212 name for the shell command comes from 'shell' option.
213 *E360*
214 Note: This doesn't work when Vim on the Amiga was
215 started in QuickFix mode from a compiler, because the
216 compiler will have set stdin to a non-interactive
217 mode.
218
219 *:!cmd* *:!* *E34*
220:!{cmd} Execute {cmd} with the shell. See also the 'shell'
221 and 'shelltype' option.
222 Any '!' in {cmd} is replaced with the previous
223 external command (see also 'cpoptions'). But not when
224 there is a backslash before the '!', then that
225 backslash is removed. Example: ":!ls" followed by
226 ":!echo ! \! \\!" executes "echo ls ! \!".
227 After the command has been executed, the timestamp of
228 the current file is checked |timestamp|.
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000229 A '|' in {cmd} is passed to the shell, you cannot use
230 it to append a Vim command. See |:bar|.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000231 A newline character ends {cmd}, what follows is
232 interpreted as a following ":" command. However, if
233 there is a backslash before the newline it is removed
234 and {cmd} continues. It doesn't matter how many
235 backslashes are before the newline, only one is
236 removed.
237 On Unix the command normally runs in a non-interactive
238 shell. If you want an interactive shell to be used
239 (to use aliases) set 'shellcmdflag' to "-ic".
240 For Win32 also see |:!start|.
241 Vim redraws the screen after the command is finished,
242 because it may have printed any text. This requires a
243 hit-enter prompt, so that you can read any messages.
244 To avoid this use: >
245 :silent !{cmd}
246< The screen is not redrawn then, thus you have to use
247 CTRL-L or ":redraw!" if the command did display
248 something.
249 Also see |shell-window|.
250
251 *:!!*
252:!! Repeat last ":!{cmd}".
253
254 *:ve* *:version*
255:ve[rsion] Print the version number of the editor. If the
256 compiler used understands "__DATE__" the compilation
257 date is mentioned. Otherwise a fixed release-date is
258 shown.
259 The following lines contain information about which
260 features were enabled when Vim was compiled. When
261 there is a preceding '+', the feature is included,
262 when there is a '-' it is excluded. To change this,
263 you have to edit feature.h and recompile Vim.
264 To check for this in an expression, see |has()|.
265 Here is an overview of the features.
266 The first column shows the smallest version in which
267 they are included:
268 T tiny
269 S small
270 N normal
271 B big
272 H huge
273 m manually enabled or depends on other features
274 (none) system dependent
275 Thus if a feature is marked with "N", it is included
276 in the normal, big and huge versions of Vim.
277
278 *+feature-list*
279 *+ARP* Amiga only: ARP support included
280B *+arabic* |Arabic| language support
281N *+autocmd* |:autocmd|, automatic commands
Bram Moolenaar4d34b432005-03-07 23:22:00 +0000282m *+balloon_eval* |balloon-eval| support. Included when compiling with
283 supported GUI (Motif, GTK, GUI) and either
284 Netbeans/Sun Workshop integration or |+eval| feature.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000285N *+browse* |:browse| command
286N *+builtin_terms* some terminals builtin |builtin-terms|
287B *++builtin_terms* maximal terminals builtin |builtin-terms|
288N *+byte_offset* support for 'o' flag in 'statusline' option, "go"
289 and ":goto" commands.
290N *+cindent* |'cindent'|, C indenting
291N *+clientserver* Unix and Win32: Remote invocation |clientserver|
292 *+clipboard* |clipboard| support
293N *+cmdline_compl* command line completion |cmdline-completion|
294N *+cmdline_hist* command line history |cmdline-history|
295N *+cmdline_info* |'showcmd'| and |'ruler'|
296N *+comments* |'comments'| support
Bram Moolenaar860cae12010-06-05 23:22:07 +0200297m *+conceal* "conceal" support, see ||conceal|| |:syn-conceal| etc.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000298N *+cryptv* encryption support |encryption|
299B *+cscope* |cscope| support
Bram Moolenaar860cae12010-06-05 23:22:07 +0200300m *+cursorbind* |'cursorbind'| support
Bram Moolenaarac6e65f2005-08-29 22:25:38 +0000301m *+cursorshape* |termcap-cursor-shape| support
302m *+debug* Compiled for debugging.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000303N *+dialog_gui* Support for |:confirm| with GUI dialog.
304N *+dialog_con* Support for |:confirm| with console dialog.
305N *+dialog_con_gui* Support for |:confirm| with GUI and console dialog.
306N *+diff* |vimdiff| and 'diff'
307N *+digraphs* |digraphs| *E196*
308 *+dnd* Support for DnD into the "~ register |quote_~|.
309B *+emacs_tags* |emacs-tags| files
310N *+eval* expression evaluation |eval.txt|
311N *+ex_extra* Vim's extra Ex commands: |:center|, |:left|,
312 |:normal|, |:retab| and |:right|
313N *+extra_search* |'hlsearch'| and |'incsearch'| options.
314B *+farsi* |farsi| language
315N *+file_in_path* |gf|, |CTRL-W_f| and |<cfile>|
316N *+find_in_path* include file searches: |[I|, |:isearch|,
317 |CTRL-W_CTRL-I|, |:checkpath|, etc.
318N *+folding* |folding|
319 *+footer* |gui-footer|
320 *+fork* Unix only: |fork| shell commands
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000321 *+float* Floating point support
Bram Moolenaar071d4272004-06-13 20:20:40 +0000322N *+gettext* message translations |multi-lang|
323 *+GUI_Athena* Unix only: Athena |GUI|
324 *+GUI_neXtaw* Unix only: neXtaw |GUI|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000325 *+GUI_GTK* Unix only: GTK+ |GUI|
326 *+GUI_Motif* Unix only: Motif |GUI|
327 *+GUI_Photon* QNX only: Photon |GUI|
328m *+hangul_input* Hangul input support |hangul|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000329 *+iconv* Compiled with the |iconv()| function
330 *+iconv/dyn* Likewise |iconv-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000331N *+insert_expand* |insert_expand| Insert mode completion
332N *+jumplist* |jumplist|
333B *+keymap* |'keymap'|
334B *+langmap* |'langmap'|
335N *+libcall* |libcall()|
336N *+linebreak* |'linebreak'|, |'breakat'| and |'showbreak'|
337N *+lispindent* |'lisp'|
338N *+listcmds* Vim commands for the list of buffers |buffer-hidden|
339 and argument list |:argdelete|
340N *+localmap* Support for mappings local to a buffer |:map-local|
341N *+menu* |:menu|
342N *+mksession* |:mksession|
343N *+modify_fname* |filename-modifiers|
344N *+mouse* Mouse handling |mouse-using|
345N *+mouseshape* |'mouseshape'|
346B *+mouse_dec* Unix only: Dec terminal mouse handling |dec-mouse|
347N *+mouse_gpm* Unix only: Linux console mouse handling |gpm-mouse|
348B *+mouse_netterm* Unix only: netterm mouse handling |netterm-mouse|
349N *+mouse_pterm* QNX only: pterm mouse handling |qnx-terminal|
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000350N *+mouse_sysmouse* Unix only: *BSD console mouse handling |sysmouse|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000351N *+mouse_xterm* Unix only: xterm mouse handling |xterm-mouse|
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100352B *+multi_byte* 16 and 32 bit characters |multibyte|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000353 *+multi_byte_ime* Win32 input method for multibyte chars |multibyte-ime|
354N *+multi_lang* non-English language support |multi-lang|
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000355m *+mzscheme* Mzscheme interface |mzscheme|
Bram Moolenaar4770d092006-01-12 23:22:24 +0000356m *+mzscheme/dyn* Mzscheme interface |mzscheme-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000357m *+netbeans_intg* |netbeans|
358m *+ole* Win32 GUI only: |ole-interface|
359 *+osfiletype* Support for the 'osfiletype' option and filetype
360 checking in automatic commands. |autocmd-osfiletypes|
361N *+path_extra* Up/downwards search in 'path' and 'tags'
Bram Moolenaara5792f52005-11-23 21:25:05 +0000362m *+perl* Perl interface |perl|
363m *+perl/dyn* Perl interface |perl-dynamic| |/dyn|
Bram Moolenaar55debbe2010-05-23 23:34:36 +0200364H *+persistent_undo* Persistent undo |undo-persistence|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000365 *+postscript* |:hardcopy| writes a PostScript file
366N *+printer* |:hardcopy| command
Bram Moolenaar19a09a12005-03-04 23:39:37 +0000367H *+profile* |:profile| command
Bram Moolenaara5792f52005-11-23 21:25:05 +0000368m *+python* Python interface |python|
369m *+python/dyn* Python interface |python-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000370N *+quickfix* |:make| and |quickfix| commands
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000371N *+reltime* |reltime()| function, 'hlsearch'/'incsearch' timeout,
372 'redrawtime' option
Bram Moolenaar071d4272004-06-13 20:20:40 +0000373B *+rightleft* Right to left typing |'rightleft'|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000374m *+ruby* Ruby interface |ruby|
375m *+ruby/dyn* Ruby interface |ruby-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000376N *+scrollbind* |'scrollbind'|
377B *+signs* |:sign|
378N *+smartindent* |'smartindent'|
379m *+sniff* SniFF interface |sniff|
Bram Moolenaaref94eec2009-11-11 13:22:11 +0000380N *+startuptime* |--startuptime| argument
Bram Moolenaar071d4272004-06-13 20:20:40 +0000381N *+statusline* Options 'statusline', 'rulerformat' and special
382 formats of 'titlestring' and 'iconstring'
383m *+sun_workshop* |workshop|
384N *+syntax* Syntax highlighting |syntax|
385 *+system()* Unix only: opposite of |+fork|
386N *+tag_binary* binary searching in tags file |tag-binary-search|
387N *+tag_old_static* old method for static tags |tag-old-static|
388m *+tag_any_white* any white space allowed in tags file |tag-any-white|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000389m *+tcl* Tcl interface |tcl|
390m *+tcl/dyn* Tcl interface |tcl-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000391 *+terminfo* uses |terminfo| instead of termcap
392N *+termresponse* support for |t_RV| and |v:termresponse|
393N *+textobjects* |text-objects| selection
394 *+tgetent* non-Unix only: able to use external termcap
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000395N *+title* Setting the window 'title' and 'icon'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000396N *+toolbar* |gui-toolbar|
397N *+user_commands* User-defined commands. |user-commands|
398N *+viminfo* |'viminfo'|
399N *+vertsplit* Vertically split windows |:vsplit|
400N *+virtualedit* |'virtualedit'|
401S *+visual* Visual mode |Visual-mode|
402N *+visualextra* extra Visual mode commands |blockwise-operators|
403N *+vreplace* |gR| and |gr|
404N *+wildignore* |'wildignore'|
405N *+wildmenu* |'wildmenu'|
406S *+windows* more than one window
407m *+writebackup* |'writebackup'| is default on
408m *+xim* X input method |xim|
409 *+xfontset* X fontset support |xfontset|
410 *+xsmp* XSMP (X session management) support
411 *+xsmp_interact* interactive XSMP (X session management) support
412N *+xterm_clipboard* Unix only: xterm clipboard handling
413m *+xterm_save* save and restore xterm screen |xterm-screens|
414N *+X11* Unix only: can restore window title |X11|
415
416 */dyn* *E370* *E448*
417 To some of the features "/dyn" is added when the
418 feature is only available when the related library can
419 be dynamically loaded.
420
421:ve[rsion] {nr} Is now ignored. This was previously used to check the
422 version number of a .vimrc file. It was removed,
423 because you can now use the ":if" command for
424 version-dependent behavior. {not in Vi}
425
426 *:redi* *:redir*
427:redi[r][!] > {file} Redirect messages to file {file}. The messages which
428 are the output of commands are written to that file,
429 until redirection ends. The messages are also still
430 shown on the screen. When [!] is included, an
431 existing file is overwritten. When [!] is omitted,
432 and {file} exists, this command fails.
433 Only one ":redir" can be active at a time. Calls to
434 ":redir" will close any active redirection before
435 starting redirection to the new target.
436 To stop the messages and commands from being echoed to
437 the screen, put the commands in a function and call it
438 with ":silent call Function()".
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000439 An alternative is to use the 'verbosefile' option,
440 this can be used in combination with ":redir".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000441 {not in Vi}
442
443:redi[r] >> {file} Redirect messages to file {file}. Append if {file}
444 already exists. {not in Vi}
445
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000446:redi[r] @{a-zA-Z}
Bram Moolenaar6c0b44b2005-06-01 21:56:33 +0000447:redi[r] @{a-zA-Z}> Redirect messages to register {a-z}. Append to the
Bram Moolenaar071d4272004-06-13 20:20:40 +0000448 contents of the register if its name is given
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000449 uppercase {A-Z}. The ">" after the register name is
450 optional. {not in Vi}
Bram Moolenaar34cdc3e2005-05-18 22:24:46 +0000451:redi[r] @{a-z}>> Append messages to register {a-z}. {not in Vi}
Bram Moolenaar071d4272004-06-13 20:20:40 +0000452
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000453:redi[r] @*>
454:redi[r] @+> Redirect messages to the selection or clipboard. For
455 backward compatibility, the ">" after the register
456 name can be omitted. See |quotestar| and |quoteplus|.
457 {not in Vi}
458:redi[r] @*>>
459:redi[r] @+>> Append messages to the selection or clipboard.
460 {not in Vi}
Bram Moolenaar071d4272004-06-13 20:20:40 +0000461
Bram Moolenaar6c0b44b2005-06-01 21:56:33 +0000462:redi[r] @"> Redirect messages to the unnamed register. For
463 backward compatibility, the ">" after the register
464 name can be omitted. {not in Vi}
Bram Moolenaar34cdc3e2005-05-18 22:24:46 +0000465:redi[r] @">> Append messages to the unnamed register. {not in Vi}
Bram Moolenaar071d4272004-06-13 20:20:40 +0000466
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000467:redi[r] => {var} Redirect messages to a variable. If the variable
468 doesn't exist, then it is created. If the variable
469 exists, then it is initialized to an empty string.
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000470 The variable will remain empty until redirection ends.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000471 Only string variables can be used. After the
472 redirection starts, if the variable is removed or
473 locked or the variable type is changed, then further
474 command output messages will cause errors. {not in Vi}
475
476:redi[r] =>> {var} Append messages to an existing variable. Only string
477 variables can be used. {not in Vi}
478
Bram Moolenaar071d4272004-06-13 20:20:40 +0000479:redi[r] END End redirecting messages. {not in Vi}
480
481 *:sil* *:silent*
482:sil[ent][!] {command} Execute {command} silently. Normal messages will not
483 be given or added to the message history.
484 When [!] is added, error messages will also be
485 skipped, and commands and mappings will not be aborted
486 when an error is detected. |v:errmsg| is still set.
487 When [!] is not used, an error message will cause
488 further messages to be displayed normally.
489 Redirection, started with |:redir|, will continue as
490 usual, although there might be small differences.
491 This will allow redirecting the output of a command
492 without seeing it on the screen. Example: >
493 :redir >/tmp/foobar
494 :silent g/Aap/p
495 :redir END
496< To execute a Normal mode command silently, use the
497 |:normal| command. For example, to search for a
498 string without messages: >
499 :silent exe "normal /path\<CR>"
500< ":silent!" is useful to execute a command that may
501 fail, but the failure is to be ignored. Example: >
502 :let v:errmsg = ""
503 :silent! /^begin
504 :if v:errmsg != ""
505 : ... pattern was not found
506< ":silent" will also avoid the hit-enter prompt. When
507 using this for an external command, this may cause the
508 screen to be messed up. Use |CTRL-L| to clean it up
509 then.
510 ":silent menu ..." defines a menu that will not echo a
511 Command-line command. The command will still produce
512 messages though. Use ":silent" in the command itself
513 to avoid that: ":silent menu .... :silent command".
514
Bram Moolenaar8e258a42009-07-09 13:55:43 +0000515 *:uns* *:unsilent*
516:uns[ilent] {command} Execute {command} not silently. Only makes a
517 difference when |:silent| was used to get to this
518 command.
519 Use this for giving a message even when |:silent| was
520 used. In this example |:silent| is used to avoid the
521 message about reading the file and |:unsilent| to be
522 able to list the first line of each file. >
523 :silent argdo unsilent echo expand('%') . ": " . getline(1)
524<
525
Bram Moolenaar071d4272004-06-13 20:20:40 +0000526 *:verb* *:verbose*
527:[count]verb[ose] {command}
528 Execute {command} with 'verbose' set to [count]. If
Bram Moolenaared203462004-06-16 11:19:22 +0000529 [count] is omitted one is used. ":0verbose" can be
530 used to set 'verbose' to zero.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000531 The additional use of ":silent" makes messages
532 generated but not displayed.
533 The combination of ":silent" and ":verbose" can be
534 used to generate messages and check them with
535 |v:statusmsg| and friends. For example: >
536 :let v:statusmsg = ""
537 :silent verbose runtime foobar.vim
538 :if v:statusmsg != ""
539 : " foobar.vim could not be found
540 :endif
541< When concatenating another command, the ":verbose"
542 only applies to the first one: >
543 :4verbose set verbose | set verbose
544< verbose=4 ~
545 verbose=0 ~
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000546 For logging verbose messages in a file use the
547 'verbosefile' option.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000548
Bram Moolenaar8aff23a2005-08-19 20:40:30 +0000549 *:verbose-cmd*
550When 'verbose' is non-zero, listing the value of a Vim option or a key map or
Bram Moolenaare344bea2005-09-01 20:46:49 +0000551an abbreviation or a user-defined function or a command or a highlight group
552or an autocommand will also display where it was last defined. If it was
553defined manually then there will be no "Last set" message. When it was
554defined while executing a function, user command or autocommand, the script in
555which it was defined is reported.
Bram Moolenaar8aff23a2005-08-19 20:40:30 +0000556{not available when compiled without the +eval feature}
557
Bram Moolenaar071d4272004-06-13 20:20:40 +0000558 *K*
559K Run a program to lookup the keyword under the
560 cursor. The name of the program is given with the
561 'keywordprg' (kp) option (default is "man"). The
562 keyword is formed of letters, numbers and the
563 characters in 'iskeyword'. The keyword under or
564 right of the cursor is used. The same can be done
565 with the command >
566 :!{program} {keyword}
567< There is an example of a program to use in the tools
568 directory of Vim. It is called 'ref' and does a
569 simple spelling check.
570 Special cases:
571 - If 'keywordprg' is empty, the ":help" command is
572 used. It's a good idea to include more characters
573 in 'iskeyword' then, to be able to find more help.
574 - When 'keywordprg' is equal to "man", a count before
575 "K" is inserted after the "man" command and before
576 the keyword. For example, using "2K" while the
577 cursor is on "mkdir", results in: >
578 !man 2 mkdir
579< - When 'keywordprg' is equal to "man -s", a count
580 before "K" is inserted after the "-s". If there is
581 no count, the "-s" is removed.
582 {not in Vi}
583
584 *v_K*
585{Visual}K Like "K", but use the visually highlighted text for
586 the keyword. Only works when the highlighted text is
587 not more than one line. {not in Vi}
588
589[N]gs *gs* *:sl* *:sleep*
590:[N]sl[eep] [N] [m] Do nothing for [N] seconds. When [m] is included,
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000591 sleep for [N] milliseconds. The count for "gs" always
Bram Moolenaar071d4272004-06-13 20:20:40 +0000592 uses seconds. The default is one second. >
593 :sleep "sleep for one second
594 :5sleep "sleep for five seconds
595 :sleep 100m "sleep for a hundred milliseconds
596 10gs "sleep for ten seconds
597< Can be interrupted with CTRL-C (CTRL-Break on MS-DOS).
Bram Moolenaar677ee682005-01-27 14:41:15 +0000598 "gs" stands for "goto sleep".
599 While sleeping the cursor is positioned in the text,
600 if at a visible position. {not in Vi}
Bram Moolenaar071d4272004-06-13 20:20:40 +0000601
602 *g_CTRL-A*
603g CTRL-A Only when Vim was compiled with MEM_PROFILING defined
604 (which is very rare): print memory usage statistics.
605 Only useful for debugging Vim.
606
607==============================================================================
Bram Moolenaareb3593b2006-04-22 22:33:57 +00006083. Using Vim like less or more *less*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000609
610If you use the less or more program to view a file, you don't get syntax
611highlighting. Thus you would like to use Vim instead. You can do this by
612using the shell script "$VIMRUNTIME/macros/less.sh".
613
614This shell script uses the Vim script "$VIMRUNTIME/macros/less.vim". It sets
615up mappings to simulate the commands that less supports. Otherwise, you can
616still use the Vim commands.
617
618This isn't perfect. For example, when viewing a short file Vim will still use
619the whole screen. But it works good enough for most uses, and you get syntax
620highlighting.
621
622The "h" key will give you a short overview of the available commands.
623
624 vim:tw=78:ts=8:ft=help:norl: