Mercurial > vim
annotate runtime/doc/cmdline.txt @ 32531:c8b28054caec v9.0.1597
patch 9.0.1597: cursor ends up below the window after a put
Commit: https://github.com/vim/vim/commit/8509014adda188ee8bdf6a2e123fbf15a91b29d2
Author: Bram Moolenaar <Bram@vim.org>
Date: Thu Jun 1 19:27:08 2023 +0100
patch 9.0.1597: cursor ends up below the window after a put
Problem: Cursor ends up below the window after a put.
Solution: Mark w_crow and w_botline invalid when changing the cursor line.
(closes #12465)
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Thu, 01 Jun 2023 20:30:05 +0200 |
| parents | a9b5ffbc0428 |
| children | 635de73eeb4c |
| rev | line source |
|---|---|
| 32004 | 1 *cmdline.txt* For Vim version 9.0. Last change: 2023 Feb 08 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 *Cmdline-mode* *Command-line-mode* | |
| 8 Command-line mode *Cmdline* *Command-line* *mode-cmdline* *:* | |
| 9 | |
| 10 Command-line mode is used to enter Ex commands (":"), search patterns | |
| 11 ("/" and "?"), and filter commands ("!"). | |
| 12 | |
| 13 Basic command line editing is explained in chapter 20 of the user manual | |
| 14 |usr_20.txt|. | |
| 15 | |
| 16 1. Command-line editing |cmdline-editing| | |
| 17 2. Command-line completion |cmdline-completion| | |
| 18 3. Ex command-lines |cmdline-lines| | |
| 19 4. Ex command-line ranges |cmdline-ranges| | |
| 167 | 20 5. Ex command-line flags |ex-flags| |
| 21 6. Ex special characters |cmdline-special| | |
| 22 7. Command-line window |cmdline-window| | |
| 7 | 23 |
| 24 ============================================================================== | |
| 25 1. Command-line editing *cmdline-editing* | |
| 26 | |
| 27 Normally characters are inserted in front of the cursor position. You can | |
| 28 move around in the command-line with the left and right cursor keys. With the | |
| 29 <Insert> key, you can toggle between inserting and overstriking characters. | |
| 30 | |
| 31 Note that if your keyboard does not have working cursor keys or any of the | |
| 32 other special keys, you can use ":cnoremap" to define another key for them. | |
| 33 For example, to define tcsh style editing keys: *tcsh-style* > | |
| 34 :cnoremap <C-A> <Home> | |
| 35 :cnoremap <C-F> <Right> | |
| 36 :cnoremap <C-B> <Left> | |
| 37 :cnoremap <Esc>b <S-Left> | |
| 38 :cnoremap <Esc>f <S-Right> | |
| 39 (<> notation |<>|; type all this literally) | |
| 40 | |
| 41 *cmdline-too-long* | |
| 42 When the command line is getting longer than what fits on the screen, only the | |
| 43 part that fits will be shown. The cursor can only move in this visible part, | |
| 44 thus you cannot edit beyond that. | |
| 45 | |
| 46 *cmdline-history* *history* | |
| 47 The command-lines that you enter are remembered in a history table. You can | |
| 12 | 48 recall them with the up and down cursor keys. There are actually five |
| 7 | 49 history tables: |
| 50 - one for ':' commands | |
| 51 - one for search strings | |
| 52 - one for expressions | |
| 53 - one for input lines, typed for the |input()| function. | |
| 12 | 54 - one for debug mode commands |
| 7 | 55 These are completely separate. Each history can only be accessed when |
| 56 entering the same type of line. | |
| 57 Use the 'history' option to set the number of lines that are remembered | |
| 6213 | 58 (default: 50). |
| 7 | 59 Notes: |
| 60 - When you enter a command-line that is exactly the same as an older one, the | |
| 61 old one is removed (to avoid repeated commands moving older commands out of | |
| 62 the history). | |
| 63 - Only commands that are typed are remembered. Ones that completely come from | |
| 1620 | 64 mappings are not put in the history. |
| 7 | 65 - All searches are put in the search history, including the ones that come |
| 66 from commands like "*" and "#". But for a mapping, only the last search is | |
| 67 remembered (to avoid that long mappings trash the history). | |
| 68 {not available when compiled without the |+cmdline_hist| feature} | |
| 69 | |
| 70 There is an automatic completion of names on the command-line; see | |
| 71 |cmdline-completion|. | |
| 72 | |
| 73 *c_CTRL-V* | |
| 74 CTRL-V Insert next non-digit literally. Up to three digits form the | |
| 75 decimal value of a single byte. The non-digit and the three | |
| 76 digits are not considered for mapping. This works the same | |
| 77 way as in Insert mode (see above, |i_CTRL-V|). | |
|
18912
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
78 Note: Under MS-Windows CTRL-V is often mapped to paste text. |
| 7 | 79 Use CTRL-Q instead then. |
|
18717
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
80 When |modifyOtherKeys| is enabled then special Escape sequence |
|
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
81 is converted back to what it was without |modifyOtherKeys|, |
|
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
82 unless the Shift key is also pressed. |
| 7 | 83 *c_CTRL-Q* |
| 84 CTRL-Q Same as CTRL-V. But with some terminals it is used for | |
| 85 control flow, it doesn't work then. | |
| 86 | |
|
18717
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
87 CTRL-SHIFT-V *c_CTRL-SHIFT-V* *c_CTRL-SHIFT-Q* |
|
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
88 CTRL-SHIFT-Q Works just like CTRL-V, unless |modifyOtherKeys| is active, |
|
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
89 then it inserts the Escape sequence for a key with modifiers. |
|
28644
0c63014c2513
patch 8.2.4846: termcodes test fails
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
90 In the GUI the |key-notation| is inserted without simplifying. |
|
18717
14d2a210fab1
patch 8.1.2350: other text for CTRL-V in Insert mode with modifyOtherKeys
Bram Moolenaar <Bram@vim.org>
parents:
18186
diff
changeset
|
91 |
| 2751 | 92 *c_<Left>* *c_Left* |
| 7 | 93 <Left> cursor left |
| 2751 | 94 *c_<Right>* *c_Right* |
| 7 | 95 <Right> cursor right |
| 96 *c_<S-Left>* | |
| 97 <S-Left> or <C-Left> *c_<C-Left>* | |
| 98 cursor one WORD left | |
| 99 *c_<S-Right>* | |
| 100 <S-Right> or <C-Right> *c_<C-Right>* | |
| 101 cursor one WORD right | |
| 2751 | 102 CTRL-B or <Home> *c_CTRL-B* *c_<Home>* *c_Home* |
| 7 | 103 cursor to beginning of command-line |
| 2751 | 104 CTRL-E or <End> *c_CTRL-E* *c_<End>* *c_End* |
| 7 | 105 cursor to end of command-line |
| 106 | |
| 107 *c_<LeftMouse>* | |
| 1698 | 108 <LeftMouse> Move the cursor to the position of the mouse click. |
| 7 | 109 |
|
7384
aea5ebf352c4
commit https://github.com/vim/vim/commit/256972a9849b5d575b62a6a71be5b6934b5b0e8b
Christian Brabandt <cb@256bit.org>
parents:
7147
diff
changeset
|
110 *c_<MiddleMouse>* |
|
aea5ebf352c4
commit https://github.com/vim/vim/commit/256972a9849b5d575b62a6a71be5b6934b5b0e8b
Christian Brabandt <cb@256bit.org>
parents:
7147
diff
changeset
|
111 <MiddleMouse> Paste the contents of the clipboard (for X11 the primary |
|
aea5ebf352c4
commit https://github.com/vim/vim/commit/256972a9849b5d575b62a6a71be5b6934b5b0e8b
Christian Brabandt <cb@256bit.org>
parents:
7147
diff
changeset
|
112 selection). This is similar to using CTRL-R *, but no CR |
|
aea5ebf352c4
commit https://github.com/vim/vim/commit/256972a9849b5d575b62a6a71be5b6934b5b0e8b
Christian Brabandt <cb@256bit.org>
parents:
7147
diff
changeset
|
113 characters are inserted between lines. |
|
aea5ebf352c4
commit https://github.com/vim/vim/commit/256972a9849b5d575b62a6a71be5b6934b5b0e8b
Christian Brabandt <cb@256bit.org>
parents:
7147
diff
changeset
|
114 |
| 2751 | 115 CTRL-H *c_<BS>* *c_CTRL-H* *c_BS* |
| 1698 | 116 <BS> Delete the character in front of the cursor (see |:fixdel| if |
| 7 | 117 your <BS> key does not do what you want). |
| 2751 | 118 *c_<Del>* *c_Del* |
| 1698 | 119 <Del> Delete the character under the cursor (at end of line: |
| 7 | 120 character before the cursor) (see |:fixdel| if your <Del> |
| 121 key does not do what you want). | |
| 122 *c_CTRL-W* | |
| 1698 | 123 CTRL-W Delete the |word| before the cursor. This depends on the |
| 124 'iskeyword' option. | |
| 7 | 125 *c_CTRL-U* |
| 1698 | 126 CTRL-U Remove all characters between the cursor position and |
| 7 | 127 the beginning of the line. Previous versions of vim |
| 128 deleted all characters on the line. If that is the | |
| 129 preferred behavior, add the following to your .vimrc: > | |
| 130 :cnoremap <C-U> <C-E><C-U> | |
| 131 < | |
| 2751 | 132 *c_<Insert>* *c_Insert* |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
133 <Insert> Toggle between insert and overstrike. |
| 7 | 134 |
| 135 {char1} <BS> {char2} or *c_digraph* | |
| 136 CTRL-K {char1} {char2} *c_CTRL-K* | |
| 137 enter digraph (see |digraphs|). When {char1} is a special | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
138 key, the code for that key is inserted in <> form. |
| 7 | 139 |
| 18186 | 140 CTRL-R {register} *c_CTRL-R* *c_<C-R>* |
| 7 | 141 Insert the contents of a numbered or named register. Between |
| 142 typing CTRL-R and the second character '"' will be displayed | |
| 143 to indicate that you are expected to enter the name of a | |
| 144 register. | |
| 145 The text is inserted as if you typed it, but mappings and | |
| 146 abbreviations are not used. Command-line completion through | |
| 147 'wildchar' is not triggered though. And characters that end | |
| 148 the command line are inserted literally (<Esc>, <CR>, <NL>, | |
| 149 <C-C>). A <BS> or CTRL-W could still end the command line | |
| 150 though, and remaining characters will then be interpreted in | |
| 151 another mode, which might not be what you intended. | |
| 152 Special registers: | |
| 153 '"' the unnamed register, containing the text of | |
| 154 the last delete or yank | |
| 155 '%' the current file name | |
| 156 '#' the alternate file name | |
| 157 '*' the clipboard contents (X11: primary selection) | |
| 158 '+' the clipboard contents | |
| 159 '/' the last search pattern | |
| 160 ':' the last command-line | |
| 161 '-' the last small (less than a line) delete | |
| 162 '.' the last inserted text | |
| 163 *c_CTRL-R_=* | |
| 164 '=' the expression register: you are prompted to | |
| 165 enter an expression (see |expression|) | |
| 631 | 166 (doesn't work at the expression prompt; some |
| 167 things such as changing the buffer or current | |
| 168 window are not allowed to avoid side effects) | |
| 1733 | 169 When the result is a |List| the items are used |
| 170 as lines. They can have line breaks inside | |
| 171 too. | |
| 172 When the result is a Float it's automatically | |
| 173 converted to a String. | |
| 25619 | 174 Note that when you only want to move the |
| 175 cursor and not insert anything, you must make | |
| 176 sure the expression evaluates to an empty | |
| 177 string. E.g.: > | |
| 178 <C-R><C-R>=setcmdpos(2)[-1]<CR> | |
| 179 < See |registers| about registers. | |
| 98 | 180 Implementation detail: When using the |expression| register |
| 181 and invoking setcmdpos(), this sets the position before | |
| 182 inserting the resulting string. Use CTRL-R CTRL-R to set the | |
| 183 position afterwards. | |
| 7 | 184 |
| 185 CTRL-R CTRL-F *c_CTRL-R_CTRL-F* *c_<C-R>_<C-F>* | |
| 186 CTRL-R CTRL-P *c_CTRL-R_CTRL-P* *c_<C-R>_<C-P>* | |
| 187 CTRL-R CTRL-W *c_CTRL-R_CTRL-W* *c_<C-R>_<C-W>* | |
| 188 CTRL-R CTRL-A *c_CTRL-R_CTRL-A* *c_<C-R>_<C-A>* | |
|
13831
1f95ec5de238
patch 8.0.1787: cannot insert the whole cursor line
Christian Brabandt <cb@256bit.org>
parents:
12756
diff
changeset
|
189 CTRL-R CTRL-L *c_CTRL-R_CTRL-L* *c_<C-R>_<C-L>* |
| 7 | 190 Insert the object under the cursor: |
| 191 CTRL-F the Filename under the cursor | |
| 192 CTRL-P the Filename under the cursor, expanded with | |
| 193 'path' as in |gf| | |
| 194 CTRL-W the Word under the cursor | |
| 195 CTRL-A the WORD under the cursor; see |WORD| | |
|
13831
1f95ec5de238
patch 8.0.1787: cannot insert the whole cursor line
Christian Brabandt <cb@256bit.org>
parents:
12756
diff
changeset
|
196 CTRL-L the line under the cursor |
| 771 | 197 |
| 198 When 'incsearch' is set the cursor position at the end of the | |
| 199 currently displayed match is used. With CTRL-W the part of | |
| 200 the word that was already typed is not inserted again. | |
| 201 | |
| 7 | 202 *c_CTRL-R_CTRL-R* *c_<C-R>_<C-R>* |
| 203 *c_CTRL-R_CTRL-O* *c_<C-R>_<C-O>* | |
| 18186 | 204 CTRL-R CTRL-R {register CTRL-F CTRL-P CTRL-W CTRL-A CTRL-L} |
| 205 CTRL-R CTRL-O {register CTRL-F CTRL-P CTRL-W CTRL-A CTRL-L} | |
| 7 | 206 Insert register or object under the cursor. Works like |
| 207 |c_CTRL-R| but inserts the text literally. For example, if | |
| 208 register a contains "xy^Hz" (where ^H is a backspace), | |
| 209 "CTRL-R a" will insert "xz" while "CTRL-R CTRL-R a" will | |
| 210 insert "xy^Hz". | |
| 211 | |
| 212 CTRL-\ e {expr} *c_CTRL-\_e* | |
| 213 Evaluate {expr} and replace the whole command line with the | |
| 214 result. You will be prompted for the expression, type <Enter> | |
| 215 to finish it. It's most useful in mappings though. See | |
| 216 |expression|. | |
| 217 See |c_CTRL-R_=| for inserting the result of an expression. | |
| 531 | 218 Useful functions are |getcmdtype()|, |getcmdline()| and |
| 219 |getcmdpos()|. | |
| 7 | 220 The cursor position is unchanged, except when the cursor was |
| 221 at the end of the line, then it stays at the end. | |
| 222 |setcmdpos()| can be used to set the cursor position. | |
| 625 | 223 The |sandbox| is used for evaluating the expression to avoid |
| 224 nasty side effects. | |
| 7 | 225 Example: > |
| 226 :cmap <F7> <C-\>eAppendSome()<CR> | |
| 227 :func AppendSome() | |
| 27903 | 228 :let cmd = getcmdline() .. " Some()" |
| 7 | 229 :" place the cursor on the ) |
| 230 :call setcmdpos(strlen(cmd)) | |
| 231 :return cmd | |
| 232 :endfunc | |
| 531 | 233 < This doesn't work recursively, thus not when already editing |
| 3893 | 234 an expression. But it is possible to use in a mapping. |
| 531 | 235 |
| 7 | 236 *c_CTRL-Y* |
| 237 CTRL-Y When there is a modeless selection, copy the selection into | |
| 238 the clipboard. |modeless-selection| | |
| 239 If there is no selection CTRL-Y is inserted as a character. | |
| 240 | |
|
10244
876fbdd84e52
commit https://github.com/vim/vim/commit/2ec618c9feac4573b154510236ad8121c77d0eca
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
241 CTRL-M or CTRL-J *c_CTRL-M* *c_CTRL-J* *c_<NL>* *c_<CR>* *c_CR* |
| 7 | 242 <CR> or <NL> start entered command |
|
10244
876fbdd84e52
commit https://github.com/vim/vim/commit/2ec618c9feac4573b154510236ad8121c77d0eca
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
243 |
|
876fbdd84e52
commit https://github.com/vim/vim/commit/2ec618c9feac4573b154510236ad8121c77d0eca
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
244 CTRL-[ *c_CTRL-[* *c_<Esc>* *c_Esc* |
| 7 | 245 <Esc> When typed and 'x' not present in 'cpoptions', quit |
| 246 Command-line mode without executing. In macros or when 'x' | |
| 247 present in 'cpoptions', start entered command. | |
| 1620 | 248 Note: If your <Esc> key is hard to hit on your keyboard, train |
| 249 yourself to use CTRL-[. | |
| 7 | 250 *c_CTRL-C* |
| 251 CTRL-C quit command-line without executing | |
| 252 | |
| 2751 | 253 *c_<Up>* *c_Up* |
| 7 | 254 <Up> recall older command-line from history, whose beginning |
| 255 matches the current command-line (see below). | |
| 256 {not available when compiled without the |+cmdline_hist| | |
| 257 feature} | |
| 2751 | 258 *c_<Down>* *c_Down* |
| 7 | 259 <Down> recall more recent command-line from history, whose beginning |
| 260 matches the current command-line (see below). | |
| 261 {not available when compiled without the |+cmdline_hist| | |
| 262 feature} | |
| 263 | |
| 264 *c_<S-Up>* *c_<PageUp>* | |
| 265 <S-Up> or <PageUp> | |
| 266 recall older command-line from history | |
| 267 {not available when compiled without the |+cmdline_hist| | |
| 268 feature} | |
| 269 *c_<S-Down>* *c_<PageDown>* | |
| 270 <S-Down> or <PageDown> | |
| 271 recall more recent command-line from history | |
| 272 {not available when compiled without the |+cmdline_hist| | |
| 273 feature} | |
| 274 | |
| 275 CTRL-D command-line completion (see |cmdline-completion|) | |
| 276 'wildchar' option | |
| 277 command-line completion (see |cmdline-completion|) | |
| 278 CTRL-N command-line completion (see |cmdline-completion|) | |
| 279 CTRL-P command-line completion (see |cmdline-completion|) | |
| 280 CTRL-A command-line completion (see |cmdline-completion|) | |
| 281 CTRL-L command-line completion (see |cmdline-completion|) | |
| 282 | |
| 283 *c_CTRL-_* | |
| 284 CTRL-_ a - switch between Hebrew and English keyboard mode, which is | |
| 285 private to the command-line and not related to hkmap. | |
| 286 This is useful when Hebrew text entry is required in the | |
| 287 command-line, searches, abbreviations, etc. Applies only if | |
| 288 Vim is compiled with the |+rightleft| feature and the | |
| 289 'allowrevins' option is set. | |
| 290 See |rileft.txt|. | |
| 291 | |
| 292 b - switch between Farsi and English keyboard mode, which is | |
| 293 private to the command-line and not related to fkmap. In | |
| 294 Farsi keyboard mode the characters are inserted in reverse | |
| 295 insert manner. This is useful when Farsi text entry is | |
| 296 required in the command-line, searches, abbreviations, etc. | |
| 297 Applies only if Vim is compiled with the |+farsi| feature. | |
| 298 See |farsi.txt|. | |
| 299 | |
| 300 *c_CTRL-^* | |
| 301 CTRL-^ Toggle the use of language |:lmap| mappings and/or Input | |
| 302 Method. | |
| 303 When typing a pattern for a search command and 'imsearch' is | |
| 304 not -1, VAL is the value of 'imsearch', otherwise VAL is the | |
| 305 value of 'iminsert'. | |
| 306 When language mappings are defined: | |
| 307 - If VAL is 1 (langmap mappings used) it becomes 0 (no langmap | |
| 308 mappings used). | |
| 309 - If VAL was not 1 it becomes 1, thus langmap mappings are | |
| 310 enabled. | |
| 311 When no language mappings are defined: | |
| 312 - If VAL is 2 (Input Method is used) it becomes 0 (no input | |
| 313 method used) | |
| 314 - If VAL has another value it becomes 2, thus the Input Method | |
| 315 is enabled. | |
| 316 These language mappings are normally used to type characters | |
| 317 that are different from what the keyboard produces. The | |
| 318 'keymap' option can be used to install a whole number of them. | |
| 319 When entering a command line, langmap mappings are switched | |
| 320 off, since you are expected to type a command. After | |
| 321 switching it on with CTRL-^, the new state is not used again | |
| 322 for the next command or Search pattern. | |
| 323 | |
| 1121 | 324 *c_CTRL-]* |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
325 CTRL-] Trigger abbreviation, without inserting a character. |
| 1121 | 326 |
| 7 | 327 For Emacs-style editing on the command-line see |emacs-keys|. |
| 328 | |
| 329 The <Up> and <Down> keys take the current command-line as a search string. | |
| 330 The beginning of the next/previous command-lines are compared with this | |
| 331 string. The first line that matches is the new command-line. When typing | |
| 332 these two keys repeatedly, the same string is used again. For example, this | |
| 333 can be used to find the previous substitute command: Type ":s" and then <Up>. | |
| 334 The same could be done by typing <S-Up> a number of times until the desired | |
| 335 command-line is shown. (Note: the shifted arrow keys do not work on all | |
| 336 terminals) | |
| 337 | |
| 1484 | 338 *:his* *:history* |
| 7 | 339 :his[tory] Print the history of last entered commands. |
| 340 {not available when compiled without the |+cmdline_hist| | |
| 341 feature} | |
| 342 | |
| 343 :his[tory] [{name}] [{first}][, [{last}]] | |
| 344 List the contents of history {name} which can be: | |
| 3503 | 345 c[md] or : command-line history |
| 346 s[earch] or / or ? search string history | |
| 347 e[xpr] or = expression register history | |
| 348 i[nput] or @ input line history | |
| 349 d[ebug] or > debug command history | |
| 350 a[ll] all of the above | |
| 7 | 351 |
| 352 If the numbers {first} and/or {last} are given, the respective | |
| 353 range of entries from a history is listed. These numbers can | |
| 354 be specified in the following form: | |
| 355 *:history-indexing* | |
| 356 A positive number represents the absolute index of an entry | |
| 357 as it is given in the first column of a :history listing. | |
| 358 This number remains fixed even if other entries are deleted. | |
| 359 | |
| 360 A negative number means the relative position of an entry, | |
| 361 counted from the newest entry (which has index -1) backwards. | |
| 362 | |
| 363 Examples: | |
| 364 List entries 6 to 12 from the search history: > | |
| 365 :history / 6,12 | |
| 366 < | |
|
10434
f3bb76ec4155
commit https://github.com/vim/vim/commit/eebd84eb94ed7f59a06a52cb4863563642f58899
Christian Brabandt <cb@256bit.org>
parents:
10244
diff
changeset
|
367 List the penultimate entry from all histories: > |
|
f3bb76ec4155
commit https://github.com/vim/vim/commit/eebd84eb94ed7f59a06a52cb4863563642f58899
Christian Brabandt <cb@256bit.org>
parents:
10244
diff
changeset
|
368 :history all -2 |
|
f3bb76ec4155
commit https://github.com/vim/vim/commit/eebd84eb94ed7f59a06a52cb4863563642f58899
Christian Brabandt <cb@256bit.org>
parents:
10244
diff
changeset
|
369 < |
|
f3bb76ec4155
commit https://github.com/vim/vim/commit/eebd84eb94ed7f59a06a52cb4863563642f58899
Christian Brabandt <cb@256bit.org>
parents:
10244
diff
changeset
|
370 List the most recent two entries from all histories: > |
|
f3bb76ec4155
commit https://github.com/vim/vim/commit/eebd84eb94ed7f59a06a52cb4863563642f58899
Christian Brabandt <cb@256bit.org>
parents:
10244
diff
changeset
|
371 :history all -2, |
| 7 | 372 |
| 5467 | 373 :keepp[atterns] {command} *:keepp* *:keeppatterns* |
| 374 Execute {command}, without adding anything to the search | |
| 375 history | |
| 376 | |
| 7 | 377 ============================================================================== |
| 378 2. Command-line completion *cmdline-completion* | |
| 379 | |
| 380 When editing the command-line, a few commands can be used to complete the | |
| 381 word before the cursor. This is available for: | |
| 382 | |
| 383 - Command names: At the start of the command-line. | |
| 384 - Tags: Only after the ":tag" command. | |
| 385 - File names: Only after a command that accepts a file name or a setting for | |
| 386 an option that can be set to a file name. This is called file name | |
| 387 completion. | |
| 715 | 388 - Shell command names: After ":!cmd", ":r !cmd" and ":w !cmd". $PATH is used. |
| 7 | 389 - Options: Only after the ":set" command. |
| 390 - Mappings: Only after a ":map" or similar command. | |
| 391 - Variable and function names: Only after a ":if", ":call" or similar command. | |
| 392 | |
|
17781
04245f071792
patch 8.1.1887: the +cmdline_compl feature is not in the tiny version
Bram Moolenaar <Bram@vim.org>
parents:
17667
diff
changeset
|
393 The number of help item matches is limited (currently to 300) to avoid a long |
|
04245f071792
patch 8.1.1887: the +cmdline_compl feature is not in the tiny version
Bram Moolenaar <Bram@vim.org>
parents:
17667
diff
changeset
|
394 delay when there are very many matches. |
| 7 | 395 |
| 396 These are the commands that can be used: | |
| 397 | |
| 398 *c_CTRL-D* | |
| 399 CTRL-D List names that match the pattern in front of the cursor. | |
| 400 When showing file names, directories are highlighted (see | |
| 401 'highlight' option). Names where 'suffixes' matches are moved | |
| 402 to the end. | |
| 40 | 403 The 'wildoptions' option can be set to "tagfile" to list the |
| 404 file of matching tags. | |
| 7 | 405 *c_CTRL-I* *c_wildchar* *c_<Tab>* |
| 406 'wildchar' option | |
| 407 A match is done on the pattern in front of the cursor. The | |
| 408 match (if there are several, the first match) is inserted | |
| 409 in place of the pattern. (Note: does not work inside a | |
| 410 macro, because <Tab> or <Esc> are mostly used as 'wildchar', | |
| 411 and these have a special meaning in some macros.) When typed | |
| 412 again and there were multiple matches, the next | |
| 413 match is inserted. After the last match, the first is used | |
| 414 again (wrap around). | |
| 415 The behavior can be changed with the 'wildmode' option. | |
| 13912 | 416 *c_<S-Tab>* |
| 417 <S-Tab> Like 'wildchar' or <Tab>, but begin with the last match and | |
| 418 then go to the previous match. | |
| 419 <S-Tab> does not work everywhere. | |
| 7 | 420 *c_CTRL-N* |
| 421 CTRL-N After using 'wildchar' which got multiple matches, go to next | |
| 422 match. Otherwise recall more recent command-line from history. | |
| 13912 | 423 *c_CTRL-P* |
| 7 | 424 CTRL-P After using 'wildchar' which got multiple matches, go to |
| 425 previous match. Otherwise recall older command-line from | |
| 13912 | 426 history. |
| 7 | 427 *c_CTRL-A* |
| 428 CTRL-A All names that match the pattern in front of the cursor are | |
| 429 inserted. | |
| 430 *c_CTRL-L* | |
| 431 CTRL-L A match is done on the pattern in front of the cursor. If | |
| 432 there is one match, it is inserted in place of the pattern. | |
| 433 If there are multiple matches the longest common part is | |
| 434 inserted in place of the pattern. If the result is shorter | |
| 435 than the pattern, no completion is done. | |
|
9971
98b39d2eb895
commit https://github.com/vim/vim/commit/4d6f32cbfbaf324ac4a25c0206a5db0e9f7a48f7
Christian Brabandt <cb@256bit.org>
parents:
7384
diff
changeset
|
436 */_CTRL-L* |
| 771 | 437 When 'incsearch' is set, entering a search pattern for "/" or |
| 438 "?" and the current match is displayed then CTRL-L will add | |
|
2302
488be8cbe19c
Make CTRL-L in command line mode respect 'ignorecase' and 'smartcase'. (Martin
Bram Moolenaar <bram@vim.org>
parents:
2214
diff
changeset
|
439 one character from the end of the current match. If |
|
488be8cbe19c
Make CTRL-L in command line mode respect 'ignorecase' and 'smartcase'. (Martin
Bram Moolenaar <bram@vim.org>
parents:
2214
diff
changeset
|
440 'ignorecase' and 'smartcase' are set and the command line has |
|
488be8cbe19c
Make CTRL-L in command line mode respect 'ignorecase' and 'smartcase'. (Martin
Bram Moolenaar <bram@vim.org>
parents:
2214
diff
changeset
|
441 no uppercase characters, the added character is converted to |
|
488be8cbe19c
Make CTRL-L in command line mode respect 'ignorecase' and 'smartcase'. (Martin
Bram Moolenaar <bram@vim.org>
parents:
2214
diff
changeset
|
442 lowercase. |
|
9990
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
443 *c_CTRL-G* */_CTRL-G* |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
444 CTRL-G When 'incsearch' is set, entering a search pattern for "/" or |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
445 "?" and the current match is displayed then CTRL-G will move |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
446 to the next match (does not take |search-offset| into account) |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
447 Use CTRL-T to move to the previous match. Hint: on a regular |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
448 keyboard T is above G. |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
449 *c_CTRL-T* */_CTRL-T* |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
450 CTRL-T When 'incsearch' is set, entering a search pattern for "/" or |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
451 "?" and the current match is displayed then CTRL-T will move |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
452 to the previous match (does not take |search-offset| into |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
453 account). |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
454 Use CTRL-G to move to the next match. Hint: on a regular |
|
6a1793d9c895
commit https://github.com/vim/vim/commit/1195669f9e434fa9ab8b57ee9470bf951e4990b8
Christian Brabandt <cb@256bit.org>
parents:
9971
diff
changeset
|
455 keyboard T is above G. |
| 7 | 456 |
| 457 The 'wildchar' option defaults to <Tab> (CTRL-E when in Vi compatible mode; in | |
| 458 a previous version <Esc> was used). In the pattern standard wildcards '*' and | |
| 2581 | 459 '?' are accepted when matching file names. '*' matches any string, '?' |
| 460 matches exactly one character. | |
| 7 | 461 |
|
13950
741b1feeac9f
patch 8.0.1845: various comment updates needed, missing white space
Christian Brabandt <cb@256bit.org>
parents:
13912
diff
changeset
|
462 When repeating 'wildchar' or CTRL-N you cycle through the matches, eventually |
|
741b1feeac9f
patch 8.0.1845: various comment updates needed, missing white space
Christian Brabandt <cb@256bit.org>
parents:
13912
diff
changeset
|
463 ending up back to what was typed. If the first match is not what you wanted, |
|
741b1feeac9f
patch 8.0.1845: various comment updates needed, missing white space
Christian Brabandt <cb@256bit.org>
parents:
13912
diff
changeset
|
464 you can use <S-Tab> or CTRL-P to go straight back to what you typed. |
|
741b1feeac9f
patch 8.0.1845: various comment updates needed, missing white space
Christian Brabandt <cb@256bit.org>
parents:
13912
diff
changeset
|
465 |
| 3356 | 466 The 'wildignorecase' option can be set to ignore case in filenames. |
| 467 | |
|
11659
49c12c93abf3
Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents:
10498
diff
changeset
|
468 The 'wildmenu' option can be set to show the matches just above the command |
|
49c12c93abf3
Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents:
10498
diff
changeset
|
469 line. |
|
49c12c93abf3
Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents:
10498
diff
changeset
|
470 |
| 7 | 471 If you like tcsh's autolist completion, you can use this mapping: |
| 472 :cnoremap X <C-L><C-D> | |
| 473 (Where X is the command key to use, <C-L> is CTRL-L and <C-D> is CTRL-D) | |
| 474 This will find the longest match and then list all matching files. | |
| 475 | |
| 476 If you like tcsh's autolist completion, you can use the 'wildmode' option to | |
| 477 emulate it. For example, this mimics autolist=ambiguous: | |
| 478 :set wildmode=longest,list | |
| 479 This will find the longest match with the first 'wildchar', then list all | |
| 480 matching files with the next. | |
| 481 | |
| 19574 | 482 *complete-script-local-functions* |
| 483 When completing user function names, prepend "s:" to find script-local | |
| 484 functions. | |
| 485 | |
| 7 | 486 *suffixes* |
| 487 For file name completion you can use the 'suffixes' option to set a priority | |
| 488 between files with almost the same name. If there are multiple matches, | |
| 489 those files with an extension that is in the 'suffixes' option are ignored. | |
| 490 The default is ".bak,~,.o,.h,.info,.swp,.obj", which means that files ending | |
| 491 in ".bak", "~", ".o", ".h", ".info", ".swp" and ".obj" are sometimes ignored. | |
| 1937 | 492 |
| 493 An empty entry, two consecutive commas, match a file name that does not | |
| 494 contain a ".", thus has no suffix. This is useful to ignore "prog" and prefer | |
| 495 "prog.c". | |
| 496 | |
| 497 Examples: | |
| 7 | 498 |
| 499 pattern: files: match: ~ | |
| 500 test* test.c test.h test.o test.c | |
| 501 test* test.h test.o test.h and test.o | |
| 502 test* test.i test.h test.c test.i and test.c | |
| 503 | |
| 1937 | 504 It is impossible to ignore suffixes with two dots. |
| 505 | |
| 7 | 506 If there is more than one matching file (after ignoring the ones matching |
| 507 the 'suffixes' option) the first file name is inserted. You can see that | |
| 508 there is only one match when you type 'wildchar' twice and the completed | |
| 509 match stays the same. You can get to the other matches by entering | |
| 510 'wildchar', CTRL-N or CTRL-P. All files are included, also the ones with | |
| 511 extensions matching the 'suffixes' option. | |
| 512 | |
| 513 To completely ignore files with some extension use 'wildignore'. | |
| 514 | |
| 1484 | 515 To match only files that end at the end of the typed text append a "$". For |
| 516 example, to match only files that end in ".c": > | |
| 517 :e *.c$ | |
| 518 This will not match a file ending in ".cpp". Without the "$" it does match. | |
| 519 | |
| 7 | 520 The old value of an option can be obtained by hitting 'wildchar' just after |
| 521 the '='. For example, typing 'wildchar' after ":set dir=" will insert the | |
| 522 current value of 'dir'. This overrules file name completion for the options | |
| 523 that take a file name. | |
| 524 | |
| 525 If you would like using <S-Tab> for CTRL-P in an xterm, put this command in | |
| 526 your .cshrc: > | |
| 527 xmodmap -e "keysym Tab = Tab Find" | |
| 528 And this in your .vimrc: > | |
| 529 :cmap <Esc>[1~ <C-P> | |
| 530 | |
| 531 ============================================================================== | |
| 532 3. Ex command-lines *cmdline-lines* | |
| 533 | |
| 534 The Ex commands have a few specialties: | |
| 535 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
536 *:quote* *:comment* |
| 7 | 537 '"' at the start of a line causes the whole line to be ignored. '"' |
| 538 after a command causes the rest of the line to be ignored. This can be used | |
| 539 to add comments. Example: > | |
| 540 :set ai "set 'autoindent' option | |
| 541 It is not possible to add a comment to a shell command ":!cmd" or to the | |
| 14945 | 542 ":map" command and a few others (mainly commands that expect expressions) |
| 543 that see the '"' as part of their argument: | |
| 544 | |
| 545 :argdo | |
| 546 :autocmd | |
| 547 :bufdo | |
| 548 :cexpr (and the like) | |
| 549 :cdo (and the like) | |
| 550 :command | |
| 551 :cscope (and the like) | |
| 552 :debug | |
| 553 :display | |
| 554 :echo (and the like) | |
| 555 :elseif | |
| 556 :execute | |
| 557 :folddoopen | |
| 558 :folddoclosed | |
| 559 :for | |
| 560 :grep (and the like) | |
| 561 :help (and the like) | |
| 562 :if | |
| 563 :let | |
| 564 :make | |
| 565 :map (and the like including :abbrev commands) | |
| 566 :menu (and the like) | |
| 567 :mkspell | |
| 568 :normal | |
| 569 :ownsyntax | |
| 570 :popup | |
| 571 :promptfind (and the like) | |
| 572 :registers | |
| 573 :return | |
| 574 :sort | |
| 575 :syntax | |
| 576 :tabdo | |
| 577 :tearoff | |
| 578 :vimgrep (and the like) | |
| 579 :while | |
| 580 :windo | |
| 7 | 581 |
| 582 *:bar* *:\bar* | |
| 583 '|' can be used to separate commands, so you can give multiple commands in one | |
| 584 line. If you want to use '|' in an argument, precede it with '\'. | |
| 585 | |
| 586 These commands see the '|' as their argument, and can therefore not be | |
| 1620 | 587 followed by another Vim command: |
| 7 | 588 :argdo |
| 589 :autocmd | |
| 590 :bufdo | |
|
7092
64e30831fa42
commit https://github.com/vim/vim/commit/aa23b379421aa214e6543b06c974594a25799b09
Christian Brabandt <cb@256bit.org>
parents:
7013
diff
changeset
|
591 :cdo |
|
64e30831fa42
commit https://github.com/vim/vim/commit/aa23b379421aa214e6543b06c974594a25799b09
Christian Brabandt <cb@256bit.org>
parents:
7013
diff
changeset
|
592 :cfdo |
| 7 | 593 :command |
| 594 :cscope | |
| 595 :debug | |
| 19523 | 596 :eval |
| 7 | 597 :folddoopen |
| 598 :folddoclosed | |
| 599 :function | |
| 600 :global | |
| 601 :help | |
| 602 :helpfind | |
| 24387 | 603 :helpgrep |
| 664 | 604 :lcscope |
|
7092
64e30831fa42
commit https://github.com/vim/vim/commit/aa23b379421aa214e6543b06c974594a25799b09
Christian Brabandt <cb@256bit.org>
parents:
7013
diff
changeset
|
605 :ldo |
|
64e30831fa42
commit https://github.com/vim/vim/commit/aa23b379421aa214e6543b06c974594a25799b09
Christian Brabandt <cb@256bit.org>
parents:
7013
diff
changeset
|
606 :lfdo |
| 24387 | 607 :lhelpgrep |
| 7 | 608 :make |
| 609 :normal | |
| 610 :perl | |
| 611 :perldo | |
| 612 :promptfind | |
| 613 :promptrepl | |
| 614 :pyfile | |
| 615 :python | |
| 616 :registers | |
| 617 :read ! | |
| 618 :scscope | |
| 2152 | 619 :sign |
| 32004 | 620 :tabdo |
| 7 | 621 :tcl |
| 622 :tcldo | |
| 623 :tclfile | |
| 20241 | 624 :terminal |
| 7 | 625 :vglobal |
| 626 :windo | |
| 627 :write ! | |
| 628 :[range]! | |
| 629 a user defined command without the "-bar" argument |:command| | |
| 630 | |
| 631 Note that this is confusing (inherited from Vi): With ":g" the '|' is included | |
| 632 in the command, with ":s" it is not. | |
| 633 | |
| 634 To be able to use another command anyway, use the ":execute" command. | |
| 635 Example (append the output of "ls" and jump to the first line): > | |
| 636 :execute 'r !ls' | '[ | |
| 637 | |
| 638 There is one exception: When the 'b' flag is present in 'cpoptions', with the | |
| 639 ":map" and ":abbr" commands and friends CTRL-V needs to be used instead of | |
| 640 '\'. You can also use "<Bar>" instead. See also |map_bar|. | |
| 641 | |
| 642 Examples: > | |
| 643 :!ls | wc view the output of two commands | |
| 644 :r !ls | wc insert the same output in the text | |
| 645 :%g/foo/p|> moves all matching lines one shiftwidth | |
| 646 :%s/foo/bar/|> moves one line one shiftwidth | |
| 647 :map q 10^V| map "q" to "10|" | |
| 648 :map q 10\| map \ l map "q" to "10\" and map "\" to "l" | |
| 649 (when 'b' is present in 'cpoptions') | |
| 650 | |
| 651 You can also use <NL> to separate commands in the same way as with '|'. To | |
| 652 insert a <NL> use CTRL-V CTRL-J. "^@" will be shown. Using '|' is the | |
| 653 preferred method. But for external commands a <NL> must be used, because a | |
| 654 '|' is included in the external command. To avoid the special meaning of <NL> | |
| 655 it must be preceded with a backslash. Example: > | |
| 656 :r !date<NL>-join | |
| 657 This reads the current date into the file and joins it with the previous line. | |
| 658 | |
| 659 Note that when the command before the '|' generates an error, the following | |
| 660 commands will not be executed. | |
| 661 | |
| 662 | |
| 663 Because of Vi compatibility the following strange commands are supported: > | |
| 664 :| print current line (like ":p") | |
| 665 :3| print line 3 (like ":3p") | |
| 666 :3 goto line 3 | |
| 667 | |
| 668 A colon is allowed between the range and the command name. It is ignored | |
| 669 (this is Vi compatible). For example: > | |
| 670 :1,$:s/pat/string | |
| 671 | |
| 672 When the character '%' or '#' is used where a file name is expected, they are | |
| 673 expanded to the current and alternate file name (see the chapter "editing | |
| 674 files" |:_%| |:_#|). | |
| 675 | |
| 676 Embedded spaces in file names are allowed on the Amiga if one file name is | |
| 677 expected as argument. Trailing spaces will be ignored, unless escaped with a | |
| 678 backslash or CTRL-V. Note that the ":next" command uses spaces to separate | |
| 679 file names. Escape the spaces to include them in a file name. Example: > | |
| 680 :next foo\ bar goes\ to school\ | |
| 681 starts editing the three files "foo bar", "goes to" and "school ". | |
| 682 | |
| 683 When you want to use the special characters '"' or '|' in a command, or want | |
| 684 to use '%' or '#' in a file name, precede them with a backslash. The | |
| 685 backslash is not required in a range and in the ":substitute" command. | |
|
6951
b2673982c625
Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents:
6213
diff
changeset
|
686 See also |`=|. |
| 7 | 687 |
| 688 *:_!* | |
| 689 The '!' (bang) character after an Ex command makes the command behave in a | |
| 690 different way. The '!' should be placed immediately after the command, without | |
| 691 any blanks in between. If you insert blanks the '!' will be seen as an | |
| 692 argument for the command, which has a different meaning. For example: | |
| 693 :w! name write the current buffer to file "name", overwriting | |
| 694 any existing file | |
| 695 :w !name send the current buffer as standard input to command | |
| 696 "name" | |
| 697 | |
| 698 ============================================================================== | |
| 557 | 699 4. Ex command-line ranges *cmdline-ranges* *[range]* *E16* |
| 7 | 700 |
| 701 Some Ex commands accept a line range in front of them. This is noted as | |
| 702 [range]. It consists of one or more line specifiers, separated with ',' or | |
| 703 ';'. | |
| 704 | |
| 705 The basics are explained in section |10.3| of the user manual. | |
| 706 | |
| 26779 | 707 In |Vim9| script a range needs to be prefixed with a colon to avoid ambiguity |
| 708 with continuation lines. For example, "+" can be used for a range but is also | |
| 709 a continuation of an expression: > | |
| 710 var result = start | |
| 711 + print | |
| 712 If the "+" is a range then it must be prefixed with a colon: > | |
| 713 var result = start | |
| 714 :+ print | |
| 715 < | |
| 7 | 716 *:,* *:;* |
| 717 When separated with ';' the cursor position will be set to that line | |
| 718 before interpreting the next line specifier. This doesn't happen for ','. | |
| 719 Examples: > | |
| 720 4,/this line/ | |
| 721 < from line 4 till match with "this line" after the cursor line. > | |
| 722 5;/that line/ | |
| 723 < from line 5 till match with "that line" after line 5. | |
| 724 | |
| 725 The default line specifier for most commands is the cursor position, but the | |
| 726 commands ":write" and ":global" have the whole file (1,$) as default. | |
| 727 | |
| 728 If more line specifiers are given than required for the command, the first | |
| 729 one(s) will be ignored. | |
| 730 | |
| 17667 | 731 Line numbers may be specified with: *:range* *{address}* |
| 27537 | 732 {number} an absolute line number *E1247* |
| 7 | 733 . the current line *:.* |
| 734 $ the last line in the file *:$* | |
| 735 % equal to 1,$ (the entire file) *:%* | |
| 736 't position of mark t (lowercase) *:'* | |
| 737 'T position of mark T (uppercase); when the mark is in | |
| 738 another file it cannot be used in a range | |
| 739 /{pattern}[/] the next line where {pattern} matches *:/* | |
|
31053
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
740 also see |:range-pattern| below |
| 7 | 741 ?{pattern}[?] the previous line where {pattern} matches *:?* |
|
31053
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
742 also see |:range-pattern| below |
| 7 | 743 \/ the next line where the previously used search |
| 744 pattern matches | |
| 745 \? the previous line where the previously used search | |
| 746 pattern matches | |
| 747 \& the next line where the previously used substitute | |
| 748 pattern matches | |
| 749 | |
|
31053
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
750 *:range-offset* |
| 7 | 751 Each may be followed (several times) by '+' or '-' and an optional number. |
| 752 This number is added or subtracted from the preceding line number. If the | |
| 27036 | 753 number is omitted, 1 is used. If there is nothing before the '+' or '-' then |
| 754 the current line is used. | |
|
31053
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
755 *:range-closed-fold* |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
756 When a line number after the comma is in a closed fold it is adjusted to the |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
757 last line of the fold, thus the whole fold is included. |
| 7 | 758 |
|
31053
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
759 When a number is added this is done after the adjustment to the last line of |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
760 the fold. This means these lines are additionally included in the range. For |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
761 example: > |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
762 :3,4+2print |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
763 On this text: |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
764 1 one ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
765 2 two ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
766 3 three ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
767 4 four FOLDED ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
768 5 five FOLDED ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
769 6 six ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
770 7 seven ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
771 8 eight ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
772 Where lines four and five are a closed fold, ends up printing lines 3 to 7. |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
773 The 7 comes from the "4" in the range, which is adjusted to the end of the |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
774 closed fold, which is 5, and then the offset 2 is added. |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
775 |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
776 An example for subtracting (which isn't very useful): > |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
777 :2,4-1print |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
778 On this text: |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
779 1 one ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
780 2 two ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
781 3 three FOLDED~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
782 4 four FOLDED ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
783 5 five FOLDED ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
784 6 six FOLDED ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
785 7 seven ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
786 8 eight ~ |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
787 Where lines three to six are a closed fold, ends up printing lines 2 to 6. |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
788 The 6 comes from the "4" in the range, which is adjusted to the end of the |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
789 closed fold, which is 6, and then 1 is subtracted, then this is still in the |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
790 closed fold and the last line of that fold is used, which is 6. |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
791 |
|
39f96b1e7b8d
patch 9.0.0861: solution for "!!sort" in closed fold is not optimal
Bram Moolenaar <Bram@vim.org>
parents:
31028
diff
changeset
|
792 *:range-pattern* |
| 7 | 793 The "/" and "?" after {pattern} are required to separate the pattern from |
| 794 anything that follows. | |
| 795 | |
| 796 The "/" and "?" may be preceded with another address. The search starts from | |
| 797 there. The difference from using ';' is that the cursor isn't moved. | |
| 798 Examples: > | |
| 799 /pat1//pat2/ Find line containing "pat2" after line containing | |
| 800 "pat1", without moving the cursor. | |
| 801 7;/pat2/ Find line containing "pat2", after line 7, leaving | |
| 802 the cursor in line 7. | |
| 803 | |
| 804 The {number} must be between 0 and the number of lines in the file. When | |
| 805 using a 0 (zero) this is interpreted as a 1 by most commands. Commands that | |
| 806 use it as a count do use it as a zero (|:tag|, |:pop|, etc). Some commands | |
| 807 interpret the zero as "before the first line" (|:read|, search pattern, etc). | |
| 808 | |
| 809 Examples: > | |
| 810 .+3 three lines below the cursor | |
| 811 /that/+1 the line below the next line containing "that" | |
| 812 .,$ from current line until end of file | |
| 813 0;/that the first line containing "that", also matches in the | |
| 814 first line. | |
| 815 1;/that the first line after line 1 containing "that" | |
| 816 | |
| 817 Some commands allow for a count after the command. This count is used as the | |
| 818 number of lines to be used, starting with the line given in the last line | |
| 819 specifier (the default is the cursor line). The commands that accept a count | |
| 820 are the ones that use a range but do not have a file name argument (because | |
| 27036 | 821 a file name can also be a number). The count cannot be negative. |
| 7 | 822 |
| 823 Examples: > | |
| 824 :s/x/X/g 5 substitute 'x' by 'X' in the current line and four | |
| 825 following lines | |
| 826 :23d 4 delete lines 23, 24, 25 and 26 | |
| 827 | |
| 828 | |
| 829 Folds and Range | |
| 830 | |
| 831 When folds are active the line numbers are rounded off to include the whole | |
| 832 closed fold. See |fold-behavior|. | |
| 833 | |
| 834 | |
| 557 | 835 Reverse Range *E493* |
| 7 | 836 |
| 837 A range should have the lower line number first. If this is not the case, Vim | |
| 856 | 838 will ask you if it should swap the line numbers. |
| 557 | 839 Backwards range given, OK to swap ~ |
| 840 This is not done within the global command ":g". | |
| 841 | |
| 842 You can use ":silent" before a command to avoid the question, the range will | |
| 843 always be swapped then. | |
| 7 | 844 |
| 845 | |
| 846 Count and Range *N:* | |
| 847 | |
| 31028 | 848 When giving a count before entering ":", this is translated into: > |
| 7 | 849 :.,.+(count - 1) |
| 30547 | 850 In words: The "count" lines at and after the cursor. Example: To delete |
| 7 | 851 three lines: > |
| 852 3:d<CR> is translated into: .,.+2d<CR> | |
| 853 < | |
| 854 | |
| 25973 | 855 Visual Mode and Range |
| 24636 | 856 *v_:* |
| 7 | 857 {Visual}: Starts a command-line with the Visual selected lines as a |
| 4073 | 858 range. The code `:'<,'>` is used for this range, which makes |
| 7 | 859 it possible to select a similar line from the command-line |
| 860 history for repeating a command on different Visually selected | |
| 861 lines. | |
| 24636 | 862 |
| 863 :* *:star* *:star-visual-range* | |
| 4073 | 864 When Visual mode was already ended, a short way to use the |
| 865 Visual area for a range is `:*`. This requires that "*" does | |
| 866 not appear in 'cpo', see |cpo-star|. Otherwise you will have | |
| 867 to type `:'<,'>` | |
| 24636 | 868 For when "*" is in 'cpo' see |:star-compatible|. |
| 7 | 869 |
| 870 ============================================================================== | |
| 167 | 871 5. Ex command-line flags *ex-flags* |
| 872 | |
| 873 These flags are supported by a selection of Ex commands. They print the line | |
| 874 that the cursor ends up after executing the command: | |
| 875 | |
| 876 l output like for |:list| | |
| 877 # add line number | |
| 878 p output like for |:print| | |
| 879 | |
| 880 The flags can be combined, thus "l#" uses both a line number and |:list| style | |
| 881 output. | |
| 882 | |
| 883 ============================================================================== | |
| 884 6. Ex special characters *cmdline-special* | |
| 7 | 885 |
| 617 | 886 Note: These are special characters in the executed command line. If you want |
| 887 to insert special things while typing you can use the CTRL-R command. For | |
| 888 example, "%" stands for the current file name, while CTRL-R % inserts the | |
| 889 current file name right away. See |c_CTRL-R|. | |
| 890 | |
| 7013 | 891 Note: If you want to avoid the effects of special characters in a Vim script |
| 892 you may want to use |fnameescape()|. Also see |`=|. | |
| 1620 | 893 |
| 617 | 894 |
| 7 | 895 In Ex commands, at places where a file name can be used, the following |
| 896 characters have a special meaning. These can also be used in the expression | |
| 7013 | 897 function |expand()|. |
| 1733 | 898 % Is replaced with the current file name. *:_%* *c_%* |
| 899 # Is replaced with the alternate file name. *:_#* *c_#* | |
| 5510 | 900 This is remembered for every window. |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
901 #n (where n is a number) is replaced with *:_#0* *:_#n* |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
902 the file name of buffer n. "#0" is the same as "#". *c_#n* |
| 1733 | 903 ## Is replaced with all names in the argument list *:_##* *c_##* |
| 7 | 904 concatenated, separated by spaces. Each space in a name |
| 905 is preceded with a backslash. | |
| 1733 | 906 #<n (where n is a number > 0) is replaced with old *:_#<* *c_#<* |
| 907 file name n. See |:oldfiles| or |v:oldfiles| to get the | |
| 908 number. *E809* | |
|
2570
71b56b4e7785
Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
909 {only when compiled with the |+eval| and |+viminfo| features} |
| 23466 | 910 In |Vim9-script| # is used to start a comment, use %% for the alternate file |
| 911 name: | |
| 912 % Is replaced with the current file name. | |
| 913 %% Is replaced with the alternate file name. *:_%%* *c_%%* | |
| 914 %%n (where n is a number) is replaced with *:_%%0* *:_%%n* | |
| 915 the file name of buffer n. "%%0" is the same as "%%". *c_%%n* | |
| 916 %%% Is replaced with all names in the argument *:_%%%* *c_%%%#* | |
| 917 list concatenated, separated by spaces. | |
| 918 %%<n (where n is a number > 0) is replaced with old *:_%%<* *c_%%<* | |
| 919 file name n. | |
| 1733 | 920 |
| 921 Note that these, except "#<n", give the file name as it was typed. If an | |
| 922 absolute path is needed (when using the file name from a different directory), | |
| 923 you need to add ":p". See |filename-modifiers|. | |
| 924 | |
| 925 The "#<n" item returns an absolute path, but it will start with "~/" for files | |
| 926 below your home directory. | |
| 927 | |
| 7 | 928 Note that backslashes are inserted before spaces, so that the command will |
| 929 correctly interpret the file name. But this doesn't happen for shell | |
| 1733 | 930 commands. For those you probably have to use quotes (this fails for files |
| 931 that contain a quote and wildcards): > | |
| 7 | 932 :!ls "%" |
| 933 :r !spell "%" | |
| 934 | |
| 935 To avoid the special meaning of '%' and '#' insert a backslash before it. | |
| 936 Detail: The special meaning is always escaped when there is a backslash before | |
| 937 it, no matter how many backslashes. | |
| 938 you type: result ~ | |
| 939 # alternate.file | |
| 940 \# # | |
| 941 \\# \# | |
|
6951
b2673982c625
Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents:
6213
diff
changeset
|
942 Also see |`=|. |
| 7013 | 943 |
| 22328 | 944 *E499* *E500* |
| 7 | 945 Note: these are typed literally, they are not special keys! |
| 22328 | 946 *:<cword>* *<cword>* |
| 7 | 947 <cword> is replaced with the word under the cursor (like |star|) |
| 22328 | 948 *:<cWORD>* *<cWORD>* |
| 7 | 949 <cWORD> is replaced with the WORD under the cursor (see |WORD|) |
| 22328 | 950 *:<cexpr>* *<cexpr>* |
|
12421
da55ea30842c
patch 8.0.1090: cannot get the text under the cursor like v:beval_text
Christian Brabandt <cb@256bit.org>
parents:
11659
diff
changeset
|
951 <cexpr> is replaced with the word under the cursor, including more |
|
da55ea30842c
patch 8.0.1090: cannot get the text under the cursor like v:beval_text
Christian Brabandt <cb@256bit.org>
parents:
11659
diff
changeset
|
952 to form a C expression. E.g., when the cursor is on "arg" |
|
da55ea30842c
patch 8.0.1090: cannot get the text under the cursor like v:beval_text
Christian Brabandt <cb@256bit.org>
parents:
11659
diff
changeset
|
953 of "ptr->arg" then the result is "ptr->arg"; when the |
|
da55ea30842c
patch 8.0.1090: cannot get the text under the cursor like v:beval_text
Christian Brabandt <cb@256bit.org>
parents:
11659
diff
changeset
|
954 cursor is on "]" of "list[idx]" then the result is |
|
da55ea30842c
patch 8.0.1090: cannot get the text under the cursor like v:beval_text
Christian Brabandt <cb@256bit.org>
parents:
11659
diff
changeset
|
955 "list[idx]". This is used for |v:beval_text|. |
| 22328 | 956 *:<cfile>* *<cfile>* |
| 7 | 957 <cfile> is replaced with the path name under the cursor (like what |
| 958 |gf| uses) | |
| 22328 | 959 *:<afile>* *<afile>* |
| 2662 | 960 <afile> When executing autocommands, is replaced with the file name |
|
12756
3b26420fc639
Long overdue runtime update.
Christian Brabandt <cb@256bit.org>
parents:
12499
diff
changeset
|
961 of the buffer being manipulated, or the file for a read or |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
962 write. *E495* |
| 22328 | 963 *:<abuf>* *<abuf>* |
| 2662 | 964 <abuf> When executing autocommands, is replaced with the currently |
| 715 | 965 effective buffer number (for ":r file" and ":so file" it is |
| 966 the current buffer, the file being read/sourced is not in a | |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
967 buffer). *E496* |
| 22328 | 968 *:<amatch>* *<amatch>* |
| 2662 | 969 <amatch> When executing autocommands, is replaced with the match for |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
970 which this autocommand was executed. *E497* |
| 26438 | 971 It differs from <afile> when the file name isn't used to |
| 972 match with (for FileType, Syntax and SpellFileMissing | |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
973 events). |
| 26438 | 974 When the match is with a file name, it is expanded to the |
| 975 full path. | |
| 22328 | 976 *:<sfile>* *<sfile>* |
| 29290 | 977 <sfile> When executing a `:source` command, is replaced with the |
| 7013 | 978 file name of the sourced file. *E498* |
| 26304 | 979 When executing a legacy function, is replaced with the call |
| 980 stack, as with <stack> (this is for backwards | |
|
28403
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
981 compatibility, using <stack> or <script> is preferred). |
| 26304 | 982 In Vim9 script using <sfile> in a function gives error |
| 983 *E1245* . | |
|
21493
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
984 Note that filename-modifiers are useless when <sfile> is |
|
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
985 not used inside a script. |
| 22328 | 986 *:<stack>* *<stack>* |
|
21493
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
987 <stack> is replaced with the call stack, using |
|
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
988 "function {function-name}[{lnum}]" for a function line |
|
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
989 and "script {file-name}[{lnum}]" for a script line, and |
|
7449921216bc
patch 8.2.1297: when a test fails it's often not easy to see where
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
990 ".." in between items. E.g.: |
|
7147
c590de398af9
commit https://github.com/vim/vim/commit/ca63501fbcd1cf9c8aa9ff12c093c95b62a89ed7
Christian Brabandt <cb@256bit.org>
parents:
7092
diff
changeset
|
991 "function {function-name1}[{lnum}]..{function-name2}[{lnum}]" |
| 27036 | 992 If there is no call stack you get error *E489* . |
|
28403
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
993 *:<script>* *<script>* |
|
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
994 <script> When executing a `:source` command, is replaced with the file |
|
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
995 name of the sourced file. When executing a function, is |
|
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
996 replaced with the file name of the script where it is |
|
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
997 defined. |
|
2655935b5ccc
patch 8.2.4726: cannot use expand() to get the script name
Bram Moolenaar <Bram@vim.org>
parents:
27903
diff
changeset
|
998 If the file name cannot be determined you get error *E1274* . |
| 22328 | 999 *:<slnum>* *<slnum>* |
| 29290 | 1000 <slnum> When executing a `:source` command, is replaced with the |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
1001 line number. *E842* |
| 2662 | 1002 When executing a function it's the line number relative to |
| 1003 the start of the function. | |
| 22328 | 1004 *:<sflnum>* *<sflnum>* |
|
14700
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
1005 <sflnum> When executing a script, is replaced with the line number. |
|
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
1006 It differs from <slnum> in that <sflnum> is replaced with |
|
0a3b9ecf7cb8
patch 8.1.0362: cannot get the script line number when executing a function
Christian Brabandt <cb@256bit.org>
parents:
14421
diff
changeset
|
1007 the script line number in any situation. *E961* |
| 22328 | 1008 *:<client>* *<client>* |
| 1009 <client> is replaced with the {clinetid} of the last received | |
| 1010 message in |server2client()| | |
| 7 | 1011 |
| 1012 *filename-modifiers* | |
|
5692
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5510
diff
changeset
|
1013 *:_%:* *::8* *::p* *::.* *::~* *::h* *::t* *::r* *::e* *::s* *::gs* *::S* |
|
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5510
diff
changeset
|
1014 *%:8* *%:p* *%:.* *%:~* *%:h* *%:t* *%:r* *%:e* *%:s* *%:gs* *%:S* |
| 7 | 1015 The file name modifiers can be used after "%", "#", "#n", "<cfile>", "<sfile>", |
| 1016 "<afile>" or "<abuf>". They are also used with the |fnamemodify()| function. | |
| 18016 | 1017 |
| 7 | 1018 These modifiers can be given, in this order: |
| 1019 :p Make file name a full path. Must be the first modifier. Also | |
| 1020 changes "~/" (and "~user/" for Unix and VMS) to the path for | |
| 1021 the home directory. If the name is a directory a path | |
| 1022 separator is added at the end. For a file name that does not | |
| 1023 exist and does not have an absolute path the result is | |
| 3682 | 1024 unpredictable. On MS-Windows an 8.3 filename is expanded to |
| 1025 the long name. | |
| 7 | 1026 :8 Converts the path to 8.3 short format (currently only on |
| 3682 | 1027 MS-Windows). Will act on as much of a path that is an |
| 1028 existing path. | |
| 7 | 1029 :~ Reduce file name to be relative to the home directory, if |
| 1030 possible. File name is unmodified if it is not below the home | |
| 1031 directory. | |
| 1032 :. Reduce file name to be relative to current directory, if | |
| 1033 possible. File name is unmodified if it is not below the | |
|
19299
8b710057093c
patch 8.2.0208: fnamemodify() does not apply ":~" when followed by ":."
Bram Moolenaar <Bram@vim.org>
parents:
18972
diff
changeset
|
1034 current directory. |
| 7 | 1035 For maximum shortness, use ":~:.". |
| 1036 :h Head of the file name (the last component and any separators | |
| 1037 removed). Cannot be used with :e, :r or :t. | |
| 1038 Can be repeated to remove several components at the end. | |
| 1039 When the file name ends in a path separator, only the path | |
| 1040 separator is removed. Thus ":p:h" on a directory name results | |
| 1041 on the directory name itself (without trailing slash). | |
| 1042 When the file name is an absolute path (starts with "/" for | |
| 18972 | 1043 Unix; "x:\" for Win32; "drive:" for Amiga), that part is not |
|
18912
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1044 removed. When there is no head (path is relative to current |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1045 directory) the result is empty. |
| 7 | 1046 :t Tail of the file name (last component of the name). Must |
| 1047 precede any :r or :e. | |
| 1048 :r Root of the file name (the last extension removed). When | |
| 1049 there is only an extension (file name that starts with '.', | |
| 1050 e.g., ".vimrc"), it is not removed. Can be repeated to remove | |
| 1051 several extensions (last one first). | |
| 1052 :e Extension of the file name. Only makes sense when used alone. | |
| 1053 When there is no extension the result is empty. | |
| 1054 When there is only an extension (file name that starts with | |
| 1055 '.'), the result is empty. Can be repeated to include more | |
| 1056 extensions. If there are not enough extensions (but at least | |
| 1057 one) as much as possible are included. | |
| 1058 :s?pat?sub? | |
| 1059 Substitute the first occurrence of "pat" with "sub". This | |
| 1060 works like the |:s| command. "pat" is a regular expression. | |
| 1061 Any character can be used for '?', but it must not occur in | |
| 1062 "pat" or "sub". | |
| 1063 After this, the previous modifiers can be used again. For | |
| 1064 example ":p", to make a full path after the substitution. | |
| 1065 :gs?pat?sub? | |
| 2751 | 1066 Substitute all occurrences of "pat" with "sub". Otherwise |
| 7 | 1067 this works like ":s". |
| 7013 | 1068 :S Escape special characters for use with a shell command (see |
|
5692
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5510
diff
changeset
|
1069 |shellescape()|). Must be the last one. Examples: > |
|
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5510
diff
changeset
|
1070 :!dir <cfile>:S |
|
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5510
diff
changeset
|
1071 :call system('chmod +w -- ' . expand('%:S')) |
| 7 | 1072 |
| 1073 Examples, when the file name is "src/version.c", current dir | |
| 1074 "/home/mool/vim": > | |
| 1075 :p /home/mool/vim/src/version.c | |
| 1076 :p:. src/version.c | |
| 1077 :p:~ ~/vim/src/version.c | |
| 1078 :h src | |
| 1079 :p:h /home/mool/vim/src | |
| 1080 :p:h:h /home/mool/vim | |
| 1081 :t version.c | |
| 1082 :p:t version.c | |
| 1083 :r src/version | |
| 1084 :p:r /home/mool/vim/src/version | |
| 1085 :t:r version | |
| 1086 :e c | |
| 1087 :s?version?main? src/main.c | |
| 1088 :s?version?main?:p /home/mool/vim/src/main.c | |
| 1089 :p:gs?/?\\? \home\mool\vim\src\version.c | |
| 1090 | |
| 1091 Examples, when the file name is "src/version.c.gz": > | |
| 1092 :p /home/mool/vim/src/version.c.gz | |
| 1093 :e gz | |
| 1094 :e:e c.gz | |
| 1095 :e:e:e c.gz | |
| 1096 :e:e:r c | |
| 1097 :r src/version.c | |
| 1098 :r:e c | |
| 1099 :r:r src/version | |
| 1100 :r:r:r src/version | |
| 1101 < | |
| 1102 *extension-removal* *:_%<* | |
| 1103 If a "<" is appended to "%", "#", "#n" or "CTRL-V p" the extension of the file | |
| 1104 name is removed (everything after and including the last '.' in the file | |
| 1105 name). This is included for backwards compatibility with version 3.0, the | |
| 1106 ":r" form is preferred. Examples: > | |
| 1107 | |
| 1108 % current file name | |
| 1109 %< current file name without extension | |
| 1110 # alternate file name for current window | |
| 1111 #< idem, without extension | |
| 1112 #31 alternate file number 31 | |
| 1113 #31< idem, without extension | |
| 1114 <cword> word under the cursor | |
| 1115 <cWORD> WORD under the cursor (see |WORD|) | |
| 1116 <cfile> path name under the cursor | |
| 1117 <cfile>< idem, without extension | |
| 1118 | |
| 1119 Note: Where a file name is expected wildcards expansion is done. On Unix the | |
| 1120 shell is used for this, unless it can be done internally (for speed). | |
| 7013 | 1121 Unless in |restricted-mode|, backticks work also, like in > |
| 7 | 1122 :n `echo *.c` |
| 1123 But expansion is only done if there are any wildcards before expanding the | |
| 1124 '%', '#', etc.. This avoids expanding wildcards inside a file name. If you | |
| 1125 want to expand the result of <cfile>, add a wildcard character to it. | |
| 1126 Examples: (alternate file name is "?readme?") | |
| 1127 command expands to ~ | |
| 1128 :e # :e ?readme? | |
| 1129 :e `ls #` :e {files matching "?readme?"} | |
| 1130 :e #.* :e {files matching "?readme?.*"} | |
| 1131 :cd <cfile> :cd {file name under cursor} | |
| 1132 :cd <cfile>* :cd {file name under cursor plus "*" and then expanded} | |
|
6951
b2673982c625
Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents:
6213
diff
changeset
|
1133 Also see |`=|. |
| 7 | 1134 |
| 1135 When the expanded argument contains a "!" and it is used for a shell command | |
| 1620 | 1136 (":!cmd", ":r !cmd" or ":w !cmd"), the "!" is escaped with a backslash to |
| 1137 avoid it being expanded into a previously used command. When the 'shell' | |
| 1138 option contains "sh", this is done twice, to avoid the shell trying to expand | |
| 1139 the "!". | |
| 7 | 1140 |
| 1141 *filename-backslash* | |
|
18912
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1142 For filesystems that use a backslash as directory separator (MS-Windows), it's |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1143 a bit difficult to recognize a backslash that is used to escape the special |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1144 meaning of the next character. The general rule is: If the backslash is |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1145 followed by a normal file name character, it does not have a special meaning. |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1146 Therefore "\file\foo" is a valid file name, you don't have to type the |
|
ccd16426a1f9
patch 8.2.0017: OS/2 and MS-DOS are still mentioned
Bram Moolenaar <Bram@vim.org>
parents:
18879
diff
changeset
|
1147 backslash twice. |
| 7 | 1148 |
| 1149 An exception is the '$' sign. It is a valid character in a file name. But | |
| 1150 to avoid a file name like "$home" to be interpreted as an environment variable, | |
| 1151 it needs to be preceded by a backslash. Therefore you need to use "/\$home" | |
| 1152 for the file "$home" in the root directory. A few examples: | |
| 1153 | |
| 1154 FILE NAME INTERPRETED AS ~ | |
| 1155 $home expanded to value of environment var $home | |
| 1156 \$home file "$home" in current directory | |
| 1157 /\$home file "$home" in root directory | |
| 1158 \\$home file "\\", followed by expanded $home | |
| 7013 | 1159 |
|
6951
b2673982c625
Updated and new runtime files.
Bram Moolenaar <bram@vim.org>
parents:
6213
diff
changeset
|
1160 Also see |`=|. |
| 7 | 1161 |
| 1162 ============================================================================== | |
| 4229 | 1163 7. Command-line window *cmdline-window* *cmdwin* |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1164 *command-line-window* |
| 7 | 1165 In the command-line window the command line can be edited just like editing |
| 1166 text in any window. It is a special kind of window, because you cannot leave | |
| 1167 it in a normal way. | |
| 1168 | |
| 1169 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1170 OPEN *c_CTRL-F* *q:* *q/* *q?* |
| 7 | 1171 |
| 1172 There are two ways to open the command-line window: | |
| 1173 1. From Command-line mode, use the key specified with the 'cedit' option. | |
| 1174 The default is CTRL-F when 'compatible' is not set. | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1175 2. From Normal mode, use the "q:", "q/" or "q?" command. |
| 7 | 1176 This starts editing an Ex command-line ("q:") or search string ("q/" or |
| 1177 "q?"). Note that this is not possible while recording is in progress (the | |
| 1178 "q" stops recording then). | |
| 1179 | |
| 1180 When the window opens it is filled with the command-line history. The last | |
| 1181 line contains the command as typed so far. The left column will show a | |
| 1182 character that indicates the type of command-line being edited, see | |
| 1183 |cmdwin-char|. | |
| 1184 | |
| 1185 Vim will be in Normal mode when the editor is opened, except when 'insertmode' | |
| 1186 is set. | |
| 29533 | 1187 *E1292* |
| 1188 Once a command-line window is open it is not possible to open another one. | |
| 7 | 1189 |
| 1190 The height of the window is specified with 'cmdwinheight' (or smaller if there | |
| 1191 is no room). The window is always full width and is positioned just above the | |
| 1192 command-line. | |
| 1193 | |
| 1194 | |
| 1195 EDIT | |
| 1196 | |
| 1197 You can now use commands to move around and edit the text in the window. Both | |
| 1198 in Normal mode and Insert mode. | |
| 1199 | |
| 1200 It is possible to use ":", "/" and other commands that use the command-line, | |
| 1201 but it's not possible to open another command-line window then. There is no | |
| 1202 nesting. | |
| 24751 | 1203 *E11* *E1188* |
| 7 | 1204 The command-line window is not a normal window. It is not possible to move to |
| 1205 another window or edit another buffer. All commands that would do this are | |
| 1206 disabled in the command-line window. Of course it _is_ possible to execute | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1207 any command that you entered in the command-line window. Other text edits are |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1208 discarded when closing the window. |
| 7 | 1209 |
| 1210 | |
| 1211 CLOSE *E199* | |
| 1212 | |
| 1213 There are several ways to leave the command-line window: | |
| 1214 | |
| 1215 <CR> Execute the command-line under the cursor. Works both in | |
| 1216 Insert and in Normal mode. | |
| 1217 CTRL-C Continue in Command-line mode. The command-line under the | |
| 1218 cursor is used as the command-line. Works both in Insert and | |
|
10498
883396809b45
commit https://github.com/vim/vim/commit/bc2eada5424bff06f7eb77c032ecc067da52b846
Christian Brabandt <cb@256bit.org>
parents:
10434
diff
changeset
|
1219 in Normal mode. There is no redraw, thus the window will |
|
883396809b45
commit https://github.com/vim/vim/commit/bc2eada5424bff06f7eb77c032ecc067da52b846
Christian Brabandt <cb@256bit.org>
parents:
10434
diff
changeset
|
1220 remain visible. |
| 7 | 1221 :quit Discard the command line and go back to Normal mode. |
| 21825 | 1222 ":close", CTRL-W c, ":exit", ":xit" and CTRL-\ CTRL-N also |
| 1223 work. | |
| 7 | 1224 :qall Quit Vim, unless there are changes in some buffer. |
| 1225 :qall! Quit Vim, discarding changes to any buffer. | |
| 1226 | |
| 1227 Once the command-line window is closed the old window sizes are restored. The | |
| 1228 executed command applies to the window and buffer where the command-line was | |
| 1229 started from. This works as if the command-line window was not there, except | |
| 1230 that there will be an extra screen redraw. | |
| 1231 The buffer used for the command-line window is deleted. Any changes to lines | |
| 1232 other than the one that is executed with <CR> are lost. | |
| 1233 | |
| 711 | 1234 If you would like to execute the command under the cursor and then have the |
| 1235 command-line window open again, you may find this mapping useful: > | |
| 1236 | |
| 1698 | 1237 :autocmd CmdwinEnter * map <buffer> <F5> <CR>q: |
| 711 | 1238 |
| 7 | 1239 |
| 1240 VARIOUS | |
| 1241 | |
| 1242 The command-line window cannot be used: | |
| 1243 - when there already is a command-line window (no nesting) | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1937
diff
changeset
|
1244 - for entering an encryption key or when using inputsecret() |
| 7 | 1245 |
| 1246 Some options are set when the command-line window is opened: | |
| 1247 'filetype' "vim", when editing an Ex command-line; this starts Vim syntax | |
| 1248 highlighting if it was enabled | |
| 1249 'rightleft' off | |
| 1250 'modifiable' on | |
| 1251 'buftype' "nofile" | |
| 1252 'swapfile' off | |
| 1253 | |
| 1254 It is allowed to write the buffer contents to a file. This is an easy way to | |
| 1255 save the command-line history and read it back later. | |
| 1256 | |
| 1257 If the 'wildchar' option is set to <Tab>, and the command-line window is used | |
| 1258 for an Ex command, then two mappings will be added to use <Tab> for completion | |
| 1259 in the command-line window, like this: > | |
| 29193 | 1260 :inoremap <buffer> <Tab> <C-X><C-V> |
| 1261 :nnoremap <buffer> <Tab> a<C-X><C-V> | |
| 7 | 1262 Note that hitting <Tab> in Normal mode will do completion on the next |
| 1263 character. That way it works at the end of the line. | |
| 1264 If you don't want these mappings, disable them with: > | |
| 1265 au CmdwinEnter [:>] iunmap <Tab> | |
| 1266 au CmdwinEnter [:>] nunmap <Tab> | |
| 1267 You could put these lines in your vimrc file. | |
| 1268 | |
| 1269 While in the command-line window you cannot use the mouse to put the cursor in | |
| 1270 another window, or drag statuslines of other windows. You can drag the | |
| 1271 statusline of the command-line window itself and the statusline above it. | |
| 1272 Thus you can resize the command-line window, but not others. | |
| 1273 | |
| 6153 | 1274 The |getcmdwintype()| function returns the type of the command-line being |
| 1275 edited as described in |cmdwin-char|. | |
| 1276 | |
| 7 | 1277 |
| 1278 AUTOCOMMANDS | |
| 1279 | |
|
18043
5a0d5f8e1778
patch 8.1.2017: cannot execute commands after closing the cmdline window
Bram Moolenaar <Bram@vim.org>
parents:
18016
diff
changeset
|
1280 Two autocommand events are used: |CmdwinEnter| and |CmdwinLeave|. You can use |
|
5a0d5f8e1778
patch 8.1.2017: cannot execute commands after closing the cmdline window
Bram Moolenaar <Bram@vim.org>
parents:
18016
diff
changeset
|
1281 the Cmdwin events to do settings specifically for the command-line window. |
|
5a0d5f8e1778
patch 8.1.2017: cannot execute commands after closing the cmdline window
Bram Moolenaar <Bram@vim.org>
parents:
18016
diff
changeset
|
1282 Be careful not to cause side effects! |
| 7 | 1283 Example: > |
| 1698 | 1284 :au CmdwinEnter : let b:cpt_save = &cpt | set cpt=. |
| 7 | 1285 :au CmdwinLeave : let &cpt = b:cpt_save |
| 1698 | 1286 This sets 'complete' to use completion in the current window for |i_CTRL-N|. |
| 7 | 1287 Another example: > |
| 1288 :au CmdwinEnter [/?] startinsert | |
| 1289 This will make Vim start in Insert mode in the command-line window. | |
| 1290 | |
| 1291 *cmdwin-char* | |
| 1292 The character used for the pattern indicates the type of command-line: | |
| 1293 : normal Ex command | |
| 1294 > debug mode command |debug-mode| | |
| 1295 / forward search string | |
| 1296 ? backward search string | |
| 1297 = expression for "= |expr-register| | |
| 1298 @ string for |input()| | |
| 1299 - text for |:insert| or |:append| | |
| 1300 | |
| 14421 | 1301 vim:tw=78:ts=8:noet:ft=help:norl: |