Bram Moolenaar | 7e6a515 | 2021-01-02 16:39:53 +0100 | [diff] [blame] | 1 | *message.txt* For Vim version 8.2. Last change: 2020 Dec 29 |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 2 | |
| 3 | |
| 4 | VIM REFERENCE MANUAL by Bram Moolenaar |
| 5 | |
| 6 | |
| 7 | This file contains an alphabetical list of messages and error messages that |
| 8 | Vim produces. You can use this if you don't understand what the message |
| 9 | means. It is not complete though. |
| 10 | |
| 11 | 1. Old messages |:messages| |
| 12 | 2. Error messages |error-messages| |
| 13 | 3. Messages |messages| |
| 14 | |
| 15 | ============================================================================== |
| 16 | 1. Old messages *:messages* *:mes* *message-history* |
| 17 | |
| 18 | The ":messages" command can be used to view previously given messages. This |
| 19 | is especially useful when messages have been overwritten or truncated. This |
| 20 | depends on the 'shortmess' option. |
| 21 | |
Bram Moolenaar | 207f009 | 2020-08-30 17:20:20 +0200 | [diff] [blame] | 22 | :mes[sages] Show all messages. |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 23 | |
Bram Moolenaar | 207f009 | 2020-08-30 17:20:20 +0200 | [diff] [blame] | 24 | :{count}mes[sages] Show the {count} most recent messages. |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 25 | |
Bram Moolenaar | 207f009 | 2020-08-30 17:20:20 +0200 | [diff] [blame] | 26 | :mes[sages] clear Clear all messages. |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 27 | |
Bram Moolenaar | 207f009 | 2020-08-30 17:20:20 +0200 | [diff] [blame] | 28 | :{count}mes[sages] clear |
| 29 | Clear messages, keeping only the {count} most |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 30 | recent ones. |
| 31 | |
Bram Moolenaar | 6773b2b | 2010-05-30 16:01:37 +0200 | [diff] [blame] | 32 | The number of remembered messages is fixed at 20 for the tiny version and 200 |
Bram Moolenaar | 4770d09 | 2006-01-12 23:22:24 +0000 | [diff] [blame] | 33 | for other versions. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 34 | |
Bram Moolenaar | cfc7d63 | 2005-07-28 22:28:16 +0000 | [diff] [blame] | 35 | *g<* |
| 36 | The "g<" command can be used to see the last page of previous command output. |
Bram Moolenaar | 1e01546 | 2005-09-25 22:16:38 +0000 | [diff] [blame] | 37 | This is especially useful if you accidentally typed <Space> at the hit-enter |
Bram Moolenaar | dd2a3cd | 2007-05-05 17:10:09 +0000 | [diff] [blame] | 38 | prompt. You are then back at the hit-enter prompt and can then scroll further |
| 39 | back. |
Bram Moolenaar | 446beb4 | 2011-05-10 17:18:44 +0200 | [diff] [blame] | 40 | Note: If the output has been stopped with "q" at the more prompt, it will only |
| 41 | be displayed up to this point. |
Bram Moolenaar | cfc7d63 | 2005-07-28 22:28:16 +0000 | [diff] [blame] | 42 | The previous command output is cleared when another command produces output. |
Bram Moolenaar | 64d8e25 | 2016-09-06 22:12:34 +0200 | [diff] [blame] | 43 | The "g<" output is not redirected. |
Bram Moolenaar | cfc7d63 | 2005-07-28 22:28:16 +0000 | [diff] [blame] | 44 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 45 | If you are using translated messages, the first printed line tells who |
| 46 | maintains the messages or the translations. You can use this to contact the |
| 47 | maintainer when you spot a mistake. |
| 48 | |
| 49 | If you want to find help on a specific (error) message, use the ID at the |
| 50 | start of the message. For example, to get help on the message: > |
| 51 | |
| 52 | E72: Close error on swap file |
| 53 | |
| 54 | or (translated): > |
| 55 | |
| 56 | E72: Errore durante chiusura swap file |
| 57 | |
| 58 | Use: > |
| 59 | |
| 60 | :help E72 |
| 61 | |
| 62 | If you are lazy, it also works without the shift key: > |
| 63 | |
| 64 | :help e72 |
| 65 | |
| 66 | ============================================================================== |
Bram Moolenaar | f233048 | 2008-06-24 20:19:36 +0000 | [diff] [blame] | 67 | 2. Error messages *error-messages* *errors* |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 68 | |
| 69 | When an error message is displayed, but it is removed before you could read |
| 70 | it, you can see it again with: > |
| 71 | :echo errmsg |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 72 | Or view a list of recent messages with: > |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 73 | :messages |
Bram Moolenaar | 451f849 | 2016-04-14 17:16:22 +0200 | [diff] [blame] | 74 | See `:messages` above. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 75 | |
| 76 | |
| 77 | LIST OF MESSAGES |
Bram Moolenaar | 1c6737b | 2020-09-07 22:18:52 +0200 | [diff] [blame] | 78 | *E222* *E228* *E232* *E293* *E298* *E304* *E317* |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 79 | *E318* *E356* *E438* *E439* *E440* *E316* *E320* *E322* |
Bram Moolenaar | 4b7cdca | 2020-01-01 16:18:38 +0100 | [diff] [blame] | 80 | *E323* *E341* *E473* *E570* *E685* *E292* > |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 81 | Add to read buffer |
| 82 | makemap: Illegal mode |
| 83 | Cannot create BalloonEval with both message and callback |
| 84 | Hangul automata ERROR |
| 85 | block was not locked |
| 86 | Didn't get block nr {N}? |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 87 | ml_upd_block0(): Didn't get block 0?? |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 88 | pointer block id wrong {N} |
| 89 | Updated too many blocks? |
| 90 | get_varp ERROR |
| 91 | u_undo: line numbers wrong |
| 92 | undo list corrupt |
| 93 | undo line missing |
| 94 | ml_get: cannot find line {N} |
| 95 | cannot find line {N} |
| 96 | line number out of range: {N} past the end |
| 97 | line count wrong in block {N} |
| 98 | Internal error |
Bram Moolenaar | cf3630f | 2005-01-08 16:04:29 +0000 | [diff] [blame] | 99 | Internal error: {function} |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 100 | fatal error in cs_manage_matches |
Bram Moolenaar | 7254067 | 2018-02-09 22:00:53 +0100 | [diff] [blame] | 101 | Invalid count for del_bytes(): {N} |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 102 | |
| 103 | This is an internal error. If you can reproduce it, please send in a bug |
| 104 | report. |bugs| |
| 105 | |
| 106 | > |
| 107 | ATTENTION |
| 108 | Found a swap file by the name ... |
| 109 | |
| 110 | See |ATTENTION|. |
| 111 | |
| 112 | *E92* > |
| 113 | Buffer {N} not found |
| 114 | |
| 115 | The buffer you requested does not exist. This can also happen when you have |
| 116 | wiped out a buffer which contains a mark or is referenced in another way. |
| 117 | |:bwipeout| |
| 118 | |
| 119 | *E95* > |
| 120 | Buffer with this name already exists |
| 121 | |
| 122 | You cannot have two buffers with the same name. |
| 123 | |
| 124 | *E72* > |
| 125 | Close error on swap file |
| 126 | |
| 127 | The |swap-file|, that is used to keep a copy of the edited text, could not be |
| 128 | closed properly. Mostly harmless. |
| 129 | |
| 130 | *E169* > |
| 131 | Command too recursive |
| 132 | |
| 133 | This happens when an Ex command executes an Ex command that executes an Ex |
Bram Moolenaar | bc2eada | 2017-01-02 21:27:47 +0100 | [diff] [blame] | 134 | command, etc. The limit is 200 or the value of 'maxfuncdepth', whatever is |
| 135 | larger. When it's more there probably is an endless loop. Probably a |
| 136 | |:execute| or |:source| command is involved. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 137 | |
| 138 | *E254* > |
| 139 | Cannot allocate color {name} |
| 140 | |
| 141 | The color name {name} is unknown. See |gui-colors| for a list of colors that |
| 142 | are available on most systems. |
| 143 | |
| 144 | *E458* > |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 145 | Cannot allocate colormap entry, some colors may be incorrect |
| 146 | |
| 147 | This means that there are not enough colors available for Vim. It will still |
| 148 | run, but some of the colors will not appear in the specified color. Try |
| 149 | stopping other applications that use many colors, or start them after starting |
| 150 | gvim. |
Bram Moolenaar | 8f3f58f | 2010-01-06 20:52:26 +0100 | [diff] [blame] | 151 | Browsers are known to consume a lot of colors. You can avoid this with |
| 152 | netscape by telling it to use its own colormap: > |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 153 | netscape -install |
| 154 | Or tell it to limit to a certain number of colors (64 should work well): > |
| 155 | netscape -ncols 64 |
| 156 | This can also be done with a line in your Xdefaults file: > |
| 157 | Netscape*installColormap: Yes |
| 158 | or > |
| 159 | Netscape*maxImageColors: 64 |
| 160 | < |
| 161 | *E79* > |
| 162 | Cannot expand wildcards |
| 163 | |
| 164 | A filename contains a strange combination of characters, which causes Vim to |
| 165 | attempt expanding wildcards but this fails. This does NOT mean that no |
| 166 | matching file names could be found, but that the pattern was illegal. |
| 167 | |
| 168 | *E459* > |
| 169 | Cannot go back to previous directory |
| 170 | |
| 171 | While expanding a file name, Vim failed to go back to the previously used |
| 172 | directory. All file names being used may be invalid now! You need to have |
| 173 | execute permission on the current directory. |
| 174 | |
| 175 | *E190* *E212* > |
| 176 | Cannot open "{filename}" for writing |
| 177 | Can't open file for writing |
| 178 | |
| 179 | For some reason the file you are writing to cannot be created or overwritten. |
| 180 | The reason could be that you do not have permission to write in the directory |
| 181 | or the file name is not valid. |
| 182 | |
| 183 | *E166* > |
| 184 | Can't open linked file for writing |
| 185 | |
| 186 | You are trying to write to a file which can't be overwritten, and the file is |
| 187 | a link (either a hard link or a symbolic link). Writing might still be |
| 188 | possible if the directory that contains the link or the file is writable, but |
| 189 | Vim now doesn't know if you want to delete the link and write the file in its |
| 190 | place, or if you want to delete the file itself and write the new file in its |
| 191 | place. If you really want to write the file under this name, you have to |
| 192 | manually delete the link or the file, or change the permissions so that Vim |
| 193 | can overwrite. |
| 194 | |
| 195 | *E46* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 196 | Cannot change read-only variable "{name}" |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 197 | |
| 198 | You are trying to assign a value to an argument of a function |a:var| or a Vim |
| 199 | internal variable |v:var| which is read-only. |
| 200 | |
| 201 | *E90* > |
| 202 | Cannot unload last buffer |
| 203 | |
| 204 | Vim always requires one buffer to be loaded, otherwise there would be nothing |
| 205 | to display in the window. |
| 206 | |
| 207 | *E40* > |
| 208 | Can't open errorfile <filename> |
| 209 | |
| 210 | When using the ":make" or ":grep" commands: The file used to save the error |
| 211 | messages or grep output cannot be opened. This can have several causes: |
| 212 | - 'shellredir' has a wrong value. |
| 213 | - The shell changes directory, causing the error file to be written in another |
| 214 | directory. This could be fixed by changing 'makeef', but then the make |
| 215 | command is still executed in the wrong directory. |
| 216 | - 'makeef' has a wrong value. |
| 217 | - The 'grepprg' or 'makeprg' could not be executed. This cannot always be |
| 218 | detected (especially on MS-Windows). Check your $PATH. |
| 219 | |
| 220 | > |
| 221 | Can't open file C:\TEMP\VIoD243.TMP |
| 222 | |
| 223 | On MS-Windows, this message appears when the output of an external command was |
| 224 | to be read, but the command didn't run successfully. This can be caused by |
| 225 | many things. Check the 'shell', 'shellquote', 'shellxquote', 'shellslash' and |
| 226 | related options. It might also be that the external command was not found, |
| 227 | there is no different error message for that. |
| 228 | |
| 229 | *E12* > |
| 230 | Command not allowed from exrc/vimrc in current dir or tag search |
| 231 | |
| 232 | Some commands are not allowed for security reasons. These commands mostly |
| 233 | come from a .exrc or .vimrc file in the current directory, or from a tags |
| 234 | file. Also see 'secure'. |
| 235 | |
| 236 | *E74* > |
| 237 | Command too complex |
| 238 | |
| 239 | A mapping resulted in a very long command string. Could be caused by a |
| 240 | mapping that indirectly calls itself. |
| 241 | |
| 242 | > |
| 243 | CONVERSION ERROR |
| 244 | |
| 245 | When writing a file and the text "CONVERSION ERROR" appears, this means that |
| 246 | some bits were lost when converting text from the internally used UTF-8 to the |
| 247 | format of the file. The file will not be marked unmodified. If you care |
| 248 | about the loss of information, set the 'fileencoding' option to another value |
| 249 | that can handle the characters in the buffer and write again. If you don't |
| 250 | care, you can abandon the buffer or reset the 'modified' option. |
Bram Moolenaar | 68e6560 | 2019-05-26 21:33:31 +0200 | [diff] [blame] | 251 | If there is a backup file, when 'writebackup' or 'backup' is set, it will not |
| 252 | be deleted, so you can move it back into place if you want to discard the |
| 253 | changes. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 254 | |
| 255 | *E302* > |
| 256 | Could not rename swap file |
| 257 | |
| 258 | When the file name changes, Vim tries to rename the |swap-file| as well. |
| 259 | This failed and the old swap file is now still used. Mostly harmless. |
| 260 | |
| 261 | *E43* *E44* > |
| 262 | Damaged match string |
| 263 | Corrupted regexp program |
| 264 | |
| 265 | Something inside Vim went wrong and resulted in a corrupted regexp. If you |
| 266 | know how to reproduce this problem, please report it. |bugs| |
| 267 | |
| 268 | *E208* *E209* *E210* > |
| 269 | Error writing to "{filename}" |
| 270 | Error closing "{filename}" |
| 271 | Error reading "{filename}" |
| 272 | |
| 273 | This occurs when Vim is trying to rename a file, but a simple change of file |
| 274 | name doesn't work. Then the file will be copied, but somehow this failed. |
| 275 | The result may be that both the original file and the destination file exist |
| 276 | and the destination file may be incomplete. |
| 277 | |
| 278 | > |
| 279 | Vim: Error reading input, exiting... |
| 280 | |
| 281 | This occurs when Vim cannot read typed characters while input is required. |
| 282 | Vim got stuck, the only thing it can do is exit. This can happen when both |
| 283 | stdin and stderr are redirected and executing a script that doesn't exit Vim. |
| 284 | |
| 285 | *E47* > |
| 286 | Error while reading errorfile |
| 287 | |
| 288 | Reading the error file was not possible. This is NOT caused by an error |
| 289 | message that was not recognized. |
| 290 | |
| 291 | *E80* > |
| 292 | Error while writing |
| 293 | |
| 294 | Writing a file was not completed successfully. The file is probably |
| 295 | incomplete. |
| 296 | |
| 297 | *E13* *E189* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 298 | File exists (add ! to override) |
| 299 | "{filename}" exists (add ! to override) |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 300 | |
| 301 | You are protected from accidentally overwriting a file. When you want to |
| 302 | write anyway, use the same command, but add a "!" just after the command. |
| 303 | Example: > |
| 304 | :w /tmp/test |
| 305 | changes to: > |
| 306 | :w! /tmp/test |
| 307 | < |
Bram Moolenaar | ecf07c8 | 2005-08-01 21:52:12 +0000 | [diff] [blame] | 308 | *E768* > |
| 309 | Swap file exists: {filename} (:silent! overrides) |
| 310 | |
| 311 | You are protected from overwriting a file that is being edited by Vim. This |
| 312 | happens when you use ":w! filename" and a swapfile is found. |
| 313 | - If the swapfile was left over from an old crashed edit session you may want |
| 314 | to delete the swapfile. Edit {filename} to find out information about the |
| 315 | swapfile. |
| 316 | - If you want to write anyway prepend ":silent!" to the command. For example: > |
Bram Moolenaar | c9b4b05 | 2006-04-30 18:54:39 +0000 | [diff] [blame] | 317 | :silent! w! /tmp/test |
Bram Moolenaar | ecf07c8 | 2005-08-01 21:52:12 +0000 | [diff] [blame] | 318 | < The special command is needed, since you already added the ! for overwriting |
| 319 | an existing file. |
| 320 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 321 | *E139* > |
| 322 | File is loaded in another buffer |
| 323 | |
| 324 | You are trying to write a file under a name which is also used in another |
| 325 | buffer. This would result in two versions of the same file. |
| 326 | |
| 327 | *E142* > |
| 328 | File not written: Writing is disabled by 'write' option |
| 329 | |
| 330 | The 'write' option is off. This makes all commands that try to write a file |
| 331 | generate this message. This could be caused by a |-m| commandline argument. |
| 332 | You can switch the 'write' option on with ":set write". |
| 333 | |
| 334 | *E25* > |
| 335 | GUI cannot be used: Not enabled at compile time |
| 336 | |
| 337 | You are running a version of Vim that doesn't include the GUI code. Therefore |
| 338 | "gvim" and ":gui" don't work. |
| 339 | |
| 340 | *E49* > |
| 341 | Invalid scroll size |
| 342 | |
| 343 | This is caused by setting an invalid value for the 'scroll', 'scrolljump' or |
| 344 | 'scrolloff' options. |
| 345 | |
| 346 | *E17* > |
| 347 | "{filename}" is a directory |
| 348 | |
| 349 | You tried to write a file with the name of a directory. This is not possible. |
| 350 | You probably need to append a file name. |
| 351 | |
| 352 | *E19* > |
| 353 | Mark has invalid line number |
| 354 | |
| 355 | You are using a mark that has a line number that doesn't exist. This can |
| 356 | happen when you have a mark in another file, and some other program has |
| 357 | deleted lines from it. |
| 358 | |
| 359 | *E219* *E220* > |
| 360 | Missing {. |
| 361 | Missing }. |
| 362 | |
| 363 | Using a {} construct in a file name, but there is a { without a matching } or |
| 364 | the other way around. It should be used like this: {foo,bar}. This matches |
| 365 | "foo" and "bar". |
| 366 | |
| 367 | *E315* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 368 | ml_get: invalid lnum: {number} |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 369 | |
| 370 | This is an internal Vim error. Please try to find out how it can be |
| 371 | reproduced, and submit a bug report |bugreport.vim|. |
| 372 | |
| 373 | *E173* > |
| 374 | {number} more files to edit |
| 375 | |
| 376 | You are trying to exit, while the last item in the argument list has not been |
| 377 | edited. This protects you from accidentally exiting when you still have more |
| 378 | files to work on. See |argument-list|. If you do want to exit, just do it |
| 379 | again and it will work. |
| 380 | |
| 381 | *E23* *E194* > |
| 382 | No alternate file |
| 383 | No alternate file name to substitute for '#' |
| 384 | |
| 385 | The alternate file is not defined yet. See |alternate-file|. |
| 386 | |
| 387 | *E32* > |
| 388 | No file name |
| 389 | |
| 390 | The current buffer has no name. To write it, use ":w fname". Or give the |
| 391 | buffer a name with ":file fname". |
| 392 | |
| 393 | *E141* > |
| 394 | No file name for buffer {number} |
| 395 | |
| 396 | One of the buffers that was changed does not have a file name. Therefore it |
| 397 | cannot be written. You need to give the buffer a file name: > |
| 398 | :buffer {number} |
| 399 | :file {filename} |
| 400 | < |
| 401 | *E33* > |
| 402 | No previous substitute regular expression |
| 403 | |
| 404 | When using the '~' character in a pattern, it is replaced with the previously |
| 405 | used pattern in a ":substitute" command. This fails when no such command has |
Bram Moolenaar | df177f6 | 2005-02-22 08:39:57 +0000 | [diff] [blame] | 406 | been used yet. See |/~|. This also happens when using ":s/pat/%/", where the |
| 407 | "%" stands for the previous substitute string. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 408 | |
| 409 | *E35* > |
| 410 | No previous regular expression |
| 411 | |
| 412 | When using an empty search pattern, the previous search pattern is used. But |
| 413 | that is not possible if there was no previous search. |
| 414 | |
| 415 | *E24* > |
| 416 | No such abbreviation |
| 417 | |
| 418 | You have used an ":unabbreviate" command with an argument which is not an |
| 419 | existing abbreviation. All variations of this command give the same message: |
| 420 | ":cunabbrev", ":iunabbrev", etc. Check for trailing white space. |
| 421 | |
| 422 | > |
| 423 | /dev/dsp: No such file or directory |
| 424 | |
| 425 | Only given for GTK GUI with Gnome support. Gnome tries to use the audio |
| 426 | device and it isn't present. You can ignore this error. |
| 427 | |
| 428 | *E31* > |
| 429 | No such mapping |
| 430 | |
| 431 | You have used an ":unmap" command with an argument which is not an existing |
| 432 | mapping. All variations of this command give the same message: ":cunmap", |
Bram Moolenaar | 4c3f536 | 2006-04-11 21:38:50 +0000 | [diff] [blame] | 433 | ":unmap!", etc. A few hints: |
| 434 | - Check for trailing white space. |
| 435 | - If the mapping is buffer-local you need to use ":unmap <buffer>". |
| 436 | |:map-<buffer>| |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 437 | |
| 438 | *E37* *E89* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 439 | No write since last change (add ! to override) |
| 440 | No write since last change for buffer {N} (add ! to override) |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 441 | |
| 442 | You are trying to |abandon| a file that has changes. Vim protects you from |
| 443 | losing your work. You can either write the changed file with ":w", or, if you |
| 444 | are sure, |abandon| it anyway, and lose all the changes. This can be done by |
| 445 | adding a '!' character just after the command you used. Example: > |
| 446 | :e other_file |
| 447 | changes to: > |
| 448 | :e! other_file |
| 449 | < |
| 450 | *E162* > |
| 451 | No write since last change for buffer "{name}" |
| 452 | |
| 453 | This appears when you try to exit Vim while some buffers are changed. You |
| 454 | will either have to write the changed buffer (with |:w|), or use a command to |
| 455 | abandon the buffer forcefully, e.g., with ":qa!". Careful, make sure you |
| 456 | don't throw away changes you really want to keep. You might have forgotten |
| 457 | about a buffer, especially when 'hidden' is set. |
| 458 | |
Bram Moolenaar | d4755bb | 2004-09-02 19:12:26 +0000 | [diff] [blame] | 459 | > |
| 460 | [No write since last change] |
| 461 | |
| 462 | This appears when executing a shell command while at least one buffer was |
| 463 | changed. To avoid the message reset the 'warn' option. |
| 464 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 465 | *E38* > |
| 466 | Null argument |
| 467 | |
| 468 | Something inside Vim went wrong and resulted in a NULL pointer. If you know |
| 469 | how to reproduce this problem, please report it. |bugs| |
| 470 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 471 | *E41* *E82* *E83* *E342* > |
| 472 | Out of memory! |
| 473 | Out of memory! (allocating {number} bytes) |
| 474 | Cannot allocate any buffer, exiting... |
| 475 | Cannot allocate buffer, using other one... |
| 476 | |
| 477 | Oh, oh. You must have been doing something complicated, or some other program |
| 478 | is consuming your memory. Be careful! Vim is not completely prepared for an |
| 479 | out-of-memory situation. First make sure that any changes are saved. Then |
| 480 | try to solve the memory shortage. To stay on the safe side, exit Vim and |
Bram Moolenaar | 0ed0eea | 2010-07-26 22:21:27 +0200 | [diff] [blame] | 481 | start again. |
| 482 | |
Bram Moolenaar | 06fe74a | 2019-08-31 16:20:32 +0200 | [diff] [blame] | 483 | If this happens while Vim is still initializing, editing files is very |
Bram Moolenaar | 2e693a8 | 2019-10-16 22:35:02 +0200 | [diff] [blame] | 484 | unlikely to work, therefore Vim will exit with value 123. |
Bram Moolenaar | 06fe74a | 2019-08-31 16:20:32 +0200 | [diff] [blame] | 485 | |
Bram Moolenaar | 0ed0eea | 2010-07-26 22:21:27 +0200 | [diff] [blame] | 486 | Buffers are only partly kept in memory, thus editing a very large file is |
| 487 | unlikely to cause an out-of-memory situation. Undo information is completely |
| 488 | in memory, you can reduce that with these options: |
| 489 | - 'undolevels' Set to a low value, or to -1 to disable undo completely. This |
| 490 | helps for a change that affects all lines. |
| 491 | - 'undoreload' Set to zero to disable. |
| 492 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 493 | *E339* > |
| 494 | Pattern too long |
| 495 | |
Bram Moolenaar | d58e929 | 2011-02-09 17:07:58 +0100 | [diff] [blame] | 496 | This happens on systems with 16 bit ints: The compiled regexp pattern is |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 497 | longer than about 65000 characters. Try using a shorter pattern. |
Bram Moolenaar | d58e929 | 2011-02-09 17:07:58 +0100 | [diff] [blame] | 498 | It also happens when the offset of a rule doesn't fit in the space available. |
| 499 | Try simplifying the pattern. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 500 | |
| 501 | *E45* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 502 | 'readonly' option is set (add ! to override) |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 503 | |
| 504 | You are trying to write a file that was marked as read-only. To write the |
| 505 | file anyway, either reset the 'readonly' option, or add a '!' character just |
| 506 | after the command you used. Example: > |
| 507 | :w |
| 508 | changes to: > |
| 509 | :w! |
| 510 | < |
| 511 | *E294* *E295* *E301* > |
| 512 | Read error in swap file |
| 513 | Seek error in swap file read |
| 514 | Oops, lost the swap file!!! |
| 515 | |
| 516 | Vim tried to read text from the |swap-file|, but something went wrong. The |
| 517 | text in the related buffer may now be corrupted! Check carefully before you |
| 518 | write a buffer. You may want to write it in another file and check for |
| 519 | differences. |
| 520 | |
| 521 | *E192* > |
| 522 | Recursive use of :normal too deep |
| 523 | |
| 524 | You are using a ":normal" command, whose argument again uses a ":normal" |
| 525 | command in a recursive way. This is restricted to 'maxmapdepth' levels. This |
| 526 | example illustrates how to get this message: > |
| 527 | :map gq :normal gq<CR> |
| 528 | If you type "gq", it will execute this mapping, which will call "gq" again. |
| 529 | |
| 530 | *E22* > |
| 531 | Scripts nested too deep |
| 532 | |
| 533 | Scripts can be read with the "-s" command-line argument and with the ":source" |
| 534 | command. The script can then again read another script. This can continue |
| 535 | for about 14 levels. When more nesting is done, Vim assumes that there is a |
| 536 | recursive loop somewhere and stops with this error message. |
| 537 | |
| 538 | *E319* > |
| 539 | Sorry, the command is not available in this version |
| 540 | |
| 541 | You have used a command that is not present in the version of Vim you are |
| 542 | using. When compiling Vim, many different features can be enabled or |
| 543 | disabled. This depends on how big Vim has chosen to be and the operating |
| 544 | system. See |+feature-list| for when which feature is available. The |
| 545 | |:version| command shows which feature Vim was compiled with. |
| 546 | |
| 547 | *E300* > |
| 548 | Swap file already exists (symlink attack?) |
| 549 | |
| 550 | This message appears when Vim is trying to open a swap file and finds it |
| 551 | already exists or finds a symbolic link in its place. This shouldn't happen, |
| 552 | because Vim already checked that the file doesn't exist. Either someone else |
| 553 | opened the same file at exactly the same moment (very unlikely) or someone is |
| 554 | attempting a symlink attack (could happen when editing a file in /tmp or when |
| 555 | 'directory' starts with "/tmp", which is a bad choice). |
| 556 | |
| 557 | *E432* > |
| 558 | Tags file not sorted: {file name} |
| 559 | |
| 560 | Vim (and Vi) expect tags files to be sorted in ASCII order. Binary searching |
| 561 | can then be used, which is a lot faster than a linear search. If your tags |
| 562 | files are not properly sorted, reset the |'tagbsearch'| option. |
| 563 | This message is only given when Vim detects a problem when searching for a |
Bram Moolenaar | 7fc0c06 | 2010-08-10 21:43:35 +0200 | [diff] [blame] | 564 | tag. Sometimes this message is not given, even though the tags file is not |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 565 | properly sorted. |
| 566 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 567 | *E424* > |
| 568 | Too many different highlighting attributes in use |
| 569 | |
| 570 | Vim can only handle about 223 different kinds of highlighting. If you run |
| 571 | into this limit, you have used too many |:highlight| commands with different |
| 572 | arguments. A ":highlight link" is not counted. |
| 573 | |
| 574 | *E77* > |
| 575 | Too many file names |
| 576 | |
| 577 | When expanding file names, more than one match was found. Only one match is |
| 578 | allowed for the command that was used. |
| 579 | |
| 580 | *E303* > |
| 581 | Unable to open swap file for "{filename}", recovery impossible |
| 582 | |
| 583 | Vim was not able to create a swap file. You can still edit the file, but if |
Bram Moolenaar | 8f3f58f | 2010-01-06 20:52:26 +0100 | [diff] [blame] | 584 | Vim unexpectedly exits the changes will be lost. And Vim may consume a lot of |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 585 | memory when editing a big file. You may want to change the 'directory' option |
Bram Moolenaar | 00e192b | 2019-10-19 17:01:28 +0200 | [diff] [blame] | 586 | to avoid this error. This error is not given when 'directory' is empty. See |
| 587 | |swap-file|. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 588 | |
| 589 | *E140* > |
| 590 | Use ! to write partial buffer |
| 591 | |
| 592 | When using a range to write part of a buffer, it is unusual to overwrite the |
| 593 | original file. It is probably a mistake (e.g., when Visual mode was active |
| 594 | when using ":w"), therefore Vim requires using a ! after the command, e.g.: |
| 595 | ":3,10w!". |
| 596 | > |
| 597 | |
| 598 | Warning: Cannot convert string "<Key>Escape,_Key_Cancel" to type |
| 599 | VirtualBinding |
| 600 | |
| 601 | Messages like this appear when starting up. This is not a Vim problem, your |
| 602 | X11 configuration is wrong. You can find a hint on how to solve this here: |
| 603 | http://groups.yahoo.com/group/solarisonintel/message/12179. |
Bram Moolenaar | a17d4c1 | 2010-05-30 18:30:36 +0200 | [diff] [blame] | 604 | [this URL is no longer valid] |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 605 | |
| 606 | *W10* > |
| 607 | Warning: Changing a readonly file |
| 608 | |
| 609 | The file is read-only and you are making a change to it anyway. You can use |
| 610 | the |FileChangedRO| autocommand event to avoid this message (the autocommand |
| 611 | must reset the 'readonly' option). See 'modifiable' to completely disallow |
| 612 | making changes to a file. |
Bram Moolenaar | d5cdbeb | 2005-10-10 20:59:28 +0000 | [diff] [blame] | 613 | This message is only given for the first change after 'readonly' has been set. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 614 | |
| 615 | *W13* > |
| 616 | Warning: File "{filename}" has been created after editing started |
| 617 | |
| 618 | You are editing a file in Vim when it didn't exist, but it does exist now. |
| 619 | You will have to decide if you want to keep the version in Vim or the newly |
| 620 | created file. This message is not given when 'buftype' is not empty. |
| 621 | |
| 622 | *W11* > |
| 623 | Warning: File "{filename}" has changed since editing started |
| 624 | |
| 625 | The file which you have started editing has got another timestamp and the |
| 626 | contents changed (more precisely: When reading the file again with the current |
| 627 | option settings and autocommands you would end up with different text). This |
| 628 | probably means that some other program changed the file. You will have to |
| 629 | find out what happened, and decide which version of the file you want to keep. |
| 630 | Set the 'autoread' option if you want to do this automatically. |
| 631 | This message is not given when 'buftype' is not empty. |
| 632 | |
| 633 | There is one situation where you get this message even though there is nothing |
| 634 | wrong: If you save a file in Windows on the day the daylight saving time |
| 635 | starts. It can be fixed in one of these ways: |
| 636 | - Add this line in your autoexec.bat: > |
| 637 | SET TZ=-1 |
| 638 | < Adjust the "-1" for your time zone. |
| 639 | - Disable "automatically adjust clock for daylight saving changes". |
| 640 | - Just write the file again the next day. Or set your clock to the next day, |
| 641 | write the file twice and set the clock back. |
| 642 | |
Bram Moolenaar | 01164a6 | 2017-11-02 22:58:42 +0100 | [diff] [blame] | 643 | If you get W11 all the time, you may need to disable "Acronis Active |
Bram Moolenaar | b0d45e7 | 2017-11-05 18:19:24 +0100 | [diff] [blame] | 644 | Protection" or register Vim as a trusted service/application. |
Bram Moolenaar | 01164a6 | 2017-11-02 22:58:42 +0100 | [diff] [blame] | 645 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 646 | *W12* > |
| 647 | Warning: File "{filename}" has changed and the buffer was changed in Vim as well |
| 648 | |
| 649 | Like the above, and the buffer for the file was changed in this Vim as well. |
| 650 | You will have to decide if you want to keep the version in this Vim or the one |
| 651 | on disk. This message is not given when 'buftype' is not empty. |
| 652 | |
| 653 | *W16* > |
| 654 | Warning: Mode of file "{filename}" has changed since editing started |
| 655 | |
| 656 | When the timestamp for a buffer was changed and the contents are still the |
| 657 | same but the mode (permissions) have changed. This usually occurs when |
| 658 | checking out a file from a version control system, which causes the read-only |
| 659 | bit to be reset. It should be safe to reload the file. Set 'autoread' to |
| 660 | automatically reload the file. |
| 661 | |
| 662 | *E211* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 663 | File "{filename}" no longer available |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 664 | |
| 665 | The file which you have started editing has disappeared, or is no longer |
| 666 | accessible. Make sure you write the buffer somewhere to avoid losing |
| 667 | changes. This message is not given when 'buftype' is not empty. |
| 668 | |
| 669 | *W14* > |
| 670 | Warning: List of file names overflow |
| 671 | |
| 672 | You must be using an awful lot of buffers. It's now possible that two buffers |
| 673 | have the same number, which causes various problems. You might want to exit |
| 674 | Vim and restart it. |
| 675 | |
Bram Moolenaar | 269f595 | 2016-07-15 22:54:41 +0200 | [diff] [blame] | 676 | *E931* > |
| 677 | Buffer cannot be registered |
| 678 | |
Bram Moolenaar | 42ebd06 | 2016-07-17 13:35:14 +0200 | [diff] [blame] | 679 | Out of memory or a duplicate buffer number. May happen after W14. Looking up |
Bram Moolenaar | 269f595 | 2016-07-15 22:54:41 +0200 | [diff] [blame] | 680 | a buffer will not always work, better restart Vim. |
| 681 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 682 | *E296* *E297* > |
| 683 | Seek error in swap file write |
| 684 | Write error in swap file |
| 685 | |
| 686 | This mostly happens when the disk is full. Vim could not write text into the |
| 687 | |swap-file|. It's not directly harmful, but when Vim unexpectedly exits some |
| 688 | text may be lost without recovery being possible. Vim might run out of memory |
| 689 | when this problem persists. |
| 690 | |
| 691 | *connection-refused* > |
| 692 | Xlib: connection to "<machine-name:0.0" refused by server |
| 693 | |
| 694 | This happens when Vim tries to connect to the X server, but the X server does |
| 695 | not allow a connection. The connection to the X server is needed to be able |
| 696 | to restore the title and for the xterm clipboard support. Unfortunately this |
| 697 | error message cannot be avoided, except by disabling the |+xterm_clipboard| |
| 698 | and |+X11| features. |
| 699 | |
| 700 | *E10* > |
| 701 | \\ should be followed by /, ? or & |
| 702 | |
| 703 | A command line started with a backslash or the range of a command contained a |
| 704 | backslash in a wrong place. This is often caused by command-line continuation |
| 705 | being disabled. Remove the 'C' flag from the 'cpoptions' option to enable it. |
Bram Moolenaar | 5eb86f9 | 2004-07-26 12:53:41 +0000 | [diff] [blame] | 706 | Or use ":set nocp". |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 707 | |
| 708 | *E471* > |
| 709 | Argument required |
| 710 | |
| 711 | This happens when an Ex command with mandatory argument(s) was executed, but |
| 712 | no argument has been specified. |
| 713 | |
Bram Moolenaar | 62e1bb4 | 2019-04-08 16:25:07 +0200 | [diff] [blame] | 714 | *E474* *E475* *E983* > |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 715 | Invalid argument |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 716 | Invalid argument: {arg} |
Bram Moolenaar | 62e1bb4 | 2019-04-08 16:25:07 +0200 | [diff] [blame] | 717 | Duplicate argument: {arg} |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 718 | |
Bram Moolenaar | 62e1bb4 | 2019-04-08 16:25:07 +0200 | [diff] [blame] | 719 | An Ex command or function has been executed, but an invalid argument has been |
| 720 | specified. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 721 | |
| 722 | *E488* > |
| 723 | Trailing characters |
| 724 | |
| 725 | An argument has been added to an Ex command that does not permit one. |
| 726 | |
| 727 | *E477* *E478* > |
| 728 | No ! allowed |
| 729 | Don't panic! |
| 730 | |
| 731 | You have added a "!" after an Ex command that doesn't permit one. |
| 732 | |
| 733 | *E481* > |
| 734 | No range allowed |
| 735 | |
| 736 | A range was specified for an Ex command that doesn't permit one. See |
| 737 | |cmdline-ranges|. |
| 738 | |
| 739 | *E482* *E483* > |
| 740 | Can't create file {filename} |
| 741 | Can't get temp file name |
| 742 | |
| 743 | Vim cannot create a temporary file. |
| 744 | |
| 745 | *E484* *E485* > |
Bram Moolenaar | 5e3dae8 | 2010-03-02 16:19:40 +0100 | [diff] [blame] | 746 | Can't open file {filename} |
| 747 | Can't read file {filename} |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 748 | |
Bram Moolenaar | 34700a6 | 2013-03-07 13:20:54 +0100 | [diff] [blame] | 749 | Vim cannot read a temporary file. Especially on Windows, this can be caused |
| 750 | by wrong escaping of special characters for cmd.exe; the approach was |
| 751 | changed with patch 7.3.443. Try using |shellescape()| for all shell arguments |
| 752 | given to |system()|, or explicitly add escaping with ^. Also see |
| 753 | 'shellxquote' and 'shellxescape'. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 754 | |
| 755 | *E464* > |
| 756 | Ambiguous use of user-defined command |
| 757 | |
| 758 | There are two user-defined commands with a common name prefix, and you used |
| 759 | Command-line completion to execute one of them. |user-cmd-ambiguous| |
| 760 | Example: > |
| 761 | :command MyCommand1 echo "one" |
| 762 | :command MyCommand2 echo "two" |
| 763 | :MyCommand |
| 764 | < |
| 765 | *E492* > |
| 766 | Not an editor command |
| 767 | |
| 768 | You tried to execute a command that is neither an Ex command nor |
| 769 | a user-defined command. |
| 770 | |
Bram Moolenaar | e0720cb | 2017-03-29 13:48:40 +0200 | [diff] [blame] | 771 | *E943* > |
| 772 | Command table needs to be updated, run 'make cmdidxs' |
| 773 | |
| 774 | This can only happen when changing the source code, when adding a command in |
| 775 | src/ex_cmds.h. The lookup table then needs to be updated, by running: > |
| 776 | make cmdidxs |
| 777 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 778 | ============================================================================== |
| 779 | 3. Messages *messages* |
| 780 | |
| 781 | This is an (incomplete) overview of various messages that Vim gives: |
| 782 | |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 783 | *hit-enter* *press-enter* *hit-return* |
| 784 | *press-return* *hit-enter-prompt* |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 785 | |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 786 | Press ENTER or type command to continue |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 787 | |
| 788 | This message is given when there is something on the screen for you to read, |
| 789 | and the screen is about to be redrawn: |
| 790 | - After executing an external command (e.g., ":!ls" and "="). |
| 791 | - Something is displayed on the status line that is longer than the width of |
| 792 | the window, or runs into the 'showcmd' or 'ruler' output. |
| 793 | |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 794 | -> Press <Enter> or <Space> to redraw the screen and continue, without that |
| 795 | key being used otherwise. |
| 796 | -> Press ':' or any other Normal mode command character to start that command. |
Bram Moolenaar | 7e6a515 | 2021-01-02 16:39:53 +0100 | [diff] [blame] | 797 | Note that after an external command some special keys, such as the cursor |
| 798 | keys, may not work normally, because the terminal is still set to a state |
| 799 | for executing the external command. |
Bram Moolenaar | e1438bb | 2006-03-01 22:01:55 +0000 | [diff] [blame] | 800 | -> Press 'k', <Up>, 'u', 'b' or 'g' to scroll back in the messages. This |
| 801 | works the same way as at the |more-prompt|. Only works when 'compatible' |
| 802 | is off and 'more' is on. |
Bram Moolenaar | 8f3f58f | 2010-01-06 20:52:26 +0100 | [diff] [blame] | 803 | -> Pressing 'j', 'f', 'd' or <Down> is ignored when messages scrolled off the |
| 804 | top of the screen, 'compatible' is off and 'more' is on, to avoid that |
| 805 | typing one 'j' or 'f' too many causes the messages to disappear. |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 806 | -> Press <C-Y> to copy (yank) a modeless selection to the clipboard register. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 807 | -> Use a menu. The characters defined for Cmdline-mode are used. |
| 808 | -> When 'mouse' contains the 'r' flag, clicking the left mouse button works |
| 809 | like pressing <Space>. This makes it impossible to select text though. |
| 810 | -> For the GUI clicking the left mouse button in the last line works like |
| 811 | pressing <Space>. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 812 | |
Bram Moolenaar | cfc7d63 | 2005-07-28 22:28:16 +0000 | [diff] [blame] | 813 | If you accidentally hit <Enter> or <Space> and you want to see the displayed |
| 814 | text then use |g<|. This only works when 'more' is set. |
| 815 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 816 | To reduce the number of hit-enter prompts: |
| 817 | - Set 'cmdheight' to 2 or higher. |
| 818 | - Add flags to 'shortmess'. |
| 819 | - Reset 'showcmd' and/or 'ruler'. |
Bram Moolenaar | 06fe74a | 2019-08-31 16:20:32 +0200 | [diff] [blame] | 820 | - Make sure `:echo` text is shorter than or equal to |v:echospace| screen |
| 821 | cells. |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 822 | |
Bram Moolenaar | bb15b65 | 2005-10-03 21:52:09 +0000 | [diff] [blame] | 823 | If your script causes the hit-enter prompt and you don't know why, you may |
| 824 | find the |v:scrollstart| variable useful. |
| 825 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 826 | Also see 'mouse'. The hit-enter message is highlighted with the |hl-Question| |
| 827 | group. |
| 828 | |
| 829 | |
| 830 | *more-prompt* *pager* > |
| 831 | -- More -- |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 832 | -- More -- SPACE/d/j: screen/page/line down, b/u/k: up, q: quit |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 833 | |
| 834 | This message is given when the screen is filled with messages. It is only |
| 835 | given when the 'more' option is on. It is highlighted with the |hl-MoreMsg| |
| 836 | group. |
| 837 | |
| 838 | Type effect ~ |
| 839 | <CR> or <NL> or j or <Down> one more line |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 840 | d down a page (half a screen) |
Bram Moolenaar | 8f3f58f | 2010-01-06 20:52:26 +0100 | [diff] [blame] | 841 | <Space> or f or <PageDown> down a screen |
Bram Moolenaar | cfc7d63 | 2005-07-28 22:28:16 +0000 | [diff] [blame] | 842 | G down all the way, until the hit-enter |
Bram Moolenaar | c9b4b05 | 2006-04-30 18:54:39 +0000 | [diff] [blame] | 843 | prompt |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 844 | |
Bram Moolenaar | 25c9c68 | 2019-05-05 18:13:34 +0200 | [diff] [blame] | 845 | <BS> or k or <Up> one line back |
| 846 | u up a page (half a screen) |
| 847 | b or <PageUp> back a screen |
| 848 | g back to the start |
Bram Moolenaar | 87e25fd | 2005-07-27 21:13:01 +0000 | [diff] [blame] | 849 | |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 850 | q, <Esc> or CTRL-C stop the listing |
| 851 | : stop the listing and enter a |
| 852 | command-line |
| 853 | <C-Y> yank (copy) a modeless selection to |
| 854 | the clipboard ("* and "+ registers) |
| 855 | {menu-entry} what the menu is defined to in |
| 856 | Cmdline-mode. |
Bram Moolenaar | 25c9c68 | 2019-05-05 18:13:34 +0200 | [diff] [blame] | 857 | <LeftMouse> next page (*) |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 858 | |
| 859 | Any other key causes the meaning of the keys to be displayed. |
| 860 | |
Bram Moolenaar | 25c9c68 | 2019-05-05 18:13:34 +0200 | [diff] [blame] | 861 | (*) Clicking the left mouse button only works: |
Bram Moolenaar | 071d427 | 2004-06-13 20:20:40 +0000 | [diff] [blame] | 862 | - For the GUI: in the last line of the screen. |
| 863 | - When 'r' is included in 'mouse' (but then selecting text won't work). |
| 864 | |
| 865 | |
| 866 | Note: The typed key is directly obtained from the terminal, it is not mapped |
| 867 | and typeahead is ignored. |
| 868 | |
Bram Moolenaar | 1e01546 | 2005-09-25 22:16:38 +0000 | [diff] [blame] | 869 | The |g<| command can be used to see the last page of previous command output. |
| 870 | This is especially useful if you accidentally typed <Space> at the hit-enter |
| 871 | prompt. |
| 872 | |
Bram Moolenaar | 91f84f6 | 2018-07-29 15:07:52 +0200 | [diff] [blame] | 873 | vim:tw=78:ts=8:noet:ft=help:norl: |