1*motion.txt* For Vim version 7.0aa. Last change: 2004 Sep 07 2 3 4 VIM REFERENCE MANUAL by Bram Moolenaar 5 6 7Cursor motions *cursor-motions* *navigation* 8 9These commands move the cursor position. If the new position is off of the 10screen, the screen is scrolled to show the cursor (see also 'scrolljump' and 11'scrolloff' options). 12 131. Motions and operators |operator| 142. Left-right motions |left-right-motions| 153. Up-down motions |up-down-motions| 164. Word motions |word-motions| 175. Text object motions |object-motions| 186. Text object selection |object-select| 197. Marks |mark-motions| 208. Jumps |jump-motions| 219. Various motions |various-motions| 22 23General remarks: 24 25If you want to know where you are in the file use the "CTRL-G" command 26|CTRL-G| or the "g CTRL-G" command |g_CTRL-G|. If you set the 'ruler' option, 27the cursor position is continuously shown in the status line (which slows down 28Vim a little). 29 30Experienced users prefer the hjkl keys because they are always right under 31their fingers. Beginners often prefer the arrow keys, because they do not 32know what the hjkl keys do. The mnemonic value of hjkl is clear from looking 33at the keyboard. Think of j as an arrow pointing downwards. 34 35The 'virtualedit' option can be set to make it possible to move the cursor to 36positions where there is no character or halfway a character. 37 38============================================================================== 391. Motions and operators *operator* 40 41The motion commands can be used after an operator command, to have the command 42operate on the text that was moved over. That is the text between the cursor 43position before and after the motion. Operators are generally used to delete 44or change text. The following operators are available: 45 46 |c| c change 47 |d| d delete 48 |y| y yank into register (does not change the text) 49 |~| ~ swap case (only if 'tildeop' is set) 50 |g~| g~ swap case 51 |gu| gu make lowercase 52 |gU| gU make uppercase 53 |!| ! filter through an external program 54 |=| = filter through 'equalprg' or C-indenting if empty 55 |gq| gq text formatting 56 |g?| g? ROT13 encoding 57 |>| > shift right 58 |<| < shift left 59 |zf| zf define a fold 60 61If the motion includes a count and the operator also had a count before it, 62the two counts are multiplied. For example: "2d3w" deletes six words. 63 64After applying the operator the cursor is mostly left at the start of the text 65that was operated upon. For example, "yfe" doesn't move the cursor, but "yFe" 66moves the cursor leftwards to the "e" where the yank started. 67 68 *linewise* *characterwise* 69The operator either affects whole lines, or the characters between the start 70and end position. Generally, motions that move between lines affect lines 71(are linewise), and motions that move within a line affect characters (are 72characterwise). However, there are some exceptions. 73 74 *exclusive* *inclusive* 75A character motion is either inclusive or exclusive. When inclusive, the start 76and end position of the motion are included in the operation. When exclusive, 77the last character towards the end of the buffer is not included. Linewise 78motions always include the start and end position. 79 80Which motions are linewise, inclusive or exclusive is mentioned below. There 81are however, two general exceptions: 821. If the motion is exclusive and the end of the motion is in column 1, the 83 end of the motion is moved to the end of the previous line and the motion 84 becomes inclusive. Example: "}" moves to the first line after a paragraph, 85 but "d}" will not include that line. 86 *exclusive-linewise* 872. If the motion is exclusive, the end of the motion is in column 1 and the 88 start of the motion was at or before the first non-blank in the line, the 89 motion becomes linewise. Example: If a paragraph begins with some blanks 90 and you do "d}" while standing on the first non-blank, all the lines of 91 the paragraph are deleted, including the blanks. If you do a put now, the 92 deleted lines will be inserted below the cursor position. 93 94Note that when the operator is pending (the operator command is typed, but the 95motion isn't yet), a special set of mappings can be used. See |:omap|. 96 97Instead of first giving the operator and then a motion you can use Visual 98mode: mark the start of the text with "v", move the cursor to the end of the 99text that is to be affected and then hit the operator. The text between the 100start and the cursor position is highlighted, so you can see what text will 101be operated upon. This allows much more freedom, but requires more key 102strokes and has limited redo functionality. See the chapter on Visual mode 103|Visual-mode|. 104 105You can use a ":" command for a motion. For example "d:call FindEnd()". 106But this can't be redone with "." if the command is more than one line. 107This can be repeated: > 108 d:call search("f")<CR> 109This cannot be repeated: > 110 d:if 1<CR> 111 call search("f")<CR> 112 endif<CR> 113 114 115FORCING A MOTION TO BE LINEWISE, CHARACTERWISE OR BLOCKWISE 116 117When a motion is not of the type you would like to use, you can force another 118type by using "v", "V" or CTRL-V just after the operator. 119Example: > 120 dj 121deletes two lines > 122 dvj 123deletes from the cursor position until the character below the cursor > 124 d<C-V>j 125deletes the character under the cursor and the character below the cursor. > 126 127Be careful with forcing a linewise movement to be used characterwise or 128blockwise, the column may not always be defined. 129 130 *o_v* 131v When used after an operator, before the motion command: Force 132 the operator to work characterwise, also when the motion is 133 linewise. If the motion was linewise, it will become 134 |exclusive|. 135 If the motion already was characterwise, toggle 136 inclusive/exclusive. This can be used to make an exclusive 137 motion inclusive and an inclusive motion exclusive. 138 139 *o_V* 140V When used after an operator, before the motion command: Force 141 the operator to work linewise, also when the motion is 142 characterwise. 143 144 *o_CTRL-V* 145CTRL-V When used after an operator, before the motion command: Force 146 the operator to work blockwise. This works like Visual block 147 mode selection, with the corners defined by the cursor 148 position before and after the motion. 149 150============================================================================== 1512. Left-right motions *left-right-motions* 152 153h or *h* 154<Left> or *<Left>* 155CTRL-H or *CTRL-H* *<BS>* 156<BS> [count] characters to the left. |exclusive| motion. 157 Note: If you prefer <BS> to delete a character, use 158 the mapping: 159 :map CTRL-V<BS> X 160 (to enter "CTRL-V<BS>" type the CTRL-V key, followed 161 by the <BS> key) 162 See |:fixdel| if the <BS> key does not do what you 163 want. 164 165l or *l* 166<Right> or *<Right>* *<Space>* 167<Space> [count] characters to the right. |exclusive| motion. 168 169 *0* 1700 To the first character of the line. |exclusive| 171 motion. When moving up or down, stay in same screen 172 column (if possible). 173 174 *<Home>* *<kHome>* 175<Home> To the first character of the line. |exclusive| 176 motion. When moving up or down, stay in same text 177 column (if possible). Works like "1|", which differs 178 from "0" when the line starts with a <Tab>. {not in 179 Vi} 180 181 *^* 182^ To the first non-blank character of the line. 183 |exclusive| motion. 184 185 *$* *<End>* *<kEnd>* 186$ or <End> To the end of the line. When a count is given also go 187 [count - 1] lines downward |inclusive|. 188 In Visual mode the cursor goes to just after the last 189 character in the line. 190 When 'virtualedit' is active, "$" may move the cursor 191 back from past the end of the line to the last 192 character in the line. 193 194 *g_* 195g_ To the last non-blank character of the line and 196 [count - 1] lines downward |inclusive|. {not in Vi} 197 198 *g0* *g<Home>* 199g0 or g<Home> When lines wrap ('wrap' on): To the first character of 200 the screen line. |exclusive| motion. Differs from 201 "0" when a line is wider than the screen. 202 When lines don't wrap ('wrap' off): To the leftmost 203 character of the current line that is on the screen. 204 Differs from "0" when the first character of the line 205 is not on the screen. {not in Vi} 206 207 *g^* 208g^ When lines wrap ('wrap' on): To the first non-blank 209 character of the screen line. |exclusive| motion. 210 Differs from "^" when a line is wider than the screen. 211 When lines don't wrap ('wrap' off): To the leftmost 212 non-blank character of the current line that is on the 213 screen. Differs from "^" when the first non-blank 214 character of the line is not on the screen. {not in 215 Vi} 216 217 *gm* 218gm Like "g0", but half a screenwidth to the right (or as 219 much as possible). {not in Vi} 220 221 *g$* *g<End>* 222g$ or g<End> When lines wrap ('wrap' on): To the last character of 223 the screen line and [count - 1] screen lines downward 224 |inclusive|. Differs from "$" when a line is wider 225 than the screen. 226 When lines don't wrap ('wrap' off): To the rightmost 227 character of the current line that is visible on the 228 screen. Differs from "$" when the last character of 229 the line is not on the screen or when a count is used. 230 Additionally, vertical movements keep the column, 231 instead of going to the end of the line. 232 {not in Vi} 233 234 *bar* 235| To screen column [count] in the current line. 236 |exclusive| motion. 237 238 *f* 239f{char} To [count]'th occurrence of {char} to the right. The 240 cursor is placed on {char} |inclusive|. 241 {char} can be entered as a digraph |digraph-arg|. 242 When 'encoding' is set to Unicode, composing 243 characters may be used, see |utf-8-char-arg|. 244 |:lmap| mappings apply to {char}. The CTRL-^ command 245 in Insert mode can be used to switch this on/off 246 |i_CTRL-^|. 247 248 *F* 249F{char} To the [count]'th occurrence of {char} to the left. 250 The cursor is placed on {char} |inclusive|. 251 {char} can be entered like with the |f| command. 252 253 *t* 254t{char} Till before [count]'th occurrence of {char} to the 255 right. The cursor is placed on the character left of 256 {char} |inclusive|. 257 {char} can be entered like with the |f| command. 258 259 *T* 260T{char} Till after [count]'th occurrence of {char} to the 261 left. The cursor is placed on the character right of 262 {char} |inclusive|. 263 {char} can be entered like with the |f| command. 264 265 *;* 266; Repeat latest f, t, F or T [count] times. 267 268 *,* 269, Repeat latest f, t, F or T in opposite direction 270 [count] times. 271 272These commands move the cursor to the specified column in the current line. 273They stop at the first column and at the end of the line, except "$", which 274may move to one of the next lines. See 'whichwrap' option to make some of the 275commands move across line boundaries. 276 277============================================================================== 2783. Up-down motions *up-down-motions* 279 280k or *k* 281<Up> or *<Up>* *CTRL-P* 282CTRL-P [count] lines upward |linewise|. 283 284j or *j* 285<Down> or *<Down>* 286CTRL-J or *CTRL-J* 287<NL> or *<NL>* *CTRL-N* 288CTRL-N [count] lines downward |linewise|. 289 290gk or *gk* *g<Up>* 291g<Up> [count] display lines upward. |exclusive| motion. 292 Differs from 'k' when lines wrap, and when used with 293 an operator, because it's not linewise. {not in Vi} 294 295gj or *gj* *g<Down>* 296g<Down> [count] display lines downward. |exclusive| motion. 297 Differs from 'j' when lines wrap, and when used with 298 an operator, because it's not linewise. {not in Vi} 299 300 *-* 301- <minus> [count] lines upward, on the first non-blank 302 character |linewise|. 303 304+ or *+* 305CTRL-M or *CTRL-M* *<CR>* 306<CR> [count] lines downward, on the first non-blank 307 character |linewise|. 308 309 *_* 310_ <underscore> [count] - 1 lines downward, on the first non-blank 311 character |linewise|. 312 313 *G* 314G Goto line [count], default last line, on the first 315 non-blank character |linewise|. If 'startofline' not 316 set, keep the same column. 317 318 *<C-End>* 319<C-End> Goto line [count], default last line, on the last 320 character |inclusive|. {not in Vi} 321 322<C-Home> or *gg* *<C-Home>* 323gg Goto line [count], default first line, on the first 324 non-blank character |linewise|. If 'startofline' not 325 set, keep the same column. 326 327:[range] Set the cursor on the specified line number. If 328 there are several numbers, the last one is used. 329 330 *N%* 331{count}% Go to {count} percentage in the file, on the first 332 non-blank in the line |linewise|. To compute the new 333 line number this formula is used: 334 ({count} * number-of-lines + 99) / 100 335 See also 'startofline' option. {not in Vi} 336 337:[range]go[to] [count] *:go* *:goto* *go* 338[count]go Go to {count} byte in the buffer. Default [count] is 339 one, start of the file. When giving [range], the 340 last number in it used as the byte count. End-of-line 341 characters are counted depending on the current 342 'fileformat' setting. 343 {not in Vi} 344 {not available when compiled without the 345 |+byte_offset| feature} 346 347These commands move to the specified line. They stop when reaching the first 348or the last line. The first two commands put the cursor in the same column 349(if possible) as it was after the last command that changed the column, 350except after the "$" command, then the cursor will be put on the last 351character of the line. 352 353============================================================================== 3544. Word motions *word-motions* 355 356<S-Right> or *<S-Right>* *w* 357w [count] words forward. |exclusive| motion. 358 359<C-Right> or *<C-Right>* *W* 360W [count] WORDS forward. |exclusive| motion. 361 362 *e* 363e Forward to the end of word [count] |inclusive|. 364 365 *E* 366E Forward to the end of WORD [count] |inclusive|. 367 368<S-Left> or *<S-Left>* *b* 369b [count] words backward. |exclusive| motion. 370 371<C-Left> or *<C-Left>* *B* 372B [count] WORDS backward. |exclusive| motion. 373 374 *ge* 375ge Backward to the end of word [count] |inclusive|. 376 377 *gE* 378gE Backward to the end of WORD [count] |inclusive|. 379 380These commands move over words or WORDS. 381 *word* 382A word consists of a sequence of letters, digits and underscores, or a 383sequence of other non-blank characters, separated with white space (spaces, 384tabs, <EOL>). This can be changed with the 'iskeyword' option. 385 *WORD* 386A WORD consists of a sequence of non-blank characters, separated with white 387space. An empty line is also considered to be a word and a WORD. 388 389A sequence of folded lines is counted for one word of a single character. 390"w" and "W", "e" and "E" move to the start/end of the first word or WORD after 391a range of folded lines. "b" and "B" move to the start of the first word or 392WORD before the fold. 393 394Special case: "cw" and "cW" are treated like "ce" and "cE" if the cursor is 395on a non-blank. This is because "cw" is interpreted as change-word, and a 396word does not include the following white space. {Vi: "cw" when on a blank 397followed by other blanks changes only the first blank; this is probably a 398bug, because "dw" deletes all the blanks} 399 400Another special case: When using the "w" motion in combination with an 401operator and the last word moved over is at the end of a line, the end of 402that word becomes the end of the operated text, not the first word in the 403next line. 404 405The original Vi implementation of "e" is buggy. For example, the "e" command 406will stop on the first character of a line if the previous line was empty. 407But when you use "2e" this does not happen. In Vim "ee" and "2e" are the 408same, which is more logical. However, this causes a small incompatibility 409between Vi and Vim. 410 411============================================================================== 4125. Text object motions *object-motions* 413 414 *(* 415( [count] sentences backward. |exclusive| motion. 416 417 *)* 418) [count] sentences forward. |exclusive| motion. 419 420 *{* 421{ [count] paragraphs backward. |exclusive| motion. 422 423 *}* 424} [count] paragraphs forward. |exclusive| motion. 425 426 *]]* 427]] [count] sections forward or to the next '{' in the 428 first column. When used after an operator, then also 429 stops below a '}' in the first column. |exclusive| 430 Note that |exclusive-linewise| often applies. 431 432 *][* 433][ [count] sections forward or to the next '}' in the 434 first column. |exclusive| 435 Note that |exclusive-linewise| often applies. 436 437 *[[* 438[[ [count] sections backward or to the previous '{' in 439 the first column. |exclusive| 440 Note that |exclusive-linewise| often applies. 441 442 *[]* 443[] [count] sections backward or to the previous '}' in 444 the first column. |exclusive| 445 Note that |exclusive-linewise| often applies. 446 447These commands move over three kinds of text objects. 448 449 *sentence* 450A sentence is defined as ending at a '.', '!' or '?' followed by either the 451end of a line, or by a space or tab. Any number of closing ')', ']', '"' 452and ''' characters may appear after the '.', '!' or '?' before the spaces, 453tabs or end of line. A paragraph and section boundary is also a sentence 454boundary. 455If the 'J' flag is present in 'cpoptions', at least two spaces have to 456follow the punctuation mark; <Tab>s are not recognized as white space. 457The definition of a sentence cannot be changed. 458 459 *paragraph* 460A paragraph begins after each empty line, and also at each of a set of 461paragraph macros, specified by the pairs of characters in the 'paragraphs' 462option. The default is "IPLPPPQPP LIpplpipbp", which corresponds to the 463macros ".IP", ".LP", etc. (These are nroff macros, so the dot must be in the 464first column). A section boundary is also a paragraph boundary. Note that 465this does not include a '{' or '}' in the first column. Also note that a 466blank line (only containing white space) is NOT a paragraph boundary. 467 468 *section* 469A section begins after a form-feed (<C-L>) in the first column and at each of 470a set of section macros, specified by the pairs of characters in the 471'sections' option. The default is "SHNHH HUnhsh", which defines a section to 472start at the nroff macros ".SH", ".NH", ".H", ".HU", ".nh" and ".sh". 473 474The "]" and "[" commands stop at the '{' or '}' in the first column. This is 475useful to find the start or end of a function in a C program. Note that the 476first character of the command determines the search direction and the 477second character the type of brace found. 478 479If your '{' or '}' are not in the first column, and you would like to use "[[" 480and "]]" anyway, try these mappings: > 481 :map [[ ?{<CR>w99[{ 482 :map ][ /}<CR>b99]} 483 :map ]] j0[[%/{<CR> 484 :map [] k$][%?}<CR> 485[type these literally, see |<>|] 486 487============================================================================== 4886. Text object selection *object-select* *text-objects* 489 *v_a* *v_i* 490 491This is a series of commands that can only be used while in Visual mode or 492after an operator. The commands that start with "a" select "a"n object 493including white space, the commands starting with "i" select an "inner" object 494without white space, or just the white space. Thus the "inner" commands 495always select less text than the "a" commands. 496 497These commands are {not in Vi}. 498These commands are not available when the |+textobjects| feature has been 499disabled at compile time. 500 *v_aw* *aw* 501aw "a word", select [count] words (see |word|). 502 Leading or trailing white space is included, but not 503 counted. 504 When used in Visual linewise mode "aw" switches to 505 Visual characterwise mode. 506 507 *v_iw* *iw* 508iw "inner word", select [count] words (see |word|). 509 White space between words is counted too. 510 When used in Visual linewise mode "iw" switches to 511 Visual characterwise mode. 512 513 *v_aW* *aW* 514aW "a WORD", select [count] WORDs (see |WORD|). 515 Leading or trailing white space is included, but not 516 counted. 517 When used in Visual linewise mode "aW" switches to 518 Visual characterwise mode. 519 520 *v_iW* *iW* 521iW "inner WORD", select [count] WORDs (see |WORD|). 522 White space between words is counted too. 523 When used in Visual linewise mode "iW" switches to 524 Visual characterwise mode. 525 526 *v_as* *as* 527as "a sentence", select [count] sentences (see 528 |sentence|). 529 When used in Visual mode it is made characterwise. 530 531 *v_is* *is* 532is "inner sentence", select [count] sentences (see 533 |sentence|). 534 When used in Visual mode it is made characterwise. 535 536 *v_ap* *ap* 537ap "a paragraph", select [count] paragraphs (see 538 |paragraph|). 539 Exception: a blank line (only containing white space) 540 is also a paragraph boundary. 541 When used in Visual mode it is made linewise. 542 543 *v_ip* *ip* 544ip "inner paragraph", select [count] paragraphs (see 545 |paragraph|). 546 Exception: a blank line (only containing white space) 547 is also a paragraph boundary. 548 When used in Visual mode it is made linewise. 549 550a] *v_a]* *v_a[* *a]* *a[* 551a[ "a [] block", select [count] '[' ']' blocks. This 552 goes backwards to the [count] unclosed '[', and finds 553 the matching ']'. The enclosed text is selected, 554 including the '[' and ']'. 555 When used in Visual mode it is made characterwise. 556 557i] *v_i]* *v_i[* *i]* *i[* 558i[ "inner [] block", select [count] '[' ']' blocks. This 559 goes backwards to the [count] unclosed '[', and finds 560 the matching ']'. The enclosed text is selected, 561 excluding the '[' and ']'. 562 When used in Visual mode it is made characterwise. 563 564a) *v_a)* *a)* *a(* 565a( *v_ab* *v_a(* *ab* 566ab "a block", select [count] blocks, from "[count] [(" to 567 the matching ')', including the '(' and ')' (see 568 |[(|). Does not include white space outside of the 569 parenthesis. 570 When used in Visual mode it is made characterwise. 571 572i) *v_i)* *i)* *i(* 573i( *v_ib* *v_i(* *ib* 574ib "inner block", select [count] blocks, from "[count] [(" 575 to the matching ')', excluding the '(' and ')' (see 576 |[(|). 577 When used in Visual mode it is made characterwise. 578 579a> *v_a>* *v_a<* *a>* *a<* 580a< "a <> block", select [count] <> blocks, from the 581 [count]'th unmatched '<' backwards to the matching 582 '>', including the '<' and '>'. 583 When used in Visual mode it is made characterwise. 584 585i> *v_i>* *v_i<* *i>* *i<* 586i< "inner <> block", select [count] <> blocks, from 587 the [count]'th unmatched '<' backwards to the matching 588 '>', excluding the '<' and '>'. 589 When used in Visual mode it is made characterwise. 590 591a} *v_a}* *a}* *a{* 592a{ *v_aB* *v_a{* *aB* 593aB "a Block", select [count] Blocks, from "[count] [{" to 594 the matching '}', including the '{' and '}' (see 595 |[{|). 596 When used in Visual mode it is made characterwise. 597 598i} *v_i}* *i}* *i{* 599i{ *v_iB* *v_i{* *iB* 600iB "inner Block", select [count] Blocks, from "[count] [{" 601 to the matching '}', excluding the '{' and '}' (see 602 |[{|). 603 When used in Visual mode it is made characterwise. 604 605a" *v_aquote* *aquote* 606a' *v_a'* *a'* 607a` *v_a`* *a`* 608 "a quoted string". Selects the text from the previous 609 quote until the next quote. The 'quoteescape' is used 610 to skip escaped quotes. 611 When the cursor starts on a quote, Vim will figure out 612 which quote pairs form a string by searching from the 613 start of the line. 614 Any trailing or leading white space is included. 615 When used in Visual mode it is made characterwise. 616 Repeating this object in Visual mode another string is 617 included. A count is currently not used. 618 619i" *v_iquote* *iquote* 620i' *v_i'* *i'* 621i` *v_i`* *i`* 622 Like a", a' and a`, but exclude the quotes and 623 repeating won't extend the Visual selection. 624 625When used after an operator: 626For non-block objects: 627 For the "a" commands: The operator applies to the object and the white 628 space after the object. If there is no white space after the object 629 or when the cursor was in the white space before the object, the white 630 space before the object is included. 631 For the "inner" commands: If the cursor was on the object, the 632 operator applies to the object. If the cursor was on white space, the 633 operator applies to the white space. 634For a block object: 635 The operator applies to the block where the cursor is in, or the block 636 on which the cursor is on one of the braces. For the "inner" commands 637 the surrounding braces are excluded. For the "a" commands, the braces 638 are included. 639 640When used in Visual mode: 641When start and end of the Visual area are the same (just after typing "v"): 642 One object is selected, the same as for using an operator. 643When start and end of the Visual area are not the same: 644 For non-block objects the area is extended by one object or the white 645 space up to the next object, or both for the "a" objects. The 646 direction in which this happens depends on which side of the Visual 647 area the cursor is. For the block objects the block is extended one 648 level outwards. 649 650For illustration, here is a list of delete commands, grouped from small to big 651objects. Note that for a single character and a whole line the existing vi 652movement commands are used. 653 "dl" delete character (alias: "x") |dl| 654 "diw" delete inner word *diw* 655 "daw" delete a word *daw* 656 "diW" delete inner WORD (see |WORD|) *diW* 657 "daW" delete a WORD (see |WORD|) *daW* 658 "dd" delete one line |dd| 659 "dis" delete inner sentence *dis* 660 "das" delete a sentence *das* 661 "dib" delete inner '(' ')' block *dib* 662 "dab" delete a '(' ')' block *dab* 663 "dip" delete inner paragraph *dip* 664 "dap" delete a paragraph *dap* 665 "diB" delete inner '{' '}' block *diB* 666 "daB" delete a '{' '}' block *daB* 667 668Note the difference between using a movement command and an object. The 669movement command operates from here (cursor position) to where the movement 670takes us. When using an object the whole object is operated upon, no matter 671where on the object the cursor is. For example, compare "dw" and "daw": "dw" 672deletes from the cursor position to the start of the next word, "daw" deletes 673the word under the cursor and the space after or before it. 674 675============================================================================== 6767. Marks *mark-motions* *E20* *E78* 677 678Jumping to a mark can be done in two ways: 6791. With ` (backtick): The cursor is positioned at the specified location 680 and the motion is |exclusive|. 6812. With ' (single quote): The cursor is positioned on the first non-blank 682 character in the line of the specified location and 683 the motion is linewise. 684 685 *m* *mark* *Mark* 686m{a-zA-Z} Set mark {a-zA-Z} at cursor position (does not move 687 the cursor, this is not a motion command). 688 689 *m'* *m`* 690m' or m` Set the previous context mark. This can be jumped to 691 with the "''" or "``" command (does not move the 692 cursor, this is not a motion command). 693 694 *m[* *m]* 695m[ or m] Set the |'[| or |']| mark. Useful when an operator is 696 to be simulated by multiple commands. (does not move 697 the cursor, this is not a motion command). 698 699 *:ma* *:mark* *E191* 700:[range]ma[rk] {a-zA-Z'} 701 Set mark {a-zA-Z'} at last line number in [range], 702 column 0. Default is cursor line. 703 704 *:k* 705:[range]k{a-zA-Z'} Same as :mark, but the space before the mark name can 706 be omitted. 707 708 *'* *'a* *`* *`a* 709'{a-z} `{a-z} Jump to the mark {a-z}. 710 711 *'A* *'0* *`A* *`0* 712'{A-Z0-9} `{A-Z0-9} To the mark {A-Z0-9} in the correct file (not a motion 713 command when in another file). {not in Vi} 714 715 *g'* *g'a* *g`* *g`a* 716g'{mark} g`{mark} 717 Jump to the {mark}, but don't change the jumplist when 718 jumping within the current buffer. Example: > 719 g`" 720< jumps to the last known position in a file. See 721 $VIMRUNTIME/vimrc_example.vim. 722 Also see |:keepjumps|. 723 {not in Vi} 724 725 *:marks* 726:marks List all the current marks (not a motion command). 727 The |'(|, |')|, |'{| and |'}| marks are not listed. 728 {not in Vi} 729 *E283* 730:marks {arg} List the marks that are mentioned in {arg} (not a 731 motion command). For example: > 732 :marks aB 733< to list marks 'a' and 'B'. {not in Vi} 734 735 *:delm* *:delmarks* 736:delm[arks] {marks} Delete the specified marks. Marks that can be deleted 737 include A-Z and 0-9. You cannot delete the ' mark. 738 They can be specified by giving the list of mark 739 names, or with a range, separated with a dash. Spaces 740 are ignored. Examples: > 741 :delmarks a deletes mark a 742 :delmarks a b 1 deletes marks a, b and 1 743 :delmarks Aa deletes marks A and a 744 :delmarks p-z deletes marks in the range p to z 745 :delmarks ^.[] deletes marks ^ . [ ] 746 :delmarks \" deletes mark " 747< {not in Vi} 748 749:delm[arks]! Delete all marks for the current buffer, but not marks 750 A-Z or 0-9. 751 {not in Vi} 752 753A mark is not visible in any way. It is just a position in the file that is 754remembered. Do not confuse marks with named registers, they are totally 755unrelated. 756 757'a - 'z lowercase marks, valid within one file 758'A - 'Z uppercase marks, also called file marks, valid between files 759'0 - '9 numbered marks, set from .viminfo file 760 761Lowercase marks 'a to 'z are remembered as long as the file remains in the 762buffer list. If you remove the file from the buffer list, all its marks are 763lost. If you delete a line that contains a mark, that mark is erased. 764 765To delete a mark: Create a new line, position the mark there, delete the line. 766E.g.: "o<Esc>mxdd". This does change the file though. Using "u" won't work, 767it also restores marks. 768 769Lowercase marks can be used in combination with operators. For example: "d't" 770deletes the lines from the cursor position to mark 't'. Hint: Use mark 't' for 771Top, 'b' for Bottom, etc.. Lowercase marks are restored when using undo and 772redo. 773 774Uppercase marks 'A to 'Z include the file name. {Vi: no uppercase marks} You 775can use them to jump from file to file. You can only use an uppercase mark 776with an operator if the mark is in the current file. The line number of the 777mark remains correct, even if you insert/delete lines or edit another file for 778a moment. When the 'viminfo' option is not empty, uppercase marks are kept in 779the .viminfo file. See |viminfo-file-marks|. 780 781Numbered marks '0 to '9 are quite different. They can not be set directly. 782They are only present when using a viminfo file |viminfo-file|. Basically '0 783is the location of the cursor when you last exited Vim, '1 the last but one 784time, etc. Use the "r" flag in 'viminfo' to specify files for which no 785Numbered mark should be stored. See |viminfo-file-marks|. 786 787 788 *'[* *`[* 789'[ `[ To the first character of the previously changed 790 or yanked text. {not in Vi} 791 792 *']* *`]* 793'] `] To the last character of the previously changed or 794 yanked text. {not in Vi} 795 796After executing an operator the Cursor is put at the beginning of the text 797that was operated upon. After a put command ("p" or "P") the cursor is 798sometimes placed at the first inserted line and sometimes on the last inserted 799character. The four commands above put the cursor at either end. Example: 800After yanking 10 lines you want to go to the last one of them: "10Y']". After 801inserting several lines with the "p" command you want to jump to the lowest 802inserted line: "p']". This also works for text that has been inserted. 803 804Note: After deleting text, the start and end positions are the same, except 805when using blockwise Visual mode. These commands do not work when no change 806was made yet in the current file. 807 808 *'<* *`<* 809'< `< To the first character of the last selected Visual 810 area in the current buffer. {not in Vi}. 811 812 *'>* *`>* 813'> `> To the last character of the last selected Visual 814 area in the current buffer. {not in Vi}. 815 816 *''* *``* 817'' `` To the position before latest jump, or where the last 818 "m'" or "m`" command was given. Not set when the 819 |:keepjumps| command modifier was used. 820 Also see |restore-position|. 821 822 *'quote* *`quote* 823'" `" To the cursor position when last exiting the current 824 buffer. Defaults to the first character of the first 825 line. See |last-position-jump| for how to use this 826 for each opened file. 827 Only one position is remembered per buffer, not one 828 for each window. As long as the buffer is visible in 829 a window the position won't be changed. 830 {not in Vi}. 831 832 *'^* *`^* 833'^ `^ To the position where the cursor was the last time 834 when Insert mode was stopped This is used by the |gi| 835 command. Not set when the |:keepjumps| command 836 modifier was used. {not in Vi} 837 838 *'.* *`.* 839'. `. To the position where the last change was made. The 840 position is at or near where the change started. 841 Sometimes a command is executed as several changes, 842 then the position can be near the end of what the 843 command changed. For example when inserting a word, 844 the position will be on the last character. 845 {not in Vi} 846 847 *'(* *`(* 848'( `( To the start of the current sentence, like the |(| 849 command. {not in Vi} 850 851 *')* *`)* 852') `) To the end of the current sentence, like the |)| 853 command. {not in Vi} 854 855 *'{* *`{* 856'{ `{ To the start of the current paragraph, like the |{| 857 command. {not in Vi} 858 859 *'}* *`}* 860'} `} To the end of the current paragraph, like the |}| 861 command. {not in Vi} 862 863These commands are not marks themselves, but jump to a mark: 864 865 *]'* 866]' [count] times to next line with a lowercase mark below 867 the cursor, on the first non-blank character in the 868 line. {not in Vi} 869 870 *]`* 871]` [count] times to lowercase mark after the cursor. {not 872 in Vi} 873 874 *['* 875[' [count] times to previous line with a lowercase mark 876 before the cursor, on the first non-blank character in 877 the line. {not in Vi} 878 879 *[`* 880[` [count] times to lowercase mark before the cursor. 881 {not in Vi} 882 883 884:loc[kmarks] {command} *:loc* *:lockmarks* 885 Execute {command} without adjusting marks. This is 886 useful when changing text in a way that the line count 887 will be the same when the change has completed. 888 WARNING: When the line count does change, marks below 889 the change will keep their line number, thus move to 890 another text line. 891 These items will not be adjusted for deleted/inserted 892 lines: 893 - lower case letter marks 'a - 'z 894 - upper case letter marks 'A - 'Z 895 - numbered marks '0 - '9 896 - last insert position '^ 897 - last change position '. 898 - the Visual area '< and '> 899 - line numbers in placed signs 900 - line numbers in quickfix positions 901 - positions in the |jumplist| 902 - positions in the |tagstack| 903 These items will still be adjusted: 904 - previous context mark '' 905 - the cursor position 906 - the view of a window on a buffer 907 - folds 908 - diffs 909 910:kee[pmarks] {command} *:kee* *:keepmarks* 911 Currently only has effect for the filter command 912 |:range!|: 913 - When the number of lines after filtering is equal to 914 or larger than before, all marks are kept at the 915 same line number. 916 - When the number of lines decreases, the marks in the 917 lines that disappeared are deleted. 918 In any case the marks below the filtered text have 919 their line numbers adjusted, thus stick to the text, 920 as usual. 921 When the 'R' flag is missing from 'cpoptions' this has 922 the same effect as using ":keepmarks". 923 924 *:keepj* *:keepjumps* 925:keepj[umps] {command} 926 Moving around in {command} does not change the |''|, 927 |'.| and |'^| marks, the |jumplist| or the 928 |changelist|. 929 Useful when making a change or inserting text 930 automatically and the user doesn't want to go to this 931 position. E.g., when updating a "Last change" 932 timestamp in the first line: > 933 934 :let lnum = getline(".") 935 :keepjumps normal gg 936 :call SetLastChange() 937 :keepjumps exe "normal " . lnum . "G" 938< 939 Note that ":keepjumps" must be used for every command. 940 When invoking a function the commands in that function 941 can still change the jumplist. 942 943============================================================================== 9448. Jumps *jump-motions* 945 946A "jump" is one of the following commands: "'", "`", "G", "/", "?", "n", 947"N", "%", "(", ")", "[[", "]]", "{", "}", ":s", ":tag", "L", "M", "H" and 948the commands that start editing a new file. If you make the cursor "jump" 949with one of these commands, the position of the cursor before the jump is 950remembered. You can return to that position with the "''" and "``" command, 951unless the line containing that position was changed or deleted. 952 953 *CTRL-O* 954CTRL-O Go to [count] Older cursor position in jump list 955 (not a motion command). {not in Vi} 956 {not available without the +jumplist feature} 957 958<Tab> or *CTRL-I* *<Tab>* 959CTRL-I Go to [count] newer cursor position in jump list 960 (not a motion command). 961 In a |quickfix-window| it takes you to the position of 962 the error under the cursor. 963 {not in Vi} 964 {not available without the +jumplist feature} 965 966 *:ju* *:jumps* 967:ju[mps] Print the jump list (not a motion command). {not in 968 Vi} {not available without the +jumplist feature} 969 970 *jumplist* 971Jumps are remembered in a jump list. With the CTRL-O and CTRL-I command you 972can go to cursor positions before older jumps, and back again. Thus you can 973move up and down the list. There is a separate jump list for each window. 974The maximum number of entries is fixed at 100. 975{not available without the +jumplist feature} 976 977For example, after three jump commands you have this jump list: 978 979 jump line col file/line ~ 980 3 1 0 some text ~ 981 2 70 0 another line ~ 982 1 1154 23 end. ~ 983 > ~ 984 985The "file/line" column shows the file name, or the text at the jump if it is 986in the current file (an indent is removed and a long line is truncated to fit 987in the window). 988 989You are currently in line 1167. If you then use the CTRL-O command, the 990cursor is put in line 1154. This results in: 991 992 jump line col file/line ~ 993 2 1 0 some text ~ 994 1 70 0 another line ~ 995 > 0 1154 23 end. ~ 996 1 1167 0 foo bar ~ 997 998The pointer will be set at the last used jump position. The next CTRL-O 999command will use the entry above it, the next CTRL-I command will use the 1000entry below it. If the pointer is below the last entry, this indicates that 1001you did not use a CTRL-I or CTRL-O before. In this case the CTRL-O command 1002will cause the cursor position to be added to the jump list, so you can get 1003back to the position before the CTRL-O. In this case this is line 1167. 1004 1005With more CTRL-O commands you will go to lines 70 and 1. If you use CTRL-I 1006you can go back to 1154 and 1167 again. Note that the number in the "jump" 1007column indicates the count for the CTRL-O or CTRL-I command that takes you to 1008this position. 1009 1010If you use a jump command, the current line number is inserted at the end of 1011the jump list. If the same line was already in the jump list, it is removed. 1012The result is that when repeating CTRL-O you will get back to old positions 1013only once. 1014 1015When the |:keepjumps| command modifier is used, jumps are not stored in the 1016jumplist. 1017 1018After the CTRL-O command that got you into line 1154 you could give another 1019jump command (e.g., "G"). The jump list would then become: 1020 1021 jump line col file/line ~ 1022 4 1 0 some text ~ 1023 3 70 0 another line ~ 1024 2 1167 0 foo bar ~ 1025 1 1154 23 end. ~ 1026 > ~ 1027 1028The line numbers will be adjusted for deleted and inserted lines. This fails 1029if you stop editing a file without writing, like with ":n!". 1030 1031When you split a window, the jumplist will be copied to the new window. 1032 1033If you have included the ' item in the 'viminfo' option the jumplist will be 1034stored in the viminfo file and restored when starting Vim. 1035 1036 1037CHANGE LIST JUMPS *changelist* *change-list-jumps* *E664* 1038 1039When making a change the cursor position is remembered. One position is 1040remembered for every change that can be undone, unless it is close to a 1041previous change. Two commands can be used to jump to positions of changes, 1042also those that have been undone: 1043 1044 *g;* *E662* 1045g; Go to [count] older position in change list. 1046 If [count] is larger than the number of older change 1047 positions go to the oldest change. 1048 If there is no older change an error message is given. 1049 (not a motion command) 1050 {not in Vi} 1051 {not available without the +jumplist feature} 1052 1053 *g,* *E663* 1054g, Go to [count] newer cursor position in change list. 1055 Just like "g;| but in the opposite direction. 1056 (not a motion command) 1057 {not in Vi} 1058 {not available without the +jumplist feature} 1059 1060When using a count you jump as far back or forward as possible. Thus you can 1061use "999g;" to go to the first change for which the position is still 1062remembered. The number of entries in the change list is fixed and is the same 1063as for the |jumplist|. 1064 1065When two undo-able changes are in the same line and at a column position less 1066than 'textwidth' apart only the last one is remembered. This avoids that a 1067sequence of small changes in a line, for example "xxxxx", adds many positions 1068to the change list. When 'textwidth' is zero 'wrapmargin' is used. When that 1069also isn't set a fixed number of 79 is used. Detail: For the computations 1070bytes are used, not characters, to avoid a speed penalty (this only matters 1071for multi-byte encodings). 1072 1073Note that when text has been inserted or deleted the cursor position might be 1074a bit different from the position of the change. Especially when lines have 1075been deleted. 1076 1077When the |:keepjumps| command modifier is used the position of a change is not 1078remembered. 1079 1080 *:changes* 1081:changes Print the change list. A ">" character indicates the 1082 current position. Just after a change it is below the 1083 newest entry, indicating that "g;" takes you to the 1084 newest entry position. The first column indicates the 1085 count needed to take you to this position. Example: 1086 1087 change line col text ~ 1088 3 9 8 bla bla bla 1089 2 11 57 foo is a bar 1090 1 14 54 the latest changed line 1091 > 1092 1093 The "3g;" command takes you to line 9. Then the 1094 output of ":changes is: 1095 1096 change line col text ~ 1097 > 0 9 8 bla bla bla 1098 1 11 57 foo is a bar 1099 2 14 54 the latest changed line 1100 1101 Now you can use "g," to go to line 11 and "2g," to go 1102 to line 14. 1103 1104============================================================================== 11059. Various motions *various-motions* 1106 1107 *%* 1108% Find the next item in this line after or under the 1109 cursor and jump to its match. |inclusive| motion. 1110 Items can be: 1111 ([{}]) parenthesis or (curly/square) brackets 1112 (this can be changed with the 1113 'matchpairs' option) 1114 /* */ start or end of C-style comment 1115 #if, #ifdef, #else, #elif, #endif 1116 C preprocessor conditionals (when the 1117 cursor is on the # or no ([{ 1118 following) 1119 For other items the matchit plugin can be used, see 1120 |matchit-install|. 1121 1122 When 'cpoptions' contains "M" |cpo-M| backslashes 1123 before parens and braces are ignored. Without "M" the 1124 number of backslashes matters: an even number doesn't 1125 match with an odd number. Thus in "( \) )" and "\( ( 1126 \)" the first and last parenthesis match. 1127 When the '%' character is not present in 'cpoptions' 1128 |cpo-%|, parens and braces inside double quotes are 1129 ignored, unless the number of parens/braces in a line 1130 is uneven and this line and the previous one does not 1131 end in a backslash. '(', '{', '[', ']', '}' and ')' 1132 are also ignored (parens and braces inside single 1133 quotes). Note that this works fine for C, but not for 1134 Perl, where single quotes are used for strings. 1135 No count is allowed ({count}% jumps to a line {count} 1136 percentage down the file |N%|). Using '%' on 1137 #if/#else/#endif makes the movement linewise. 1138 1139 *[(* 1140[( go to [count] previous unmatched '('. 1141 |exclusive| motion. {not in Vi} 1142 1143 *[{* 1144[{ go to [count] previous unmatched '{'. 1145 |exclusive| motion. {not in Vi} 1146 1147 *])* 1148]) go to [count] next unmatched ')'. 1149 |exclusive| motion. {not in Vi} 1150 1151 *]}* 1152]} go to [count] next unmatched '}'. 1153 |exclusive| motion. {not in Vi} 1154 1155The above four commands can be used to go to the start or end of the current 1156code block. It is like doing "%" on the '(', ')', '{' or '}' at the other 1157end of the code block, but you can do this from anywhere in the code block. 1158Very useful for C programs. Example: When standing on "case x:", "[{" will 1159bring you back to the switch statement. 1160 1161 *]m* 1162]m Go to [count] next start of a method (for Java or 1163 similar structured language). When not before the 1164 start of a method, jump to the start or end of the 1165 class. When no '{' is found after the cursor, this is 1166 an error. |exclusive| motion. {not in Vi} 1167 *]M* 1168]M Go to [count] next end of a method (for Java or 1169 similar structured language). When not before the end 1170 of a method, jump to the start or end of the class. 1171 When no '}' is found after the cursor, this is an 1172 error. |exclusive| motion. {not in Vi} 1173 *[m* 1174[m Go to [count] previous start of a method (for Java or 1175 similar structured language). When not after the 1176 start of a method, jump to the start or end of the 1177 class. When no '{' is found before the cursor this is 1178 an error. |exclusive| motion. {not in Vi} 1179 *[M* 1180[M Go to [count] previous end of a method (for Java or 1181 similar structured language). When not after the 1182 end of a method, jump to the start or end of the 1183 class. When no '}' is found before the cursor this is 1184 an error. |exclusive| motion. {not in Vi} 1185 1186The above two commands assume that the file contains a class with methods. 1187The class definition is surrounded in '{' and '}'. Each method in the class 1188is also surrounded with '{' and '}'. This applies to the Java language. The 1189file looks like this: > 1190 1191 // comment 1192 class foo { 1193 int method_one() { 1194 body_one(); 1195 } 1196 int method_two() { 1197 body_two(); 1198 } 1199 } 1200Starting with the cursor on "body_two()", using "[m" will jump to the '{' at 1201the start of "method_two()" (obviously this is much more useful when the 1202method is long!). Using "2[m" will jump to the start of "method_one()". 1203Using "3[m" will jump to the start of the class. 1204 1205 *[#* 1206[# go to [count] previous unmatched "#if" or "#else". 1207 |exclusive| motion. {not in Vi} 1208 1209 *]#* 1210]# go to [count] next unmatched "#else" or "#endif". 1211 |exclusive| motion. {not in Vi} 1212 1213These two commands work in C programs that contain #if/#else/#endif 1214constructs. It brings you to the start or end of the #if/#else/#endif where 1215the current line is included. You can then use "%" to go to the matching line. 1216 1217 *[star* *[/* 1218[* or [/ go to [count] previous start of a C comment "/*". 1219 |exclusive| motion. {not in Vi} 1220 1221 *]star* *]/* 1222]* or ]/ go to [count] next end of a C comment "*/". 1223 |exclusive| motion. {not in Vi} 1224 1225 1226 *H* 1227H To line [count] from top (Home) of window (default: 1228 first line on the window) on the first non-blank 1229 character |linewise|. See also 'startofline' option. 1230 Cursor is adjusted for 'scrolloff' option. 1231 1232 *M* 1233M To Middle line of window, on the first non-blank 1234 character |linewise|. See also 'startofline' option. 1235 1236 *L* 1237L To line [count] from bottom of window (default: Last 1238 line on the window) on the first non-blank character 1239 |linewise|. See also 'startofline' option. 1240 Cursor is adjusted for 'scrolloff' option. 1241 1242<LeftMouse> Moves to the position on the screen where the mouse 1243 click is |inclusive|. See also |<LeftMouse>|. If the 1244 position is in a status line, that window is made the 1245 active window and the cursor is not moved. {not in Vi} 1246 1247 vim:tw=78:ts=8:ft=help:norl: 1248