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