blob: 85e18b3f621e2cf84e8d26888f5f07f80ea45292 [file] [log] [blame]
Bram Moolenaar98056532019-12-12 14:18:35 +01001*various.txt* For Vim version 8.2. Last change: 2019 Dec 07
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
Bram Moolenaare12bab32019-01-08 22:02:56 +010033 *:redrawt* *:redrawtabline*
34:redrawt[abline] Redraw the tabline. Useful to update the tabline when
35 'tabline' includes an item that doesn't trigger
36 automatic updating.
37
Bram Moolenaar071d4272004-06-13 20:20:40 +000038 *N<Del>*
39<Del> When entering a number: Remove the last digit.
40 Note: if you like to use <BS> for this, add this
41 mapping to your .vimrc: >
42 :map CTRL-V <BS> CTRL-V <Del>
43< See |:fixdel| if your <Del> key does not do what you
44 want.
45
46:as[cii] or *ga* *:as* *:ascii*
47ga Print the ascii value of the character under the
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010048 cursor in decimal, hexadecimal and octal.
49 Mnemonic: Get Ascii value.
50
51 For example, when the cursor is on a 'R':
Bram Moolenaar071d4272004-06-13 20:20:40 +000052 <R> 82, Hex 52, Octal 122 ~
53 When the character is a non-standard ASCII character,
54 but printable according to the 'isprint' option, the
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010055 non-printable version is also given.
Bram Moolenaar664f3cf2019-12-07 16:03:51 +010056
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010057 When the character is larger than 127, the <M-x> form
58 is also printed. For example:
Bram Moolenaar071d4272004-06-13 20:20:40 +000059 <~A> <M-^A> 129, Hex 81, Octal 201 ~
60 <p> <|~> <M-~> 254, Hex fe, Octal 376 ~
61 (where <p> is a special character)
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010062
Bram Moolenaar071d4272004-06-13 20:20:40 +000063 The <Nul> character in a file is stored internally as
64 <NL>, but it will be shown as:
65 <^@> 0, Hex 00, Octal 000 ~
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010066
Bram Moolenaar362e1a32006-03-06 23:29:24 +000067 If the character has composing characters these are
68 also shown. The value of 'maxcombine' doesn't matter.
Bram Moolenaar5f73ef82018-02-27 21:09:30 +010069
70 If the character can be inserted as a digraph, also
71 output the two characters that can be used to create
72 the character:
73 <ö> 246, Hex 00f6, Oct 366, Digr o: ~
74 This shows you can type CTRL-K o : to insert ö.
75
Bram Moolenaar071d4272004-06-13 20:20:40 +000076 *g8*
77g8 Print the hex values of the bytes used in the
78 character under the cursor, assuming it is in |UTF-8|
Bram Moolenaar362e1a32006-03-06 23:29:24 +000079 encoding. This also shows composing characters. The
80 value of 'maxcombine' doesn't matter.
81 Example of a character with two composing characters:
Bram Moolenaar071d4272004-06-13 20:20:40 +000082 e0 b8 81 + e0 b8 b9 + e0 b9 89 ~
Bram Moolenaarca003e12006-03-17 23:19:38 +000083
84 *8g8*
858g8 Find an illegal UTF-8 byte sequence at or after the
86 cursor. This works in two situations:
87 1. when 'encoding' is any 8-bit encoding
88 2. when 'encoding' is "utf-8" and 'fileencoding' is
89 any 8-bit encoding
90 Thus it can be used when editing a file that was
91 supposed to be UTF-8 but was read as if it is an 8-bit
92 encoding because it contains illegal bytes.
93 Does not wrap around the end of the file.
94 Note that when the cursor is on an illegal byte or the
95 cursor is halfway a multi-byte character the command
96 won't move the cursor.
Bram Moolenaar071d4272004-06-13 20:20:40 +000097
Bram Moolenaar551dbcc2006-04-25 22:13:59 +000098 *:p* *:pr* *:print* *E749*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +000099:[range]p[rint] [flags]
100 Print [range] lines (default current line).
Bram Moolenaar071d4272004-06-13 20:20:40 +0000101 Note: If you are looking for a way to print your text
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000102 on paper see |:hardcopy|. In the GUI you can use the
103 File.Print menu entry.
104 See |ex-flags| for [flags].
Bram Moolenaar818078d2016-08-27 21:58:42 +0200105 The |:filter| command can be used to only show lines
106 matching a pattern.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000107
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000108:[range]p[rint] {count} [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000109 Print {count} lines, starting with [range] (default
110 current line |cmdline-ranges|).
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000111 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000112
113 *:P* *:Print*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000114:[range]P[rint] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000115 Just as ":print". Was apparently added to Vi for
116 people that keep the shift key pressed too long...
Bram Moolenaar166af9b2010-11-16 20:34:40 +0100117 Note: A user command can overrule this command.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000118 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000119
120 *:l* *:list*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000121:[range]l[ist] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000122 Same as :print, but display unprintable characters
Bram Moolenaarf9d5ca12010-08-01 16:13:51 +0200123 with '^' and put $ after the line. This can be
Bram Moolenaard58e9292011-02-09 17:07:58 +0100124 further changed with the 'listchars' option.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000125 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000126
127 *:nu* *:number*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000128:[range]nu[mber] [count] [flags]
Bram Moolenaar071d4272004-06-13 20:20:40 +0000129 Same as :print, but precede each line with its line
Bram Moolenaarfaa959a2006-02-20 21:37:40 +0000130 number. (See also 'highlight' and 'numberwidth'
131 option).
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000132 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000133
134 *:#*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000135:[range]# [count] [flags]
136 synonym for :number.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000137
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000138 *:#!*
139:#!{anything} Ignored, so that you can start a Vim script with: >
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000140 #!vim -S
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000141 echo "this is a Vim script"
142 quit
143<
Bram Moolenaar071d4272004-06-13 20:20:40 +0000144 *:z* *E144*
145:{range}z[+-^.=]{count} Display several lines of text surrounding the line
146 specified with {range}, or around the current line
147 if there is no {range}. If there is a {count}, that's
Bram Moolenaar4399ef42005-02-12 14:29:27 +0000148 how many lines you'll see; if there is only one window
Bram Moolenaar662db672011-03-22 14:05:35 +0100149 then twice the value of the 'scroll' option is used,
150 otherwise the current window height minus 3 is used.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000151
Bram Moolenaarb6b046b2011-12-30 13:11:27 +0100152 If there is a {count} the 'window' option is set to
153 its value.
154
Bram Moolenaar071d4272004-06-13 20:20:40 +0000155 :z can be used either alone or followed by any of
156 several punctuation marks. These have the following
157 effect:
158
Bram Moolenaar662db672011-03-22 14:05:35 +0100159 mark first line last line new cursor line ~
Bram Moolenaar071d4272004-06-13 20:20:40 +0000160 ---- ---------- --------- ------------
161 + current line 1 scr forward 1 scr forward
162 - 1 scr back current line current line
163 ^ 2 scr back 1 scr back 1 scr back
Bram Moolenaar2a8d1f82005-02-05 21:43:56 +0000164 . 1/2 scr back 1/2 scr fwd 1/2 scr fwd
165 = 1/2 scr back 1/2 scr fwd current line
Bram Moolenaar071d4272004-06-13 20:20:40 +0000166
167 Specifying no mark at all is the same as "+".
168 If the mark is "=", a line of dashes is printed
169 around the current line.
170
171:{range}z#[+-^.=]{count} *:z#*
172 Like ":z", but number the lines.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000173
174 *:=*
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000175:= [flags] Print the last line number.
176 See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000177
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000178:{range}= [flags] Prints the last line number in {range}. For example,
Bram Moolenaar071d4272004-06-13 20:20:40 +0000179 this prints the current line number: >
180 :.=
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000181< See |ex-flags| for [flags].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000182
183:norm[al][!] {commands} *:norm* *:normal*
184 Execute Normal mode commands {commands}. This makes
185 it possible to execute Normal mode commands typed on
Bram Moolenaar4a748032010-09-30 21:47:56 +0200186 the command-line. {commands} are executed like they
187 are typed. For undo all commands are undone together.
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000188 Execution stops when an error is encountered.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100189
Bram Moolenaar071d4272004-06-13 20:20:40 +0000190 If the [!] is given, mappings will not be used.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100191 Without it, when this command is called from a
192 non-remappable mapping (|:noremap|), the argument can
193 be mapped anyway.
194
Bram Moolenaar071d4272004-06-13 20:20:40 +0000195 {commands} should be a complete command. If
196 {commands} does not finish a command, the last one
197 will be aborted as if <Esc> or <C-C> was typed.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000198 This implies that an insert command must be completed
199 (to start Insert mode, see |:startinsert|). A ":"
Bram Moolenaar7c626922005-02-07 22:01:03 +0000200 command must be completed as well. And you can't use
201 "Q" or "gQ" to start Ex mode.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100202
203 The display is not updated while ":normal" is busy.
204
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100205 {commands} cannot start with a space. Put a count of
206 1 (one) before it, "1 " is one space.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100207
Bram Moolenaar071d4272004-06-13 20:20:40 +0000208 The 'insertmode' option is ignored for {commands}.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100209
Bram Moolenaar071d4272004-06-13 20:20:40 +0000210 This command cannot be followed by another command,
211 since any '|' is considered part of the command.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100212
Bram Moolenaar071d4272004-06-13 20:20:40 +0000213 This command can be used recursively, but the depth is
214 limited by 'maxmapdepth'.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100215
Bram Moolenaar071d4272004-06-13 20:20:40 +0000216 An alternative is to use |:execute|, which uses an
217 expression as argument. This allows the use of
Bram Moolenaar46f9d492010-06-12 20:18:19 +0200218 printable characters to represent special characters.
Bram Moolenaara3e6bc92013-01-30 14:18:00 +0100219
Bram Moolenaar46f9d492010-06-12 20:18:19 +0200220 Example: >
Bram Moolenaar071d4272004-06-13 20:20:40 +0000221 :exe "normal \<c-w>\<c-w>"
Bram Moolenaar071d4272004-06-13 20:20:40 +0000222
223:{range}norm[al][!] {commands} *:normal-range*
224 Execute Normal mode commands {commands} for each line
225 in the {range}. Before executing the {commands}, the
226 cursor is positioned in the first column of the range,
227 for each line. Otherwise it's the same as the
228 ":normal" command without a range.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000229
230 *:sh* *:shell* *E371*
231:sh[ell] This command starts a shell. When the shell exits
232 (after the "exit" command) you return to Vim. The
233 name for the shell command comes from 'shell' option.
234 *E360*
235 Note: This doesn't work when Vim on the Amiga was
236 started in QuickFix mode from a compiler, because the
237 compiler will have set stdin to a non-interactive
238 mode.
239
240 *:!cmd* *:!* *E34*
241:!{cmd} Execute {cmd} with the shell. See also the 'shell'
242 and 'shelltype' option.
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200243
Bram Moolenaar071d4272004-06-13 20:20:40 +0000244 Any '!' in {cmd} is replaced with the previous
245 external command (see also 'cpoptions'). But not when
246 there is a backslash before the '!', then that
247 backslash is removed. Example: ":!ls" followed by
248 ":!echo ! \! \\!" executes "echo ls ! \!".
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200249
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000250 A '|' in {cmd} is passed to the shell, you cannot use
251 it to append a Vim command. See |:bar|.
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200252
253 If {cmd} contains "%" it is expanded to the current
254 file name. Special characters are not escaped, use
255 quotes to avoid their special meaning: >
256 :!ls "%"
257< If the file name contains a "$" single quotes might
258 work better (but a single quote causes trouble): >
259 :!ls '%'
260< This should always work, but it's more typing: >
261 :exe "!ls " . shellescape(expand("%"))
262<
Bram Moolenaar071d4272004-06-13 20:20:40 +0000263 A newline character ends {cmd}, what follows is
264 interpreted as a following ":" command. However, if
265 there is a backslash before the newline it is removed
266 and {cmd} continues. It doesn't matter how many
267 backslashes are before the newline, only one is
268 removed.
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200269
Bram Moolenaar071d4272004-06-13 20:20:40 +0000270 On Unix the command normally runs in a non-interactive
271 shell. If you want an interactive shell to be used
272 (to use aliases) set 'shellcmdflag' to "-ic".
273 For Win32 also see |:!start|.
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200274
Bram Moolenaare968e362014-05-13 20:23:24 +0200275 After the command has been executed, the timestamp and
276 size of the current file is checked |timestamp|.
Bram Moolenaar7e38ea22014-04-05 22:55:53 +0200277
Bram Moolenaar071d4272004-06-13 20:20:40 +0000278 Vim redraws the screen after the command is finished,
279 because it may have printed any text. This requires a
280 hit-enter prompt, so that you can read any messages.
281 To avoid this use: >
282 :silent !{cmd}
283< The screen is not redrawn then, thus you have to use
284 CTRL-L or ":redraw!" if the command did display
285 something.
286 Also see |shell-window|.
287
288 *:!!*
289:!! Repeat last ":!{cmd}".
290
Bram Moolenaar61da1bf2019-06-06 12:14:49 +0200291 *:ve* *:ver* *:version*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000292:ve[rsion] Print the version number of the editor. If the
293 compiler used understands "__DATE__" the compilation
294 date is mentioned. Otherwise a fixed release-date is
295 shown.
296 The following lines contain information about which
297 features were enabled when Vim was compiled. When
298 there is a preceding '+', the feature is included,
299 when there is a '-' it is excluded. To change this,
300 you have to edit feature.h and recompile Vim.
301 To check for this in an expression, see |has()|.
302 Here is an overview of the features.
303 The first column shows the smallest version in which
304 they are included:
Bram Moolenaarb5b75622018-03-09 22:22:21 +0100305 T tiny (always)
Bram Moolenaar071d4272004-06-13 20:20:40 +0000306 S small
307 N normal
308 B big
309 H huge
310 m manually enabled or depends on other features
Bram Moolenaar4ceaa3a2019-12-03 22:49:09 +0100311 - never, feature was removed
Bram Moolenaar071d4272004-06-13 20:20:40 +0000312 (none) system dependent
313 Thus if a feature is marked with "N", it is included
314 in the normal, big and huge versions of Vim.
315
316 *+feature-list*
Bram Moolenaar7cba6c02013-09-05 22:13:31 +0200317 *+acl* |ACL| support included
Bram Moolenaar071d4272004-06-13 20:20:40 +0000318 *+ARP* Amiga only: ARP support included
319B *+arabic* |Arabic| language support
Bram Moolenaarb5b75622018-03-09 22:22:21 +0100320T *+autocmd* |:autocmd|, automatic commands
Bram Moolenaare42a6d22017-11-12 19:21:51 +0100321H *+autoservername* Automatically enable |clientserver|
Bram Moolenaara2a80162017-11-21 23:09:50 +0100322m *+balloon_eval* |balloon-eval| support in the GUI. Included when
323 compiling with supported GUI (Motif, GTK, GUI) and
324 either Netbeans/Sun Workshop integration or |+eval|
325 feature.
326H *+balloon_eval_term* |balloon-eval| support in the terminal,
327 'balloonevalterm'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000328N *+browse* |:browse| command
329N *+builtin_terms* some terminals builtin |builtin-terms|
330B *++builtin_terms* maximal terminals builtin |builtin-terms|
331N *+byte_offset* support for 'o' flag in 'statusline' option, "go"
332 and ":goto" commands.
Bram Moolenaar298b4402016-01-28 22:38:53 +0100333m *+channel* inter process communication |channel|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000334N *+cindent* |'cindent'|, C indenting
335N *+clientserver* Unix and Win32: Remote invocation |clientserver|
Bram Moolenaar56c860c2019-08-17 20:09:31 +0200336 *+clipboard* |clipboard| support compiled-in
337 *+clipboard_working* |clipboard| support compiled-in and working
Bram Moolenaar06fe74a2019-08-31 16:20:32 +0200338T *+cmdline_compl* command line completion |cmdline-completion|
Bram Moolenaar37c64c72017-09-19 22:06:03 +0200339S *+cmdline_hist* command line history |cmdline-history|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000340N *+cmdline_info* |'showcmd'| and |'ruler'|
Bram Moolenaar8c96af92019-09-28 19:05:57 +0200341T *+comments* |'comments'| support
Bram Moolenaarca8c9862010-07-24 15:00:38 +0200342B *+conceal* "conceal" support, see |conceal| |:syn-conceal| etc.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000343N *+cryptv* encryption support |encryption|
344B *+cscope* |cscope| support
Bram Moolenaarb5b75622018-03-09 22:22:21 +0100345T *+cursorbind* |'cursorbind'| support
Bram Moolenaarac6e65f2005-08-29 22:25:38 +0000346m *+cursorshape* |termcap-cursor-shape| support
347m *+debug* Compiled for debugging.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000348N *+dialog_gui* Support for |:confirm| with GUI dialog.
349N *+dialog_con* Support for |:confirm| with console dialog.
350N *+dialog_con_gui* Support for |:confirm| with GUI and console dialog.
351N *+diff* |vimdiff| and 'diff'
352N *+digraphs* |digraphs| *E196*
Bram Moolenaar43cb6262018-03-14 21:39:02 +0100353 *+directx* Win32 GUI only: DirectX and |'renderoptions'|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000354 *+dnd* Support for DnD into the "~ register |quote_~|.
355B *+emacs_tags* |emacs-tags| files
356N *+eval* expression evaluation |eval.txt|
Bram Moolenaar5e9b2fa2016-02-01 22:37:05 +0100357N *+ex_extra* always on now, used to be for Vim's extra Ex commands
Bram Moolenaar071d4272004-06-13 20:20:40 +0000358N *+extra_search* |'hlsearch'| and |'incsearch'| options.
Bram Moolenaar4ceaa3a2019-12-03 22:49:09 +0100359- *+farsi* Removed: |farsi| language
Bram Moolenaar071d4272004-06-13 20:20:40 +0000360N *+file_in_path* |gf|, |CTRL-W_f| and |<cfile>|
361N *+find_in_path* include file searches: |[I|, |:isearch|,
362 |CTRL-W_CTRL-I|, |:checkpath|, etc.
363N *+folding* |folding|
364 *+footer* |gui-footer|
365 *+fork* Unix only: |fork| shell commands
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000366 *+float* Floating point support
Bram Moolenaar071d4272004-06-13 20:20:40 +0000367N *+gettext* message translations |multi-lang|
368 *+GUI_Athena* Unix only: Athena |GUI|
369 *+GUI_neXtaw* Unix only: neXtaw |GUI|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000370 *+GUI_GTK* Unix only: GTK+ |GUI|
371 *+GUI_Motif* Unix only: Motif |GUI|
372 *+GUI_Photon* QNX only: Photon |GUI|
373m *+hangul_input* Hangul input support |hangul|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000374 *+iconv* Compiled with the |iconv()| function
375 *+iconv/dyn* Likewise |iconv-dynamic| |/dyn|
Bram Moolenaar06fe74a2019-08-31 16:20:32 +0200376T *+insert_expand* |insert_expand| Insert mode completion
Bram Moolenaar38a55632016-02-15 22:07:32 +0100377m *+job* starting and stopping jobs |job|
Bram Moolenaar37c64c72017-09-19 22:06:03 +0200378S *+jumplist* |jumplist|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000379B *+keymap* |'keymap'|
Bram Moolenaarbc8801c2016-08-02 21:04:33 +0200380N *+lambda* |lambda| and |closure|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000381B *+langmap* |'langmap'|
382N *+libcall* |libcall()|
383N *+linebreak* |'linebreak'|, |'breakat'| and |'showbreak'|
384N *+lispindent* |'lisp'|
Bram Moolenaar0c72fe42018-03-29 16:04:08 +0200385T *+listcmds* Vim commands for the list of buffers |buffer-hidden|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000386 and argument list |:argdelete|
Bram Moolenaar088e8e32019-08-08 22:15:18 +0200387T *+localmap* Support for mappings local to a buffer |:map-local|
Bram Moolenaar0ba04292010-07-14 23:23:17 +0200388m *+lua* |Lua| interface
389m *+lua/dyn* |Lua| interface |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000390N *+menu* |:menu|
391N *+mksession* |:mksession|
Bram Moolenaar30e9b3c2019-09-07 16:24:12 +0200392T *+modify_fname* |filename-modifiers|
Bram Moolenaar96f45c02019-10-26 19:53:45 +0200393T *+mouse* Mouse handling |mouse-using|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000394N *+mouseshape* |'mouseshape'|
395B *+mouse_dec* Unix only: Dec terminal mouse handling |dec-mouse|
396N *+mouse_gpm* Unix only: Linux console mouse handling |gpm-mouse|
Bram Moolenaar13600302014-05-22 18:26:40 +0200397N *+mouse_jsbterm* JSB mouse handling |jsbterm-mouse|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000398B *+mouse_netterm* Unix only: netterm mouse handling |netterm-mouse|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100399N *+mouse_pterm* QNX only: pterm mouse handling |qnx-terminal|
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000400N *+mouse_sysmouse* Unix only: *BSD console mouse handling |sysmouse|
Bram Moolenaar9b451252012-08-15 17:43:31 +0200401B *+mouse_sgr* Unix only: sgr mouse handling |sgr-mouse|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100402B *+mouse_urxvt* Unix only: urxvt mouse handling |urxvt-mouse|
403N *+mouse_xterm* Unix only: xterm mouse handling |xterm-mouse|
Bram Moolenaare6ae6222013-05-21 21:01:10 +0200404N *+multi_byte* 16 and 32 bit characters |multibyte|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000405 *+multi_byte_ime* Win32 input method for multibyte chars |multibyte-ime|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100406N *+multi_lang* non-English language support |multi-lang|
Bram Moolenaar325b7a22004-07-05 15:58:32 +0000407m *+mzscheme* Mzscheme interface |mzscheme|
Bram Moolenaar4770d092006-01-12 23:22:24 +0000408m *+mzscheme/dyn* Mzscheme interface |mzscheme-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000409m *+netbeans_intg* |netbeans|
Bram Moolenaar22fcfad2016-07-01 18:17:26 +0200410 *+num64* 64-bit Number support |Number|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100411m *+ole* Win32 GUI only: |ole-interface|
Bram Moolenaar91c49372016-05-08 09:50:29 +0200412N *+packages* Loading |packages|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100413N *+path_extra* Up/downwards search in 'path' and 'tags'
Bram Moolenaara5792f52005-11-23 21:25:05 +0000414m *+perl* Perl interface |perl|
415m *+perl/dyn* Perl interface |perl-dynamic| |/dyn|
Bram Moolenaar7fc0c062010-08-10 21:43:35 +0200416N *+persistent_undo* Persistent undo |undo-persistence|
Bram Moolenaar4ceaa3a2019-12-03 22:49:09 +0100417N *+popupwin* Popup windows |popup-window|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100418 *+postscript* |:hardcopy| writes a PostScript file
Bram Moolenaar071d4272004-06-13 20:20:40 +0000419N *+printer* |:hardcopy| command
Bram Moolenaar19a09a12005-03-04 23:39:37 +0000420H *+profile* |:profile| command
Bram Moolenaar60aad972010-07-21 20:36:22 +0200421m *+python* Python 2 interface |python|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100422m *+python/dyn* Python 2 interface |python-dynamic| |/dyn|
Bram Moolenaar60aad972010-07-21 20:36:22 +0200423m *+python3* Python 3 interface |python|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100424m *+python3/dyn* Python 3 interface |python-dynamic| |/dyn|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000425N *+quickfix* |:make| and |quickfix| commands
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000426N *+reltime* |reltime()| function, 'hlsearch'/'incsearch' timeout,
427 'redrawtime' option
Bram Moolenaar071d4272004-06-13 20:20:40 +0000428B *+rightleft* Right to left typing |'rightleft'|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000429m *+ruby* Ruby interface |ruby|
430m *+ruby/dyn* Ruby interface |ruby-dynamic| |/dyn|
Bram Moolenaar98ef2332018-03-18 14:44:37 +0100431T *+scrollbind* |'scrollbind'|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000432B *+signs* |:sign|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100433N *+smartindent* |'smartindent'|
Bram Moolenaar12ee7ff2019-06-10 22:47:40 +0200434B *+sound* |sound_playevent()|, |sound_playfile()| functions, etc.
435N *+spell* spell checking support, see |spell|
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100436N *+startuptime* |--startuptime| argument
437N *+statusline* Options 'statusline', 'rulerformat' and special
Bram Moolenaar071d4272004-06-13 20:20:40 +0000438 formats of 'titlestring' and 'iconstring'
Bram Moolenaar4ceaa3a2019-12-03 22:49:09 +0100439- *+sun_workshop* Removed: |workshop|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000440N *+syntax* Syntax highlighting |syntax|
441 *+system()* Unix only: opposite of |+fork|
Bram Moolenaar64d8e252016-09-06 22:12:34 +0200442T *+tag_binary* binary searching in tags file |tag-binary-search|
Bram Moolenaar4ceaa3a2019-12-03 22:49:09 +0100443- *+tag_old_static* Removed; method for static tags |tag-old-static|
444- *+tag_any_white* Removed; was to allow any white space in tags files
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100445m *+tcl* Tcl interface |tcl|
Bram Moolenaara5792f52005-11-23 21:25:05 +0000446m *+tcl/dyn* Tcl interface |tcl-dynamic| |/dyn|
Bram Moolenaar1ccd8ff2017-08-11 19:50:37 +0200447m *+terminal* Support for terminal window |terminal|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000448 *+terminfo* uses |terminfo| instead of termcap
449N *+termresponse* support for |t_RV| and |v:termresponse|
Bram Moolenaar61be73b2016-04-29 22:59:22 +0200450B *+termguicolors* 24-bit color in xterm-compatible terminals support
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100451N *+textobjects* |text-objects| selection
Bram Moolenaar9d87a372018-12-18 21:41:50 +0100452N *+textprop* |text-properties|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000453 *+tgetent* non-Unix only: able to use external termcap
Bram Moolenaare18c0b32016-03-20 21:08:34 +0100454N *+timers* the |timer_start()| function
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000455N *+title* Setting the window 'title' and 'icon'
Bram Moolenaar071d4272004-06-13 20:20:40 +0000456N *+toolbar* |gui-toolbar|
Bram Moolenaarac9fb182019-04-27 13:04:13 +0200457T *+user_commands* User-defined commands. |user-commands|
458 Always enabled since 8.1.1210.
Bram Moolenaar04958cb2018-06-23 19:23:02 +0200459B *+vartabs* Variable-width tabstops. |'vartabstop'|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000460N *+viminfo* |'viminfo'|
Bram Moolenaar37c64c72017-09-19 22:06:03 +0200461 *+vertsplit* Vertically split windows |:vsplit|; Always enabled
462 since 8.0.1118.
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100463N *+virtualedit* |'virtualedit'|
Bram Moolenaar870ba5f2019-01-11 14:37:20 +0100464T *+visual* Visual mode |Visual-mode| Always enabled since 7.4.200.
465T *+visualextra* extra Visual mode commands |blockwise-operators|
Bram Moolenaar1f0bfe52018-07-29 16:09:22 +0200466T *+vreplace* |gR| and |gr|
Bram Moolenaar22f1d0e2018-02-27 14:53:30 +0100467 *+vtp* on MS-Windows console: support for 'termguicolors'
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100468N *+wildignore* |'wildignore'|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000469N *+wildmenu* |'wildmenu'|
Bram Moolenaar870ba5f2019-01-11 14:37:20 +0100470T *+windows* more than one window; Always enabled since 8.0.1118.
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100471m *+writebackup* |'writebackup'| is default on
472m *+xim* X input method |xim|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000473 *+xfontset* X fontset support |xfontset|
Bram Moolenaar7cba6c02013-09-05 22:13:31 +0200474 *+xpm* pixmap support
Bram Moolenaar9b451252012-08-15 17:43:31 +0200475m *+xpm_w32* Win32 GUI only: pixmap support |w32-xpm-support|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000476 *+xsmp* XSMP (X session management) support
477 *+xsmp_interact* interactive XSMP (X session management) support
478N *+xterm_clipboard* Unix only: xterm clipboard handling
Bram Moolenaar34feacb2012-12-05 19:01:43 +0100479m *+xterm_save* save and restore xterm screen |xterm-screens|
480N *+X11* Unix only: can restore window title |X11|
Bram Moolenaar071d4272004-06-13 20:20:40 +0000481
482 */dyn* *E370* *E448*
483 To some of the features "/dyn" is added when the
484 feature is only available when the related library can
485 be dynamically loaded.
486
487:ve[rsion] {nr} Is now ignored. This was previously used to check the
488 version number of a .vimrc file. It was removed,
489 because you can now use the ":if" command for
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200490 version-dependent behavior.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000491
492 *:redi* *:redir*
493:redi[r][!] > {file} Redirect messages to file {file}. The messages which
494 are the output of commands are written to that file,
495 until redirection ends. The messages are also still
496 shown on the screen. When [!] is included, an
497 existing file is overwritten. When [!] is omitted,
498 and {file} exists, this command fails.
Bram Moolenaar063b9d12016-07-09 20:21:48 +0200499
Bram Moolenaar071d4272004-06-13 20:20:40 +0000500 Only one ":redir" can be active at a time. Calls to
501 ":redir" will close any active redirection before
Bram Moolenaar063b9d12016-07-09 20:21:48 +0200502 starting redirection to the new target. For recursive
503 use check out |execute()|.
504
Bram Moolenaar071d4272004-06-13 20:20:40 +0000505 To stop the messages and commands from being echoed to
506 the screen, put the commands in a function and call it
507 with ":silent call Function()".
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000508 An alternative is to use the 'verbosefile' option,
509 this can be used in combination with ":redir".
Bram Moolenaar071d4272004-06-13 20:20:40 +0000510
511:redi[r] >> {file} Redirect messages to file {file}. Append if {file}
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200512 already exists.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000513
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000514:redi[r] @{a-zA-Z}
Bram Moolenaar6c0b44b2005-06-01 21:56:33 +0000515:redi[r] @{a-zA-Z}> Redirect messages to register {a-z}. Append to the
Bram Moolenaar071d4272004-06-13 20:20:40 +0000516 contents of the register if its name is given
Bram Moolenaar8c8de832008-06-24 22:58:06 +0000517 uppercase {A-Z}. The ">" after the register name is
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200518 optional.
519:redi[r] @{a-z}>> Append messages to register {a-z}.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000520
Bram Moolenaar664f3cf2019-12-07 16:03:51 +0100521:redi[r] @*>
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000522:redi[r] @+> Redirect messages to the selection or clipboard. For
523 backward compatibility, the ">" after the register
524 name can be omitted. See |quotestar| and |quoteplus|.
Bram Moolenaar664f3cf2019-12-07 16:03:51 +0100525:redi[r] @*>>
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000526:redi[r] @+>> Append messages to the selection or clipboard.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000527
Bram Moolenaar6c0b44b2005-06-01 21:56:33 +0000528:redi[r] @"> Redirect messages to the unnamed register. For
529 backward compatibility, the ">" after the register
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200530 name can be omitted.
531:redi[r] @">> Append messages to the unnamed register.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000532
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000533:redi[r] => {var} Redirect messages to a variable. If the variable
534 doesn't exist, then it is created. If the variable
535 exists, then it is initialized to an empty string.
Bram Moolenaarc81e5e72007-05-05 18:24:42 +0000536 The variable will remain empty until redirection ends.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000537 Only string variables can be used. After the
538 redirection starts, if the variable is removed or
539 locked or the variable type is changed, then further
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200540 command output messages will cause errors.
Bram Moolenaar063b9d12016-07-09 20:21:48 +0200541 To get the output of one command the |execute()|
542 function can be used.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000543
544:redi[r] =>> {var} Append messages to an existing variable. Only string
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200545 variables can be used.
Bram Moolenaar5313dcb2005-02-22 08:56:13 +0000546
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200547:redi[r] END End redirecting messages.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000548
Bram Moolenaar7b668e82016-08-23 23:51:21 +0200549 *:filt* *:filter*
Bram Moolenaar214641f2017-03-05 17:04:09 +0100550:filt[er][!] {pat} {command}
551:filt[er][!] /{pat}/ {command}
552 Restrict the output of {command} to lines matching
553 with {pat}. For example, to list only xml files: >
Bram Moolenaar818078d2016-08-27 21:58:42 +0200554 :filter /\.xml$/ oldfiles
Bram Moolenaar214641f2017-03-05 17:04:09 +0100555< If the [!] is given, restrict the output of {command}
556 to lines that do NOT match {pat}.
557
Bram Moolenaar7b668e82016-08-23 23:51:21 +0200558 {pat} is a Vim search pattern. Instead of enclosing
559 it in / any non-ID character (see |'isident'|) can be
560 used, so long as it does not appear in {pat}. Without
561 the enclosing character the pattern cannot include the
562 bar character.
563
564 The pattern is matched against the relevant part of
565 the output, not necessarily the whole line. Only some
566 commands support filtering, try it out to check if it
Bram Moolenaarf86db782018-10-25 13:31:37 +0200567 works. Some of the commands that support filtering:
Bram Moolenaarad6dc492019-04-27 22:40:08 +0200568 |:#| - filter whole line
569 |:clist| - filter by file name or module name
570 |:command| - filter by command name
571 |:files| - filter by file name
572 |:highlight| - filter by highlight group
573 |:jumps| - filter by file name
574 |:let| - filter by variable name
575 |:list| - filter whole line
576 |:llist| - filter by file name or module name
577 |:marks| - filter by text in the current file,
578 or file name for other files
579 |:oldfiles| - filter by file name
Bram Moolenaar8fc42962019-10-26 17:33:13 +0200580 |:registers| - filter by register contents
581 (does not work multi-line)
Bram Moolenaarad6dc492019-04-27 22:40:08 +0200582 |:set| - filter by variable name
Bram Moolenaar7b668e82016-08-23 23:51:21 +0200583
584 Only normal messages are filtered, error messages are
585 not.
586
Bram Moolenaare0fa3742016-02-20 15:47:01 +0100587 *:sil* *:silent* *:silent!*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000588:sil[ent][!] {command} Execute {command} silently. Normal messages will not
589 be given or added to the message history.
590 When [!] is added, error messages will also be
591 skipped, and commands and mappings will not be aborted
592 when an error is detected. |v:errmsg| is still set.
593 When [!] is not used, an error message will cause
594 further messages to be displayed normally.
595 Redirection, started with |:redir|, will continue as
596 usual, although there might be small differences.
597 This will allow redirecting the output of a command
598 without seeing it on the screen. Example: >
599 :redir >/tmp/foobar
600 :silent g/Aap/p
601 :redir END
602< To execute a Normal mode command silently, use the
603 |:normal| command. For example, to search for a
604 string without messages: >
605 :silent exe "normal /path\<CR>"
606< ":silent!" is useful to execute a command that may
607 fail, but the failure is to be ignored. Example: >
608 :let v:errmsg = ""
609 :silent! /^begin
610 :if v:errmsg != ""
611 : ... pattern was not found
612< ":silent" will also avoid the hit-enter prompt. When
613 using this for an external command, this may cause the
614 screen to be messed up. Use |CTRL-L| to clean it up
615 then.
616 ":silent menu ..." defines a menu that will not echo a
617 Command-line command. The command will still produce
618 messages though. Use ":silent" in the command itself
619 to avoid that: ":silent menu .... :silent command".
620
Bram Moolenaar8e258a42009-07-09 13:55:43 +0000621 *:uns* *:unsilent*
622:uns[ilent] {command} Execute {command} not silently. Only makes a
623 difference when |:silent| was used to get to this
624 command.
625 Use this for giving a message even when |:silent| was
626 used. In this example |:silent| is used to avoid the
627 message about reading the file and |:unsilent| to be
628 able to list the first line of each file. >
629 :silent argdo unsilent echo expand('%') . ": " . getline(1)
630<
631
Bram Moolenaar071d4272004-06-13 20:20:40 +0000632 *:verb* *:verbose*
633:[count]verb[ose] {command}
634 Execute {command} with 'verbose' set to [count]. If
Bram Moolenaared203462004-06-16 11:19:22 +0000635 [count] is omitted one is used. ":0verbose" can be
636 used to set 'verbose' to zero.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000637 The additional use of ":silent" makes messages
638 generated but not displayed.
639 The combination of ":silent" and ":verbose" can be
640 used to generate messages and check them with
641 |v:statusmsg| and friends. For example: >
642 :let v:statusmsg = ""
643 :silent verbose runtime foobar.vim
644 :if v:statusmsg != ""
645 : " foobar.vim could not be found
646 :endif
647< When concatenating another command, the ":verbose"
648 only applies to the first one: >
649 :4verbose set verbose | set verbose
650< verbose=4 ~
651 verbose=0 ~
Bram Moolenaar54ee7752005-05-31 22:22:17 +0000652 For logging verbose messages in a file use the
653 'verbosefile' option.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000654
Bram Moolenaar8aff23a2005-08-19 20:40:30 +0000655 *:verbose-cmd*
656When 'verbose' is non-zero, listing the value of a Vim option or a key map or
Bram Moolenaare344bea2005-09-01 20:46:49 +0000657an abbreviation or a user-defined function or a command or a highlight group
658or an autocommand will also display where it was last defined. If it was
659defined manually then there will be no "Last set" message. When it was
660defined while executing a function, user command or autocommand, the script in
661which it was defined is reported.
Bram Moolenaardb84e452010-08-15 13:50:43 +0200662{not available when compiled without the |+eval| feature}
Bram Moolenaar8aff23a2005-08-19 20:40:30 +0000663
Bram Moolenaar071d4272004-06-13 20:20:40 +0000664 *K*
665K Run a program to lookup the keyword under the
666 cursor. The name of the program is given with the
667 'keywordprg' (kp) option (default is "man"). The
668 keyword is formed of letters, numbers and the
669 characters in 'iskeyword'. The keyword under or
670 right of the cursor is used. The same can be done
671 with the command >
672 :!{program} {keyword}
673< There is an example of a program to use in the tools
Bram Moolenaar214641f2017-03-05 17:04:09 +0100674 directory of Vim. It is called "ref" and does a
Bram Moolenaar071d4272004-06-13 20:20:40 +0000675 simple spelling check.
676 Special cases:
Bram Moolenaar26852122016-05-24 20:02:38 +0200677 - If 'keywordprg' begins with ":" it is invoked as
678 a Vim Ex command with [count].
Bram Moolenaar071d4272004-06-13 20:20:40 +0000679 - If 'keywordprg' is empty, the ":help" command is
680 used. It's a good idea to include more characters
681 in 'iskeyword' then, to be able to find more help.
Bram Moolenaar26852122016-05-24 20:02:38 +0200682 - When 'keywordprg' is equal to "man" or starts with
683 ":", a [count] before "K" is inserted after
684 keywordprg and before the keyword. For example,
685 using "2K" while the cursor is on "mkdir", results
686 in: >
Bram Moolenaar071d4272004-06-13 20:20:40 +0000687 !man 2 mkdir
688< - When 'keywordprg' is equal to "man -s", a count
689 before "K" is inserted after the "-s". If there is
690 no count, the "-s" is removed.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000691
692 *v_K*
693{Visual}K Like "K", but use the visually highlighted text for
694 the keyword. Only works when the highlighted text is
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200695 not more than one line.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000696
697[N]gs *gs* *:sl* *:sleep*
698:[N]sl[eep] [N] [m] Do nothing for [N] seconds. When [m] is included,
Bram Moolenaar13fcaaf2005-04-15 21:13:42 +0000699 sleep for [N] milliseconds. The count for "gs" always
Bram Moolenaar071d4272004-06-13 20:20:40 +0000700 uses seconds. The default is one second. >
701 :sleep "sleep for one second
702 :5sleep "sleep for five seconds
703 :sleep 100m "sleep for a hundred milliseconds
704 10gs "sleep for ten seconds
Bram Moolenaar5666fcd2019-12-26 14:35:26 +0100705< Can be interrupted with CTRL-C (CTRL-Break on
706 MS-Windows). "gs" stands for "goto sleep".
Bram Moolenaar677ee682005-01-27 14:41:15 +0000707 While sleeping the cursor is positioned in the text,
Bram Moolenaar25c9c682019-05-05 18:13:34 +0200708 if at a visible position.
Bram Moolenaar15146672011-10-20 22:22:38 +0200709 Also process the received netbeans messages. {only
710 available when compiled with the |+netbeans_intg|
711 feature}
712
Bram Moolenaard4aa83a2019-05-09 18:59:31 +0200713 *:xrestore* *:xr*
714:xr[estore] [display] Reinitializes the connection to the X11 server. Useful
715 after the X server restarts, e.g. when running Vim for
716 long time inside screen/tmux and connecting from
Bram Moolenaar68e65602019-05-26 21:33:31 +0200717 different machines.
Bram Moolenaar664f3cf2019-12-07 16:03:51 +0100718 [display] should be in the format of the $DISPLAY
Bram Moolenaard4aa83a2019-05-09 18:59:31 +0200719 environment variable (e.g. "localhost:10.0")
720 If [display] is omitted, then it reinitializes the
721 connection to the X11 server using the same value as
722 was used for the previous execution of this command.
723 If the value was never specified, then it uses the
724 value of $DISPLAY environment variable as it was when
725 Vim was started.
Bram Moolenaar664f3cf2019-12-07 16:03:51 +0100726 {only available when compiled with the |+clipboard|
Bram Moolenaard4aa83a2019-05-09 18:59:31 +0200727 feature}
Bram Moolenaar071d4272004-06-13 20:20:40 +0000728
729 *g_CTRL-A*
730g CTRL-A Only when Vim was compiled with MEM_PROFILING defined
731 (which is very rare): print memory usage statistics.
732 Only useful for debugging Vim.
Bram Moolenaar345efa02016-01-15 20:57:49 +0100733 For incrementing in Visual mode see |v_g_CTRL-A|.
Bram Moolenaar071d4272004-06-13 20:20:40 +0000734
735==============================================================================
Bram Moolenaar24ea3ba2010-09-19 19:01:21 +02007362. Using Vim like less or more *less*
Bram Moolenaar071d4272004-06-13 20:20:40 +0000737
738If you use the less or more program to view a file, you don't get syntax
739highlighting. Thus you would like to use Vim instead. You can do this by
740using the shell script "$VIMRUNTIME/macros/less.sh".
741
742This shell script uses the Vim script "$VIMRUNTIME/macros/less.vim". It sets
743up mappings to simulate the commands that less supports. Otherwise, you can
744still use the Vim commands.
745
746This isn't perfect. For example, when viewing a short file Vim will still use
747the whole screen. But it works good enough for most uses, and you get syntax
748highlighting.
749
750The "h" key will give you a short overview of the available commands.
751
Bram Moolenaare392eb42015-11-19 20:38:09 +0100752If you want to set options differently when using less, define the
753LessInitFunc in your vimrc, for example: >
754
755 func LessInitFunc()
756 set nocursorcolumn nocursorline
757 endfunc
758<
759
Bram Moolenaard2855f52018-07-31 22:23:58 +0200760 vim:tw=78:ts=8:noet:ft=help:norl: