Mercurial > vim
annotate runtime/doc/various.txt @ 18056:624109b3766e v8.1.2023
patch 8.1.2023: no test for synIDattr() returning "strikethrough"
Commit: https://github.com/vim/vim/commit/dcb2b9cb085288d2a2e4cc31abc591ade04e782e
Author: Bram Moolenaar <Bram@vim.org>
Date: Fri Sep 13 21:26:39 2019 +0200
patch 8.1.2023: no test for synIDattr() returning "strikethrough"
Problem: No test for synIDattr() returning "strikethrough".
Solution: Extend the synIDattr() test. (Jaskaran Singh, closes https://github.com/vim/vim/issues/4929)
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Fri, 13 Sep 2019 21:30:03 +0200 |
| parents | 834b7854aa3c |
| children | e0ec4cd7a865 |
| rev | line source |
|---|---|
| 18016 | 1 *various.txt* For Vim version 8.1. Last change: 2019 Sep 04 |
| 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 | |
|
15396
325e4a8ba1b6
patch 8.1.0706: tabline is not always redrawn
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
33 *:redrawt* *:redrawtabline* |
|
325e4a8ba1b6
patch 8.1.0706: tabline is not always redrawn
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
34 :redrawt[abline] Redraw the tabline. Useful to update the tabline when |
|
325e4a8ba1b6
patch 8.1.0706: tabline is not always redrawn
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
35 'tabline' includes an item that doesn't trigger |
|
325e4a8ba1b6
patch 8.1.0706: tabline is not always redrawn
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
36 automatic updating. |
|
325e4a8ba1b6
patch 8.1.0706: tabline is not always redrawn
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
37 |
| 7 | 38 *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* | |
| 47 ga Print the ascii value of the character under the | |
|
13359
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
48 cursor in decimal, hexadecimal and octal. |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
49 Mnemonic: Get Ascii value. |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
50 |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
51 For example, when the cursor is on a 'R': |
| 7 | 52 <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 | |
|
13359
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
55 non-printable version is also given. |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
56 |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
57 When the character is larger than 127, the <M-x> form |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
58 is also printed. For example: |
| 7 | 59 <~A> <M-^A> 129, Hex 81, Octal 201 ~ |
| 60 <p> <|~> <M-~> 254, Hex fe, Octal 376 ~ | |
| 61 (where <p> is a special character) | |
|
13359
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
62 |
| 7 | 63 The <Nul> character in a file is stored internally as |
| 64 <NL>, but it will be shown as: | |
| 65 <^@> 0, Hex 00, Octal 000 ~ | |
|
13359
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
66 |
| 714 | 67 If the character has composing characters these are |
| 68 also shown. The value of 'maxcombine' doesn't matter. | |
|
13359
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
69 |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
70 If the character can be inserted as a digraph, also |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
71 output the two characters that can be used to create |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
72 the character: |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
73 <ö> 246, Hex 00f6, Oct 366, Digr o: ~ |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
74 This shows you can type CTRL-K o : to insert ö. |
|
81c348d40312
patch 8.0.1553: cannot see what digraph is used to insert a character
Christian Brabandt <cb@256bit.org>
parents:
13341
diff
changeset
|
75 |
| 7 | 76 *g8* |
| 77 g8 Print the hex values of the bytes used in the | |
| 78 character under the cursor, assuming it is in |UTF-8| | |
| 714 | 79 encoding. This also shows composing characters. The |
| 80 value of 'maxcombine' doesn't matter. | |
| 81 Example of a character with two composing characters: | |
| 7 | 82 e0 b8 81 + e0 b8 b9 + e0 b9 89 ~ |
| 777 | 83 |
| 84 *8g8* | |
| 85 8g8 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. | |
| 7 | 97 |
| 843 | 98 *:p* *:pr* *:print* *E749* |
| 169 | 99 :[range]p[rint] [flags] |
| 100 Print [range] lines (default current line). | |
| 7 | 101 Note: If you are looking for a way to print your text |
| 169 | 102 on paper see |:hardcopy|. In the GUI you can use the |
| 103 File.Print menu entry. | |
| 104 See |ex-flags| for [flags]. | |
|
10004
8061455d9179
commit https://github.com/vim/vim/commit/818078ddfbb8cc2546f697c5675a251d095722ec
Christian Brabandt <cb@256bit.org>
parents:
9941
diff
changeset
|
105 The |:filter| command can be used to only show lines |
|
8061455d9179
commit https://github.com/vim/vim/commit/818078ddfbb8cc2546f697c5675a251d095722ec
Christian Brabandt <cb@256bit.org>
parents:
9941
diff
changeset
|
106 matching a pattern. |
| 7 | 107 |
| 169 | 108 :[range]p[rint] {count} [flags] |
| 7 | 109 Print {count} lines, starting with [range] (default |
| 110 current line |cmdline-ranges|). | |
| 169 | 111 See |ex-flags| for [flags]. |
| 7 | 112 |
| 113 *:P* *:Print* | |
| 169 | 114 :[range]P[rint] [count] [flags] |
| 7 | 115 Just as ":print". Was apparently added to Vi for |
| 116 people that keep the shift key pressed too long... | |
| 2642 | 117 Note: A user command can overrule this command. |
| 169 | 118 See |ex-flags| for [flags]. |
| 7 | 119 |
| 120 *:l* *:list* | |
| 169 | 121 :[range]l[ist] [count] [flags] |
| 7 | 122 Same as :print, but display unprintable characters |
| 2458 | 123 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
|
124 further changed with the 'listchars' option. |
| 169 | 125 See |ex-flags| for [flags]. |
| 7 | 126 |
| 127 *:nu* *:number* | |
| 169 | 128 :[range]nu[mber] [count] [flags] |
| 7 | 129 Same as :print, but precede each line with its line |
| 677 | 130 number. (See also 'highlight' and 'numberwidth' |
| 131 option). | |
| 169 | 132 See |ex-flags| for [flags]. |
| 7 | 133 |
| 134 *:#* | |
| 169 | 135 :[range]# [count] [flags] |
| 136 synonym for :number. | |
| 7 | 137 |
| 1125 | 138 *:#!* |
| 139 :#!{anything} Ignored, so that you can start a Vim script with: > | |
| 1624 | 140 #!vim -S |
| 1125 | 141 echo "this is a Vim script" |
| 142 quit | |
| 143 < | |
| 7 | 144 *: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 | |
| 164 | 148 how many lines you'll see; if there is only one window |
| 2725 | 149 then twice the value of the 'scroll' option is used, |
| 150 otherwise the current window height minus 3 is used. | |
| 7 | 151 |
| 3237 | 152 If there is a {count} the 'window' option is set to |
| 153 its value. | |
| 154 | |
| 7 | 155 :z can be used either alone or followed by any of |
| 156 several punctuation marks. These have the following | |
| 157 effect: | |
| 158 | |
| 2725 | 159 mark first line last line new cursor line ~ |
| 7 | 160 ---- ---------- --------- ------------ |
| 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 | |
| 159 | 164 . 1/2 scr back 1/2 scr fwd 1/2 scr fwd |
| 165 = 1/2 scr back 1/2 scr fwd current line | |
| 7 | 166 |
| 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. | |
| 173 | |
| 174 *:=* | |
| 169 | 175 := [flags] Print the last line number. |
| 176 See |ex-flags| for [flags]. | |
| 7 | 177 |
| 169 | 178 :{range}= [flags] Prints the last line number in {range}. For example, |
| 7 | 179 this prints the current line number: > |
| 180 :.= | |
| 169 | 181 < See |ex-flags| for [flags]. |
| 7 | 182 |
| 183 :norm[al][!] {commands} *:norm* *:normal* | |
| 184 Execute Normal mode commands {commands}. This makes | |
| 185 it possible to execute Normal mode commands typed on | |
| 2596 | 186 the command-line. {commands} are executed like they |
| 187 are typed. For undo all commands are undone together. | |
| 1125 | 188 Execution stops when an error is encountered. |
| 4073 | 189 |
| 7 | 190 If the [!] is given, mappings will not be used. |
| 4073 | 191 Without it, when this command is called from a |
| 192 non-remappable mapping (|:noremap|), the argument can | |
| 193 be mapped anyway. | |
| 194 | |
| 7 | 195 {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. | |
| 198 This implies that an insert command must be completed | |
| 199 (to start Insert mode, see |:startinsert|). A ":" | |
| 161 | 200 command must be completed as well. And you can't use |
| 201 "Q" or "gQ" to start Ex mode. | |
| 4073 | 202 |
| 203 The display is not updated while ":normal" is busy. | |
| 204 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1989
diff
changeset
|
205 {commands} cannot start with a space. Put a count of |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1989
diff
changeset
|
206 1 (one) before it, "1 " is one space. |
| 4073 | 207 |
| 7 | 208 The 'insertmode' option is ignored for {commands}. |
| 4073 | 209 |
| 7 | 210 This command cannot be followed by another command, |
| 211 since any '|' is considered part of the command. | |
| 4073 | 212 |
| 7 | 213 This command can be used recursively, but the depth is |
| 214 limited by 'maxmapdepth'. | |
| 4073 | 215 |
| 7 | 216 An alternative is to use |:execute|, which uses an |
| 217 expression as argument. This allows the use of | |
| 2264 | 218 printable characters to represent special characters. |
| 4073 | 219 |
| 2264 | 220 Example: > |
| 7 | 221 :exe "normal \<c-w>\<c-w>" |
| 222 | |
| 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. | |
| 229 | |
| 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. | |
| 5814 | 243 |
| 7 | 244 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 ! \!". | |
| 5814 | 249 |
| 1624 | 250 A '|' in {cmd} is passed to the shell, you cannot use |
| 251 it to append a Vim command. See |:bar|. | |
| 5814 | 252 |
| 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 < | |
| 7 | 263 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. | |
| 5814 | 269 |
| 7 | 270 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|. | |
| 5814 | 274 |
| 5908 | 275 After the command has been executed, the timestamp and |
| 276 size of the current file is checked |timestamp|. | |
| 5814 | 277 |
| 7 | 278 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 | |
| 16944 | 291 *:ve* *:ver* *:version* |
| 7 | 292 :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: | |
| 13437 | 305 T tiny (always) |
| 7 | 306 S small |
| 307 N normal | |
| 308 B big | |
| 309 H huge | |
| 310 m manually enabled or depends on other features | |
| 311 (none) system dependent | |
| 312 Thus if a feature is marked with "N", it is included | |
| 313 in the normal, big and huge versions of Vim. | |
| 314 | |
| 315 *+feature-list* | |
| 5340 | 316 *+acl* |ACL| support included |
| 7 | 317 *+ARP* Amiga only: ARP support included |
| 318 B *+arabic* |Arabic| language support | |
| 13437 | 319 T *+autocmd* |:autocmd|, automatic commands |
|
12837
963cdeb42c41
patch 8.0.1295: cannot automatically get a server name in a terminal
Christian Brabandt <cb@256bit.org>
parents:
12785
diff
changeset
|
320 H *+autoservername* Automatically enable |clientserver| |
| 12909 | 321 m *+balloon_eval* |balloon-eval| support in the GUI. Included when |
| 322 compiling with supported GUI (Motif, GTK, GUI) and | |
| 323 either Netbeans/Sun Workshop integration or |+eval| | |
| 324 feature. | |
| 325 H *+balloon_eval_term* |balloon-eval| support in the terminal, | |
| 326 'balloonevalterm' | |
| 7 | 327 N *+browse* |:browse| command |
| 328 N *+builtin_terms* some terminals builtin |builtin-terms| | |
| 329 B *++builtin_terms* maximal terminals builtin |builtin-terms| | |
| 330 N *+byte_offset* support for 'o' flag in 'statusline' option, "go" | |
| 331 and ":goto" commands. | |
|
7790
ca19726d5e83
commit https://github.com/vim/vim/commit/298b440930ecece38d6ea0505a3e582dc817e79b
Christian Brabandt <cb@256bit.org>
parents:
7597
diff
changeset
|
332 m *+channel* inter process communication |channel| |
| 7 | 333 N *+cindent* |'cindent'|, C indenting |
| 334 N *+clientserver* Unix and Win32: Remote invocation |clientserver| | |
| 17758 | 335 *+clipboard* |clipboard| support compiled-in |
| 336 *+clipboard_working* |clipboard| support compiled-in and working | |
| 17909 | 337 T *+cmdline_compl* command line completion |cmdline-completion| |
| 12499 | 338 S *+cmdline_hist* command line history |cmdline-history| |
| 7 | 339 N *+cmdline_info* |'showcmd'| and |'ruler'| |
| 340 N *+comments* |'comments'| support | |
|
2382
3a5ededa240a
Add the 'c' flag to 'concealcursor'.
Bram Moolenaar <bram@vim.org>
parents:
2368
diff
changeset
|
341 B *+conceal* "conceal" support, see |conceal| |:syn-conceal| etc. |
| 7 | 342 N *+cryptv* encryption support |encryption| |
| 343 B *+cscope* |cscope| support | |
| 13437 | 344 T *+cursorbind* |'cursorbind'| support |
| 500 | 345 m *+cursorshape* |termcap-cursor-shape| support |
| 346 m *+debug* Compiled for debugging. | |
| 7 | 347 N *+dialog_gui* Support for |:confirm| with GUI dialog. |
| 348 N *+dialog_con* Support for |:confirm| with console dialog. | |
| 349 N *+dialog_con_gui* Support for |:confirm| with GUI and console dialog. | |
| 350 N *+diff* |vimdiff| and 'diff' | |
| 351 N *+digraphs* |digraphs| *E196* | |
|
13468
539436dcb134
patch 8.0.1608: Win32: directx not enabled by default
Christian Brabandt <cb@256bit.org>
parents:
13437
diff
changeset
|
352 *+directx* Win32 GUI only: DirectX and |'renderoptions'| |
| 7 | 353 *+dnd* Support for DnD into the "~ register |quote_~|. |
| 354 B *+emacs_tags* |emacs-tags| files | |
| 355 N *+eval* expression evaluation |eval.txt| | |
|
7876
93f747af7b58
commit https://github.com/vim/vim/commit/5e9b2fa9bb0e6061cf18457c173cd141a5dc9c92
Christian Brabandt <cb@256bit.org>
parents:
7790
diff
changeset
|
356 N *+ex_extra* always on now, used to be for Vim's extra Ex commands |
| 7 | 357 N *+extra_search* |'hlsearch'| and |'incsearch'| options. |
| 358 B *+farsi* |farsi| language | |
| 359 N *+file_in_path* |gf|, |CTRL-W_f| and |<cfile>| | |
| 360 N *+find_in_path* include file searches: |[I|, |:isearch|, | |
| 361 |CTRL-W_CTRL-I|, |:checkpath|, etc. | |
| 362 N *+folding* |folding| | |
| 363 *+footer* |gui-footer| | |
| 364 *+fork* Unix only: |fork| shell commands | |
| 1624 | 365 *+float* Floating point support |
| 7 | 366 N *+gettext* message translations |multi-lang| |
| 367 *+GUI_Athena* Unix only: Athena |GUI| | |
| 368 *+GUI_neXtaw* Unix only: neXtaw |GUI| | |
| 369 *+GUI_GTK* Unix only: GTK+ |GUI| | |
| 370 *+GUI_Motif* Unix only: Motif |GUI| | |
| 371 *+GUI_Photon* QNX only: Photon |GUI| | |
| 372 m *+hangul_input* Hangul input support |hangul| | |
| 557 | 373 *+iconv* Compiled with the |iconv()| function |
| 374 *+iconv/dyn* Likewise |iconv-dynamic| |/dyn| | |
| 17909 | 375 T *+insert_expand* |insert_expand| Insert mode completion |
|
8061
abd64cf67bcf
commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents:
7876
diff
changeset
|
376 m *+job* starting and stopping jobs |job| |
| 12499 | 377 S *+jumplist* |jumplist| |
| 7 | 378 B *+keymap* |'keymap'| |
|
9737
35ce559b8553
commit https://github.com/vim/vim/commit/bc8801c9317eb721a2ee91322669f2dd5d136380
Christian Brabandt <cb@256bit.org>
parents:
9464
diff
changeset
|
379 N *+lambda* |lambda| and |closure| |
| 7 | 380 B *+langmap* |'langmap'| |
| 381 N *+libcall* |libcall()| | |
| 382 N *+linebreak* |'linebreak'|, |'breakat'| and |'showbreak'| | |
| 383 N *+lispindent* |'lisp'| | |
|
13553
04019fc3de93
patch 8.0.1650: too many #ifdefs
Christian Brabandt <cb@256bit.org>
parents:
13482
diff
changeset
|
384 T *+listcmds* Vim commands for the list of buffers |buffer-hidden| |
| 7 | 385 and argument list |:argdelete| |
| 17667 | 386 T *+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
|
387 m *+lua* |Lua| interface |
|
966a5609669e
Added Lua interfae. (Luis Carvalho)
Bram Moolenaar <bram@vim.org>
parents:
2264
diff
changeset
|
388 m *+lua/dyn* |Lua| interface |/dyn| |
| 7 | 389 N *+menu* |:menu| |
| 390 N *+mksession* |:mksession| | |
| 18016 | 391 T *+modify_fname* |filename-modifiers| |
| 7 | 392 N *+mouse* Mouse handling |mouse-using| |
| 393 N *+mouseshape* |'mouseshape'| | |
| 394 B *+mouse_dec* Unix only: Dec terminal mouse handling |dec-mouse| | |
| 395 N *+mouse_gpm* Unix only: Linux console mouse handling |gpm-mouse| | |
| 5929 | 396 N *+mouse_jsbterm* JSB mouse handling |jsbterm-mouse| |
| 7 | 397 B *+mouse_netterm* Unix only: netterm mouse handling |netterm-mouse| |
| 3996 | 398 N *+mouse_pterm* QNX only: pterm mouse handling |qnx-terminal| |
| 1624 | 399 N *+mouse_sysmouse* Unix only: *BSD console mouse handling |sysmouse| |
| 3750 | 400 B *+mouse_sgr* Unix only: sgr mouse handling |sgr-mouse| |
| 3996 | 401 B *+mouse_urxvt* Unix only: urxvt mouse handling |urxvt-mouse| |
| 402 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
|
403 N *+multi_byte* 16 and 32 bit characters |multibyte| |
| 7 | 404 *+multi_byte_ime* Win32 input method for multibyte chars |multibyte-ime| |
| 3996 | 405 N *+multi_lang* non-English language support |multi-lang| |
| 14 | 406 m *+mzscheme* Mzscheme interface |mzscheme| |
| 625 | 407 m *+mzscheme/dyn* Mzscheme interface |mzscheme-dynamic| |/dyn| |
| 7 | 408 m *+netbeans_intg* |netbeans| |
|
9389
32e34e574716
commit https://github.com/vim/vim/commit/22fcfad29276bd5f317faf516637dcd491b96a12
Christian Brabandt <cb@256bit.org>
parents:
9116
diff
changeset
|
409 *+num64* 64-bit Number support |Number| |
| 3996 | 410 m *+ole* Win32 GUI only: |ole-interface| |
|
9076
9305a1251e51
commit https://github.com/vim/vim/commit/91c4937be15b0b743b6bc495df602c1abbff6b87
Christian Brabandt <cb@256bit.org>
parents:
9027
diff
changeset
|
411 N *+packages* Loading |packages| |
| 3996 | 412 N *+path_extra* Up/downwards search in 'path' and 'tags' |
| 557 | 413 m *+perl* Perl interface |perl| |
| 414 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
|
415 N *+persistent_undo* Persistent undo |undo-persistence| |
| 3996 | 416 *+postscript* |:hardcopy| writes a PostScript file |
| 7 | 417 N *+printer* |:hardcopy| command |
| 179 | 418 H *+profile* |:profile| command |
| 2368 | 419 m *+python* Python 2 interface |python| |
| 3996 | 420 m *+python/dyn* Python 2 interface |python-dynamic| |/dyn| |
| 2368 | 421 m *+python3* Python 3 interface |python| |
| 3996 | 422 m *+python3/dyn* Python 3 interface |python-dynamic| |/dyn| |
| 7 | 423 N *+quickfix* |:make| and |quickfix| commands |
| 1624 | 424 N *+reltime* |reltime()| function, 'hlsearch'/'incsearch' timeout, |
| 425 'redrawtime' option | |
| 7 | 426 B *+rightleft* Right to left typing |'rightleft'| |
| 557 | 427 m *+ruby* Ruby interface |ruby| |
| 428 m *+ruby/dyn* Ruby interface |ruby-dynamic| |/dyn| | |
|
13482
9eebe457eb3c
Update runtime files. Convert a couple of help files to utf-8.
Christian Brabandt <cb@256bit.org>
parents:
13468
diff
changeset
|
429 T *+scrollbind* |'scrollbind'| |
| 7 | 430 B *+signs* |:sign| |
| 3996 | 431 N *+smartindent* |'smartindent'| |
| 17036 | 432 B *+sound* |sound_playevent()|, |sound_playfile()| functions, etc. |
| 433 N *+spell* spell checking support, see |spell| | |
| 3996 | 434 N *+startuptime* |--startuptime| argument |
| 435 N *+statusline* Options 'statusline', 'rulerformat' and special | |
| 7 | 436 formats of 'titlestring' and 'iconstring' |
| 15512 | 437 m *+sun_workshop* |workshop|; no longer supported |
| 7 | 438 N *+syntax* Syntax highlighting |syntax| |
| 439 *+system()* Unix only: opposite of |+fork| | |
|
10140
b11ceef7116e
commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents:
10004
diff
changeset
|
440 T *+tag_binary* binary searching in tags file |tag-binary-search| |
| 7 | 441 N *+tag_old_static* old method for static tags |tag-old-static| |
| 16086 | 442 m *+tag_any_white* Removed; was to allow any white space in tags files |
| 3996 | 443 m *+tcl* Tcl interface |tcl| |
| 557 | 444 m *+tcl/dyn* Tcl interface |tcl-dynamic| |/dyn| |
| 12045 | 445 m *+terminal* Support for terminal window |terminal| |
| 7 | 446 *+terminfo* uses |terminfo| instead of termcap |
| 447 N *+termresponse* support for |t_RV| and |v:termresponse| | |
|
9027
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
448 B *+termguicolors* 24-bit color in xterm-compatible terminals support |
| 3996 | 449 N *+textobjects* |text-objects| selection |
| 15194 | 450 N *+textprop* |text-properties| |
| 7 | 451 *+tgetent* non-Unix only: able to use external termcap |
|
8673
ed7251c3e2d3
commit https://github.com/vim/vim/commit/e18c0b39815c5a746887a509c2cd9f11fadaba07
Christian Brabandt <cb@256bit.org>
parents:
8303
diff
changeset
|
452 N *+timers* the |timer_start()| function |
| 1125 | 453 N *+title* Setting the window 'title' and 'icon' |
| 7 | 454 N *+toolbar* |gui-toolbar| |
|
16411
5b5c5daf57de
patch 8.1.1210: support for user commands is spread out
Bram Moolenaar <Bram@vim.org>
parents:
16086
diff
changeset
|
455 T *+user_commands* User-defined commands. |user-commands| |
|
5b5c5daf57de
patch 8.1.1210: support for user commands is spread out
Bram Moolenaar <Bram@vim.org>
parents:
16086
diff
changeset
|
456 Always enabled since 8.1.1210. |
|
14175
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
457 B *+vartabs* Variable-width tabstops. |'vartabstop'| |
| 7 | 458 N *+viminfo* |'viminfo'| |
| 12499 | 459 *+vertsplit* Vertically split windows |:vsplit|; Always enabled |
| 460 since 8.0.1118. | |
| 3996 | 461 N *+virtualedit* |'virtualedit'| |
|
15422
b55b89692fd2
patch 8.1.0719: too many #ifdefs
Bram Moolenaar <Bram@vim.org>
parents:
15396
diff
changeset
|
462 T *+visual* Visual mode |Visual-mode| Always enabled since 7.4.200. |
|
b55b89692fd2
patch 8.1.0719: too many #ifdefs
Bram Moolenaar <Bram@vim.org>
parents:
15396
diff
changeset
|
463 T *+visualextra* extra Visual mode commands |blockwise-operators| |
|
14424
0a69e6e708f9
patch 8.1.0226: too many #ifdefs
Christian Brabandt <cb@256bit.org>
parents:
14175
diff
changeset
|
464 T *+vreplace* |gR| and |gr| |
|
13341
acd7eaa13d2b
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
12909
diff
changeset
|
465 *+vtp* on MS-Windows console: support for 'termguicolors' |
| 3996 | 466 N *+wildignore* |'wildignore'| |
| 7 | 467 N *+wildmenu* |'wildmenu'| |
|
15422
b55b89692fd2
patch 8.1.0719: too many #ifdefs
Bram Moolenaar <Bram@vim.org>
parents:
15396
diff
changeset
|
468 T *+windows* more than one window; Always enabled since 8.0.1118. |
| 3996 | 469 m *+writebackup* |'writebackup'| is default on |
| 470 m *+xim* X input method |xim| | |
| 7 | 471 *+xfontset* X fontset support |xfontset| |
| 5340 | 472 *+xpm* pixmap support |
| 3750 | 473 m *+xpm_w32* Win32 GUI only: pixmap support |w32-xpm-support| |
| 7 | 474 *+xsmp* XSMP (X session management) support |
| 475 *+xsmp_interact* interactive XSMP (X session management) support | |
| 476 N *+xterm_clipboard* Unix only: xterm clipboard handling | |
| 3996 | 477 m *+xterm_save* save and restore xterm screen |xterm-screens| |
| 478 N *+X11* Unix only: can restore window title |X11| | |
| 7 | 479 |
| 480 */dyn* *E370* *E448* | |
| 481 To some of the features "/dyn" is added when the | |
| 482 feature is only available when the related library can | |
| 483 be dynamically loaded. | |
| 484 | |
| 485 :ve[rsion] {nr} Is now ignored. This was previously used to check the | |
| 486 version number of a .vimrc file. It was removed, | |
| 487 because you can now use the ":if" command for | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
488 version-dependent behavior. |
| 7 | 489 |
| 490 *:redi* *:redir* | |
| 491 :redi[r][!] > {file} Redirect messages to file {file}. The messages which | |
| 492 are the output of commands are written to that file, | |
| 493 until redirection ends. The messages are also still | |
| 494 shown on the screen. When [!] is included, an | |
| 495 existing file is overwritten. When [!] is omitted, | |
| 496 and {file} exists, this command fails. | |
|
9464
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
497 |
| 7 | 498 Only one ":redir" can be active at a time. Calls to |
| 499 ":redir" will close any active redirection before | |
|
9464
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
500 starting redirection to the new target. For recursive |
|
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
501 use check out |execute()|. |
|
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
502 |
| 7 | 503 To stop the messages and commands from being echoed to |
| 504 the screen, put the commands in a function and call it | |
| 505 with ":silent call Function()". | |
| 294 | 506 An alternative is to use the 'verbosefile' option, |
| 507 this can be used in combination with ":redir". | |
| 7 | 508 |
| 509 :redi[r] >> {file} Redirect messages to file {file}. Append if {file} | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
510 already exists. |
| 7 | 511 |
| 1624 | 512 :redi[r] @{a-zA-Z} |
| 298 | 513 :redi[r] @{a-zA-Z}> Redirect messages to register {a-z}. Append to the |
| 7 | 514 contents of the register if its name is given |
| 1624 | 515 uppercase {A-Z}. The ">" after the register name is |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
516 optional. |
|
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
517 :redi[r] @{a-z}>> Append messages to register {a-z}. |
| 7 | 518 |
| 1125 | 519 :redi[r] @*> |
| 520 :redi[r] @+> Redirect messages to the selection or clipboard. For | |
| 521 backward compatibility, the ">" after the register | |
| 522 name can be omitted. See |quotestar| and |quoteplus|. | |
| 523 :redi[r] @*>> | |
| 524 :redi[r] @+>> Append messages to the selection or clipboard. | |
| 7 | 525 |
| 298 | 526 :redi[r] @"> Redirect messages to the unnamed register. For |
| 527 backward compatibility, the ">" after the register | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
528 name can be omitted. |
|
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
529 :redi[r] @">> Append messages to the unnamed register. |
| 7 | 530 |
| 169 | 531 :redi[r] => {var} Redirect messages to a variable. If the variable |
| 532 doesn't exist, then it is created. If the variable | |
| 533 exists, then it is initialized to an empty string. | |
| 1125 | 534 The variable will remain empty until redirection ends. |
| 169 | 535 Only string variables can be used. After the |
| 536 redirection starts, if the variable is removed or | |
| 537 locked or the variable type is changed, then further | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
538 command output messages will cause errors. |
|
9464
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
539 To get the output of one command the |execute()| |
|
be72f4201a1d
commit https://github.com/vim/vim/commit/063b9d15abea041a5bfff3ffc4e219e26fd1d4fa
Christian Brabandt <cb@256bit.org>
parents:
9389
diff
changeset
|
540 function can be used. |
| 169 | 541 |
| 542 :redi[r] =>> {var} Append messages to an existing variable. Only string | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
543 variables can be used. |
| 169 | 544 |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
545 :redi[r] END End redirecting messages. |
| 7 | 546 |
|
9941
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
547 *:filt* *:filter* |
| 11062 | 548 :filt[er][!] {pat} {command} |
| 549 :filt[er][!] /{pat}/ {command} | |
| 550 Restrict the output of {command} to lines matching | |
| 551 with {pat}. For example, to list only xml files: > | |
|
10004
8061455d9179
commit https://github.com/vim/vim/commit/818078ddfbb8cc2546f697c5675a251d095722ec
Christian Brabandt <cb@256bit.org>
parents:
9941
diff
changeset
|
552 :filter /\.xml$/ oldfiles |
| 11062 | 553 < If the [!] is given, restrict the output of {command} |
| 554 to lines that do NOT match {pat}. | |
| 555 | |
|
9941
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
556 {pat} is a Vim search pattern. Instead of enclosing |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
557 it in / any non-ID character (see |'isident'|) can be |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
558 used, so long as it does not appear in {pat}. Without |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
559 the enclosing character the pattern cannot include the |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
560 bar character. |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
561 |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
562 The pattern is matched against the relevant part of |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
563 the output, not necessarily the whole line. Only some |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
564 commands support filtering, try it out to check if it |
|
14968
c5ec5ddbe814
patch 8.1.0495: :filter only supports some commands
Bram Moolenaar <Bram@vim.org>
parents:
14432
diff
changeset
|
565 works. Some of the commands that support filtering: |
|
16433
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
566 |:#| - filter whole line |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
567 |:clist| - filter by file name or module name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
568 |:command| - filter by command name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
569 |:files| - filter by file name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
570 |:highlight| - filter by highlight group |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
571 |:jumps| - filter by file name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
572 |:let| - filter by variable name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
573 |:list| - filter whole line |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
574 |:llist| - filter by file name or module name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
575 |:marks| - filter by text in the current file, |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
576 or file name for other files |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
577 |:oldfiles| - filter by file name |
|
9c206a78ec04
patch 8.1.1221: filtering does not work when listing marks
Bram Moolenaar <Bram@vim.org>
parents:
16411
diff
changeset
|
578 |:set| - filter by variable name |
|
9941
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
579 |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
580 Only normal messages are filtered, error messages are |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
581 not. |
|
e975914c17e9
commit https://github.com/vim/vim/commit/7b668e83d0635d082b7ec90d7d2aa30a9d7d8928
Christian Brabandt <cb@256bit.org>
parents:
9737
diff
changeset
|
582 |
|
8148
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
583 *:sil* *:silent* *:silent!* |
| 7 | 584 :sil[ent][!] {command} Execute {command} silently. Normal messages will not |
| 585 be given or added to the message history. | |
| 586 When [!] is added, error messages will also be | |
| 587 skipped, and commands and mappings will not be aborted | |
| 588 when an error is detected. |v:errmsg| is still set. | |
| 589 When [!] is not used, an error message will cause | |
| 590 further messages to be displayed normally. | |
| 591 Redirection, started with |:redir|, will continue as | |
| 592 usual, although there might be small differences. | |
| 593 This will allow redirecting the output of a command | |
| 594 without seeing it on the screen. Example: > | |
| 595 :redir >/tmp/foobar | |
| 596 :silent g/Aap/p | |
| 597 :redir END | |
| 598 < To execute a Normal mode command silently, use the | |
| 599 |:normal| command. For example, to search for a | |
| 600 string without messages: > | |
| 601 :silent exe "normal /path\<CR>" | |
| 602 < ":silent!" is useful to execute a command that may | |
| 603 fail, but the failure is to be ignored. Example: > | |
| 604 :let v:errmsg = "" | |
| 605 :silent! /^begin | |
| 606 :if v:errmsg != "" | |
| 607 : ... pattern was not found | |
| 608 < ":silent" will also avoid the hit-enter prompt. When | |
| 609 using this for an external command, this may cause the | |
| 610 screen to be messed up. Use |CTRL-L| to clean it up | |
| 611 then. | |
| 612 ":silent menu ..." defines a menu that will not echo a | |
| 613 Command-line command. The command will still produce | |
| 614 messages though. Use ":silent" in the command itself | |
| 615 to avoid that: ":silent menu .... :silent command". | |
| 616 | |
| 1926 | 617 *:uns* *:unsilent* |
| 618 :uns[ilent] {command} Execute {command} not silently. Only makes a | |
| 619 difference when |:silent| was used to get to this | |
| 620 command. | |
| 621 Use this for giving a message even when |:silent| was | |
| 622 used. In this example |:silent| is used to avoid the | |
| 623 message about reading the file and |:unsilent| to be | |
| 624 able to list the first line of each file. > | |
| 625 :silent argdo unsilent echo expand('%') . ": " . getline(1) | |
| 626 < | |
| 627 | |
| 7 | 628 *:verb* *:verbose* |
| 629 :[count]verb[ose] {command} | |
| 630 Execute {command} with 'verbose' set to [count]. If | |
| 8 | 631 [count] is omitted one is used. ":0verbose" can be |
| 632 used to set 'verbose' to zero. | |
| 7 | 633 The additional use of ":silent" makes messages |
| 634 generated but not displayed. | |
| 635 The combination of ":silent" and ":verbose" can be | |
| 636 used to generate messages and check them with | |
| 637 |v:statusmsg| and friends. For example: > | |
| 638 :let v:statusmsg = "" | |
| 639 :silent verbose runtime foobar.vim | |
| 640 :if v:statusmsg != "" | |
| 641 : " foobar.vim could not be found | |
| 642 :endif | |
| 643 < When concatenating another command, the ":verbose" | |
| 644 only applies to the first one: > | |
| 645 :4verbose set verbose | set verbose | |
| 646 < verbose=4 ~ | |
| 647 verbose=0 ~ | |
| 294 | 648 For logging verbose messages in a file use the |
| 649 'verbosefile' option. | |
| 7 | 650 |
| 484 | 651 *:verbose-cmd* |
| 652 When 'verbose' is non-zero, listing the value of a Vim option or a key map or | |
| 502 | 653 an abbreviation or a user-defined function or a command or a highlight group |
| 654 or an autocommand will also display where it was last defined. If it was | |
| 655 defined manually then there will be no "Last set" message. When it was | |
| 656 defined while executing a function, user command or autocommand, the script in | |
| 657 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
|
658 {not available when compiled without the |+eval| feature} |
| 484 | 659 |
| 7 | 660 *K* |
| 661 K Run a program to lookup the keyword under the | |
| 662 cursor. The name of the program is given with the | |
| 663 'keywordprg' (kp) option (default is "man"). The | |
| 664 keyword is formed of letters, numbers and the | |
| 665 characters in 'iskeyword'. The keyword under or | |
| 666 right of the cursor is used. The same can be done | |
| 667 with the command > | |
| 668 :!{program} {keyword} | |
| 669 < There is an example of a program to use in the tools | |
| 11062 | 670 directory of Vim. It is called "ref" and does a |
| 7 | 671 simple spelling check. |
| 672 Special cases: | |
|
9116
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
673 - If 'keywordprg' begins with ":" it is invoked as |
|
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
674 a Vim Ex command with [count]. |
| 7 | 675 - If 'keywordprg' is empty, the ":help" command is |
| 676 used. It's a good idea to include more characters | |
| 677 in 'iskeyword' then, to be able to find more help. | |
|
9116
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
678 - When 'keywordprg' is equal to "man" or starts with |
|
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
679 ":", a [count] before "K" is inserted after |
|
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
680 keywordprg and before the keyword. For example, |
|
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
681 using "2K" while the cursor is on "mkdir", results |
|
bc38030aec7d
commit https://github.com/vim/vim/commit/26852128a2b713ef49341a0c18daba928444e7eb
Christian Brabandt <cb@256bit.org>
parents:
9076
diff
changeset
|
682 in: > |
| 7 | 683 !man 2 mkdir |
| 684 < - When 'keywordprg' is equal to "man -s", a count | |
| 685 before "K" is inserted after the "-s". If there is | |
| 686 no count, the "-s" is removed. | |
| 687 | |
| 688 *v_K* | |
| 689 {Visual}K Like "K", but use the visually highlighted text for | |
| 690 the keyword. Only works when the highlighted text is | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
691 not more than one line. |
| 7 | 692 |
| 693 [N]gs *gs* *:sl* *:sleep* | |
| 694 :[N]sl[eep] [N] [m] Do nothing for [N] seconds. When [m] is included, | |
| 237 | 695 sleep for [N] milliseconds. The count for "gs" always |
| 7 | 696 uses seconds. The default is one second. > |
| 697 :sleep "sleep for one second | |
| 698 :5sleep "sleep for five seconds | |
| 699 :sleep 100m "sleep for a hundred milliseconds | |
| 700 10gs "sleep for ten seconds | |
| 701 < Can be interrupted with CTRL-C (CTRL-Break on MS-DOS). | |
| 140 | 702 "gs" stands for "goto sleep". |
| 703 While sleeping the cursor is positioned in the text, | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
16433
diff
changeset
|
704 if at a visible position. |
| 3153 | 705 Also process the received netbeans messages. {only |
| 706 available when compiled with the |+netbeans_intg| | |
| 707 feature} | |
| 708 | |
|
16608
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
709 *:xrestore* *:xr* |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
710 :xr[estore] [display] Reinitializes the connection to the X11 server. Useful |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
711 after the X server restarts, e.g. when running Vim for |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
712 long time inside screen/tmux and connecting from |
| 16808 | 713 different machines. |
|
16608
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
714 [display] should be in the format of the $DISPLAY |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
715 environment variable (e.g. "localhost:10.0") |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
716 If [display] is omitted, then it reinitializes the |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
717 connection to the X11 server using the same value as |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
718 was used for the previous execution of this command. |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
719 If the value was never specified, then it uses the |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
720 value of $DISPLAY environment variable as it was when |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
721 Vim was started. |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
722 {only available when compiled with the |+clipboard| |
|
0422b14bce58
patch 8.1.1307: cannot reconnect to the X server after it restarted
Bram Moolenaar <Bram@vim.org>
parents:
16553
diff
changeset
|
723 feature} |
| 7 | 724 |
| 725 *g_CTRL-A* | |
| 726 g CTRL-A Only when Vim was compiled with MEM_PROFILING defined | |
| 727 (which is very rare): print memory usage statistics. | |
| 728 Only useful for debugging Vim. | |
|
7597
3012eaddb6b2
commit https://github.com/vim/vim/commit/345efa013dc6d1754ba06e5596a26c48c9935937
Christian Brabandt <cb@256bit.org>
parents:
7245
diff
changeset
|
729 For incrementing in Visual mode see |v_g_CTRL-A|. |
| 7 | 730 |
| 731 ============================================================================== | |
| 2581 | 732 2. Using Vim like less or more *less* |
| 7 | 733 |
| 734 If you use the less or more program to view a file, you don't get syntax | |
| 735 highlighting. Thus you would like to use Vim instead. You can do this by | |
| 736 using the shell script "$VIMRUNTIME/macros/less.sh". | |
| 737 | |
| 738 This shell script uses the Vim script "$VIMRUNTIME/macros/less.vim". It sets | |
| 739 up mappings to simulate the commands that less supports. Otherwise, you can | |
| 740 still use the Vim commands. | |
| 741 | |
| 742 This isn't perfect. For example, when viewing a short file Vim will still use | |
| 743 the whole screen. But it works good enough for most uses, and you get syntax | |
| 744 highlighting. | |
| 745 | |
| 746 The "h" key will give you a short overview of the available commands. | |
| 747 | |
|
7245
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
748 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
|
749 LessInitFunc in your vimrc, for example: > |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
750 |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
751 func LessInitFunc() |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
752 set nocursorcolumn nocursorline |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
753 endfunc |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
754 < |
|
8896150aba23
commit https://github.com/vim/vim/commit/e392eb41f8dfc01bd13634e534ac6b4d505326f4
Christian Brabandt <cb@256bit.org>
parents:
6153
diff
changeset
|
755 |
| 14432 | 756 vim:tw=78:ts=8:noet:ft=help:norl: |