Mercurial > vim
annotate runtime/doc/usr_03.txt @ 2706:34f62bcce014 v7.3.123
updated for version 7.3.123
Problem: ml_get error when executing register being recorded into, deleting
lines and 'conceallevel' is set. (ZyX)
Solution: Don't redraw a line for concealing when it doesn't exist.
| author | Bram Moolenaar <bram@vim.org> |
|---|---|
| date | Tue, 15 Feb 2011 16:29:59 +0100 |
| parents | 073ff46fe397 |
| children | 6ec6b7ff2d43 |
| rev | line source |
|---|---|
|
2572
ee53a39d5896
Last changes for the 7.3 release!
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
1 *usr_03.txt* For Vim version 7.3. Last change: 2006 Jun 21 |
| 7 | 2 |
| 3 VIM USER MANUAL - by Bram Moolenaar | |
| 4 | |
| 5 Moving around | |
| 6 | |
| 7 | |
| 8 Before you can insert or delete text the cursor has to be moved to the right | |
| 9 place. Vim has a large number of commands to position the cursor. This | |
| 10 chapter shows you how to use the most important ones. You can find a list of | |
| 11 these commands below |Q_lr|. | |
| 12 | |
| 13 |03.1| Word movement | |
| 14 |03.2| Moving to the start or end of a line | |
| 15 |03.3| Moving to a character | |
| 164 | 16 |03.4| Matching a parenthesis |
| 7 | 17 |03.5| Moving to a specific line |
| 18 |03.6| Telling where you are | |
| 19 |03.7| Scrolling around | |
| 20 |03.8| Simple searches | |
| 21 |03.9| Simple search patterns | |
| 22 |03.10| Using marks | |
| 23 | |
| 24 Next chapter: |usr_04.txt| Making small changes | |
| 25 Previous chapter: |usr_02.txt| The first steps in Vim | |
| 26 Table of contents: |usr_toc.txt| | |
| 27 | |
| 28 ============================================================================== | |
| 29 *03.1* Word movement | |
| 30 | |
| 31 To move the cursor forward one word, use the "w" command. Like most Vim | |
| 32 commands, you can use a numeric prefix to move past multiple words. For | |
| 33 example, "3w" moves three words. This figure shows how it works: | |
| 34 | |
| 35 This is a line with example text ~ | |
| 36 --->-->->-----------------> | |
| 37 w w w 3w | |
| 38 | |
| 39 Notice that "w" moves to the start of the next word if it already is at the | |
| 40 start of a word. | |
| 41 The "b" command moves backward to the start of the previous word: | |
| 42 | |
| 43 This is a line with example text ~ | |
| 44 <----<--<-<---------<--- | |
| 45 b b b 2b b | |
| 46 | |
| 47 There is also the "e" command that moves to the next end of a word and "ge", | |
| 48 which moves to the previous end of a word: | |
| 49 | |
| 50 This is a line with example text ~ | |
| 51 <- <--- -----> ----> | |
| 52 ge ge e e | |
| 53 | |
| 54 If you are at the last word of a line, the "w" command will take you to the | |
| 55 first word in the next line. Thus you can use this to move through a | |
| 56 paragraph, much faster than using "l". "b" does the same in the other | |
| 57 direction. | |
| 58 | |
| 59 A word ends at a non-word character, such as a ".", "-" or ")". To change | |
| 60 what Vim considers to be a word, see the 'iskeyword' option. | |
| 61 It is also possible to move by white-space separated WORDs. This is not a | |
| 62 word in the normal sense, that's why the uppercase is used. The commands for | |
| 63 moving by WORDs are also uppercase, as this figure shows: | |
| 64 | |
| 65 ge b w e | |
| 66 <- <- ---> ---> | |
| 67 This is-a line, with special/separated/words (and some more). ~ | |
| 68 <----- <----- --------------------> -----> | |
| 69 gE B W E | |
| 70 | |
| 71 With this mix of lowercase and uppercase commands, you can quickly move | |
| 72 forward and backward through a paragraph. | |
| 73 | |
| 74 ============================================================================== | |
| 75 *03.2* Moving to the start or end of a line | |
| 76 | |
| 77 The "$" command moves the cursor to the end of a line. If your keyboard has | |
| 78 an <End> key it will do the same thing. | |
| 79 | |
| 80 The "^" command moves to the first non-blank character of the line. The "0" | |
| 81 command (zero) moves to the very first character of the line. The <Home> key | |
| 82 does the same thing. In a picture: | |
| 83 | |
| 84 ^ | |
| 85 <------------ | |
| 86 .....This is a line with example text ~ | |
| 87 <----------------- ---------------> | |
| 88 0 $ | |
| 89 | |
| 90 (the "....." indicates blanks here) | |
| 91 | |
| 92 The "$" command takes a count, like most movement commands. But moving to | |
| 93 the end of the line several times doesn't make sense. Therefore it causes the | |
| 94 editor to move to the end of another line. For example, "1$" moves you to | |
| 95 the end of the first line (the one you're on), "2$" to the end of the next | |
| 96 line, and so on. | |
| 97 The "0" command doesn't take a count argument, because the "0" would be | |
| 98 part of the count. Unexpectedly, using a count with "^" doesn't have any | |
| 99 effect. | |
| 100 | |
| 101 ============================================================================== | |
| 102 *03.3* Moving to a character | |
| 103 | |
| 104 One of the most useful movement commands is the single-character search | |
| 105 command. The command "fx" searches forward in the line for the single | |
| 106 character x. Hint: "f" stands for "Find". | |
| 107 For example, you are at the beginning of the following line. Suppose you | |
| 108 want to go to the h of human. Just execute the command "fh" and the cursor | |
| 109 will be positioned over the h: | |
| 110 | |
| 111 To err is human. To really foul up you need a computer. ~ | |
| 112 ---------->---------------> | |
| 113 fh fy | |
| 114 | |
| 115 This also shows that the command "fy" moves to the end of the word really. | |
| 116 You can specify a count; therefore, you can go to the "l" of "foul" with | |
| 117 "3fl": | |
| 118 | |
| 119 To err is human. To really foul up you need a computer. ~ | |
| 120 ---------------------> | |
| 121 3fl | |
| 122 | |
| 123 The "F" command searches to the left: | |
| 124 | |
| 125 To err is human. To really foul up you need a computer. ~ | |
| 126 <--------------------- | |
| 127 Fh | |
| 128 | |
| 129 The "tx" command works like the "fx" command, except it stops one character | |
| 130 before the searched character. Hint: "t" stands for "To". The backward | |
| 131 version of this command is "Tx". | |
| 132 | |
| 133 To err is human. To really foul up you need a computer. ~ | |
| 134 <------------ -------------> | |
| 135 Th tn | |
| 136 | |
| 137 These four commands can be repeated with ";". "," repeats in the other | |
| 138 direction. The cursor is never moved to another line. Not even when the | |
| 139 sentence continues. | |
| 140 | |
| 141 Sometimes you will start a search, only to realize that you have typed the | |
| 142 wrong command. You type "f" to search backward, for example, only to realize | |
| 143 that you really meant "F". To abort a search, press <Esc>. So "f<Esc>" is an | |
| 144 aborted forward search and doesn't do anything. Note: <Esc> cancels most | |
| 145 operations, not just searches. | |
| 146 | |
| 147 ============================================================================== | |
| 164 | 148 *03.4* Matching a parenthesis |
| 7 | 149 |
| 150 When writing a program you often end up with nested () constructs. Then the | |
| 151 "%" command is very handy: It moves to the matching paren. If the cursor is | |
| 152 on a "(" it will move to the matching ")". If it's on a ")" it will move to | |
| 153 the matching "(". | |
| 154 | |
| 155 % | |
| 156 <-----> | |
| 157 if (a == (b * c) / d) ~ | |
| 158 <----------------> | |
| 159 % | |
| 160 | |
| 161 This also works for [] and {} pairs. (This can be defined with the | |
| 162 'matchpairs' option.) | |
| 163 | |
| 164 When the cursor is not on a useful character, "%" will search forward to find | |
| 165 one. Thus if the cursor is at the start of the line of the previous example, | |
| 166 "%" will search forward and find the first "(". Then it moves to its match: | |
| 167 | |
| 168 if (a == (b * c) / d) ~ | |
| 169 ---+----------------> | |
| 170 % | |
| 171 | |
| 172 ============================================================================== | |
| 173 *03.5* Moving to a specific line | |
| 174 | |
| 175 If you are a C or C++ programmer, you are familiar with error messages such as | |
| 176 the following: | |
| 177 | |
| 178 prog.c:33: j undeclared (first use in this function) ~ | |
| 179 | |
| 180 This tells you that you might want to fix something on line 33. So how do you | |
| 181 find line 33? One way is to do "9999k" to go to the top of the file and "32j" | |
| 182 to go down thirty two lines. It is not a good way, but it works. A much | |
| 183 better way of doing things is to use the "G" command. With a count, this | |
| 184 command positions you at the given line number. For example, "33G" puts you | |
| 185 on line 33. (For a better way of going through a compiler's error list, see | |
| 186 |usr_30.txt|, for information on the :make command.) | |
| 187 With no argument, "G" positions you at the end of the file. A quick way to | |
| 188 go to the start of a file use "gg". "1G" will do the same, but is a tiny bit | |
| 189 more typing. | |
| 190 | |
| 191 | first line of a file ^ | |
| 192 | text text text text | | |
| 193 | text text text text | gg | |
| 194 7G | text text text text | | |
| 195 | text text text text | |
| 196 | text text text text | |
| 197 V text text text text | | |
| 198 text text text text | G | |
| 199 text text text text | | |
| 200 last line of a file V | |
| 201 | |
| 202 Another way to move to a line is using the "%" command with a count. For | |
| 203 example "50%" moves you to halfway the file. "90%" goes to near the end. | |
| 204 | |
| 205 The previous assumes that you want to move to a line in the file, no matter if | |
| 206 it's currently visible or not. What if you want to move to one of the lines | |
| 207 you can see? This figure shows the three commands you can use: | |
| 208 | |
| 209 +---------------------------+ | |
| 210 H --> | text sample text | | |
| 211 | sample text | | |
| 212 | text sample text | | |
| 213 | sample text | | |
| 214 M --> | text sample text | | |
| 215 | sample text | | |
| 216 | text sample text | | |
| 217 | sample text | | |
| 218 L --> | text sample text | | |
| 219 +---------------------------+ | |
| 220 | |
| 221 Hints: "H" stands for Home, "M" for Middle and "L" for Last. | |
| 222 | |
| 223 ============================================================================== | |
| 224 *03.6* Telling where you are | |
| 225 | |
| 226 To see where you are in a file, there are three ways: | |
| 227 | |
| 228 1. Use the CTRL-G command. You get a message like this (assuming the 'ruler' | |
| 229 option is off): | |
| 230 | |
| 231 "usr_03.txt" line 233 of 650 --35%-- col 45-52 ~ | |
| 232 | |
| 233 This shows the name of the file you are editing, the line number where the | |
| 234 cursor is, the total number of lines, the percentage of the way through | |
| 235 the file and the column of the cursor. | |
| 236 Sometimes you will see a split column number. For example, "col 2-9". | |
| 237 This indicates that the cursor is positioned on the second character, but | |
| 238 because character one is a tab, occupying eight spaces worth of columns, | |
| 239 the screen column is 9. | |
| 240 | |
| 241 2. Set the 'number' option. This will display a line number in front of | |
| 242 every line: > | |
| 243 | |
| 244 :set number | |
| 245 < | |
| 246 To switch this off again: > | |
| 247 | |
| 248 :set nonumber | |
| 249 < | |
| 250 Since 'number' is a boolean option, prepending "no" to its name has the | |
| 251 effect of switching it off. A boolean option has only these two values, | |
| 252 it is either on or off. | |
| 253 Vim has many options. Besides the boolean ones there are options with | |
| 254 a numerical value and string options. You will see examples of this where | |
| 255 they are used. | |
| 256 | |
| 257 3. Set the 'ruler' option. This will display the cursor position in the | |
| 258 lower right corner of the Vim window: > | |
| 259 | |
| 260 :set ruler | |
| 261 | |
| 262 Using the 'ruler' option has the advantage that it doesn't take much room, | |
| 263 thus there is more space for your text. | |
| 264 | |
| 265 ============================================================================== | |
| 266 *03.7* Scrolling around | |
| 267 | |
| 268 The CTRL-U command scrolls down half a screen of text. Think of looking | |
| 269 through a viewing window at the text and moving this window up by half the | |
| 270 height of the window. Thus the window moves up over the text, which is | |
| 271 backward in the file. Don't worry if you have a little trouble remembering | |
| 272 which end is up. Most users have the same problem. | |
| 273 The CTRL-D command moves the viewing window down half a screen in the file, | |
| 274 thus scrolls the text up half a screen. | |
| 275 | |
| 276 +----------------+ | |
| 277 | some text | | |
| 278 | some text | | |
| 279 | some text | | |
| 280 +---------------+ | some text | | |
| 281 | some text | CTRL-U --> | | | |
| 282 | | | 123456 | | |
| 283 | 123456 | +----------------+ | |
| 284 | 7890 | | |
| 285 | | +----------------+ | |
| 286 | example | CTRL-D --> | 7890 | | |
| 287 +---------------+ | | | |
| 288 | example | | |
| 289 | example | | |
| 290 | example | | |
| 291 | example | | |
| 292 +----------------+ | |
| 293 | |
| 294 To scroll one line at a time use CTRL-E (scroll up) and CTRL-Y (scroll down). | |
| 295 Think of CTRL-E to give you one line Extra. (If you use MS-Windows compatible | |
| 296 key mappings CTRL-Y will redo a change instead of scroll.) | |
| 297 | |
| 298 To scroll forward by a whole screen (except for two lines) use CTRL-F. The | |
| 299 other way is backward, CTRL-B is the command to use. Fortunately CTRL-F is | |
| 300 Forward and CTRL-B is Backward, that's easy to remember. | |
| 301 | |
| 302 A common issue is that after moving down many lines with "j" your cursor is at | |
| 303 the bottom of the screen. You would like to see the context of the line with | |
| 304 the cursor. That's done with the "zz" command. | |
| 305 | |
| 306 +------------------+ +------------------+ | |
| 307 | some text | | some text | | |
| 308 | some text | | some text | | |
| 309 | some text | | some text | | |
| 310 | some text | zz --> | line with cursor | | |
| 311 | some text | | some text | | |
| 312 | some text | | some text | | |
| 313 | line with cursor | | some text | | |
| 314 +------------------+ +------------------+ | |
| 315 | |
| 316 The "zt" command puts the cursor line at the top, "zb" at the bottom. There | |
| 317 are a few more scrolling commands, see |Q_sc|. To always keep a few lines of | |
| 318 context around the cursor, use the 'scrolloff' option. | |
| 319 | |
| 320 ============================================================================== | |
| 321 *03.8* Simple searches | |
| 322 | |
| 323 To search for a string, use the "/string" command. To find the word include, | |
| 324 for example, use the command: > | |
| 325 | |
| 326 /include | |
| 327 | |
| 328 You will notice that when you type the "/" the cursor jumps to the last line | |
| 329 of the Vim window, like with colon commands. That is where you type the word. | |
| 330 You can press the backspace key (backarrow or <BS>) to make corrections. Use | |
| 331 the <Left> and <Right> cursor keys when necessary. | |
| 332 Pressing <Enter> executes the command. | |
| 333 | |
| 334 Note: | |
| 236 | 335 The characters .*[]^%/\?~$ have special meanings. If you want to use |
| 7 | 336 them in a search you must put a \ in front of them. See below. |
| 337 | |
| 338 To find the next occurrence of the same string use the "n" command. Use this | |
| 339 to find the first #include after the cursor: > | |
| 340 | |
| 341 /#include | |
| 342 | |
| 343 And then type "n" several times. You will move to each #include in the text. | |
| 344 You can also use a count if you know which match you want. Thus "3n" finds | |
| 345 the third match. Using a count with "/" doesn't work. | |
| 346 | |
| 347 The "?" command works like "/" but searches backwards: > | |
| 348 | |
| 349 ?word | |
| 350 | |
| 351 The "N" command repeats the last search the opposite direction. Thus using | |
| 352 "N" after a "/" command search backwards, using "N" after "?" searches | |
| 353 forward. | |
| 354 | |
| 355 | |
| 356 IGNORING CASE | |
| 357 | |
| 358 Normally you have to type exactly what you want to find. If you don't care | |
| 359 about upper or lowercase in a word, set the 'ignorecase' option: > | |
| 360 | |
| 361 :set ignorecase | |
| 362 | |
| 363 If you now search for "word", it will also match "Word" and "WORD". To match | |
| 364 case again: > | |
| 365 | |
| 366 :set noignorecase | |
| 367 | |
| 368 | |
| 369 HISTORY | |
| 370 | |
| 371 Suppose you do three searches: > | |
| 372 | |
| 373 /one | |
| 374 /two | |
| 375 /three | |
| 376 | |
| 377 Now let's start searching by typing a simple "/" without pressing <Enter>. If | |
| 378 you press <Up> (the cursor key), Vim puts "/three" on the command line. | |
| 379 Pressing <Enter> at this point searches for three. If you do not press | |
| 380 <Enter>, but press <Up> instead, Vim changes the prompt to "/two". Another | |
| 381 press of <Up> moves you to "/one". | |
| 382 You can also use the <Down> cursor key to move through the history of | |
| 383 search commands in the other direction. | |
| 384 | |
| 385 If you know what a previously used pattern starts with, and you want to use it | |
| 386 again, type that character before pressing <Up>. With the previous example, | |
| 387 you can type "/o<Up>" and Vim will put "/one" on the command line. | |
| 388 | |
| 389 The commands starting with ":" also have a history. That allows you to recall | |
| 390 a previous command and execute it again. These two histories are separate. | |
| 391 | |
| 392 | |
| 393 SEARCHING FOR A WORD IN THE TEXT | |
| 394 | |
| 395 Suppose you see the word "TheLongFunctionName" in the text and you want to | |
| 396 find the next occurrence of it. You could type "/TheLongFunctionName", but | |
| 397 that's a lot of typing. And when you make a mistake Vim won't find it. | |
| 398 There is an easier way: Position the cursor on the word and use the "*" | |
| 399 command. Vim will grab the word under the cursor and use it as the search | |
| 400 string. | |
| 401 The "#" command does the same in the other direction. You can prepend a | |
| 402 count: "3*" searches for the third occurrence of the word under the cursor. | |
| 403 | |
| 404 | |
| 405 SEARCHING FOR WHOLE WORDS | |
| 406 | |
| 407 If you type "/the" it will also match "there". To only find words that end | |
| 408 in "the" use: > | |
| 409 | |
| 410 /the\> | |
| 411 | |
| 412 The "\>" item is a special marker that only matches at the end of a word. | |
| 413 Similarly "\<" only matches at the begin of a word. Thus to search for the | |
| 414 word "the" only: > | |
| 415 | |
| 416 /\<the\> | |
| 417 | |
| 418 This does not match "there" or "soothe". Notice that the "*" and "#" commands | |
| 419 use these start-of-word and end-of-word markers to only find whole words (you | |
| 420 can use "g*" and "g#" to match partial words). | |
| 421 | |
| 422 | |
| 423 HIGHLIGHTING MATCHES | |
| 424 | |
| 425 While editing a program you see a variable called "nr". You want to check | |
| 426 where it's used. You could move the cursor to "nr" and use the "*" command | |
| 427 and press "n" to go along all the matches. | |
| 428 There is another way. Type this command: > | |
| 429 | |
| 430 :set hlsearch | |
| 431 | |
| 432 If you now search for "nr", Vim will highlight all matches. That is a very | |
| 433 good way to see where the variable is used, without the need to type commands. | |
| 434 To switch this off: > | |
| 435 | |
| 436 :set nohlsearch | |
| 437 | |
| 438 Then you need to switch it on again if you want to use it for the next search | |
| 439 command. If you only want to remove the highlighting, use this command: > | |
| 440 | |
| 441 :nohlsearch | |
| 442 | |
| 443 This doesn't reset the option. Instead, it disables the highlighting. As | |
| 444 soon as you execute a search command, the highlighting will be used again. | |
| 445 Also for the "n" and "N" commands. | |
| 446 | |
| 447 | |
| 448 TUNING SEARCHES | |
| 449 | |
| 450 There are a few options that change how searching works. These are the | |
| 451 essential ones: | |
| 452 > | |
| 453 :set incsearch | |
| 454 | |
| 455 This makes Vim display the match for the string while you are still typing it. | |
| 456 Use this to check if the right match will be found. Then press <Enter> to | |
| 457 really jump to that location. Or type more to change the search string. | |
| 458 > | |
| 459 :set nowrapscan | |
| 460 | |
| 461 This stops the search at the end of the file. Or, when you are searching | |
| 462 backwards, at the start of the file. The 'wrapscan' option is on by default, | |
| 463 thus searching wraps around the end of the file. | |
| 464 | |
| 465 | |
| 466 INTERMEZZO | |
| 467 | |
| 468 If you like one of the options mentioned before, and set it each time you use | |
| 469 Vim, you can put the command in your Vim startup file. | |
| 470 Edit the file, as mentioned at |not-compatible|. Or use this command to | |
| 471 find out where it is: > | |
| 472 | |
| 473 :scriptnames | |
| 474 | |
| 475 Edit the file, for example with: > | |
| 476 | |
| 477 :edit ~/.vimrc | |
| 478 | |
| 479 Then add a line with the command to set the option, just like you typed it in | |
| 480 Vim. Example: > | |
| 481 | |
| 482 Go:set hlsearch<Esc> | |
| 483 | |
| 484 "G" moves to the end of the file. "o" starts a new line, where you type the | |
| 485 ":set" command. You end insert mode with <Esc>. Then write the file: > | |
| 486 | |
| 487 ZZ | |
| 488 | |
| 489 If you now start Vim again, the 'hlsearch' option will already be set. | |
| 490 | |
| 491 ============================================================================== | |
| 492 *03.9* Simple search patterns | |
| 493 | |
| 494 The Vim editor uses regular expressions to specify what to search for. | |
| 495 Regular expressions are an extremely powerful and compact way to specify a | |
| 496 search pattern. Unfortunately, this power comes at a price, because regular | |
| 497 expressions are a bit tricky to specify. | |
| 498 In this section we mention only a few essential ones. More about search | |
| 499 patterns and commands in chapter 27 |usr_27.txt|. You can find the full | |
| 500 explanation here: |pattern|. | |
| 501 | |
| 502 | |
| 503 BEGINNING AND END OF A LINE | |
| 504 | |
| 505 The ^ character matches the beginning of a line. On an English-US keyboard | |
| 506 you find it above the 6. The pattern "include" matches the word include | |
| 507 anywhere on the line. But the pattern "^include" matches the word include | |
| 508 only if it is at the beginning of a line. | |
| 509 The $ character matches the end of a line. Therefore, "was$" matches the | |
| 510 word was only if it is at the end of a line. | |
| 511 | |
| 512 Let's mark the places where "the" matches in this example line with "x"s: | |
| 513 | |
| 514 the solder holding one of the chips melted and the ~ | |
| 515 xxx xxx xxx | |
| 516 | |
| 517 Using "/the$" we find this match: | |
| 518 | |
| 519 the solder holding one of the chips melted and the ~ | |
| 520 xxx | |
| 521 | |
| 522 And with "/^the" we find this one: | |
| 523 the solder holding one of the chips melted and the ~ | |
| 524 xxx | |
| 525 | |
| 526 You can try searching with "/^the$", it will only match a single line | |
| 527 consisting of "the". White space does matter here, thus if a line contains a | |
| 528 space after the word, like "the ", the pattern will not match. | |
| 529 | |
| 530 | |
| 531 MATCHING ANY SINGLE CHARACTER | |
| 532 | |
| 533 The . (dot) character matches any existing character. For example, the | |
| 534 pattern "c.m" matches a string whose first character is a c, whose second | |
| 535 character is anything, and whose the third character is m. Example: | |
| 536 | |
| 537 We use a computer that became the cummin winter. ~ | |
| 538 xxx xxx xxx | |
| 539 | |
| 540 | |
| 541 MATCHING SPECIAL CHARACTERS | |
| 542 | |
| 543 If you really want to match a dot, you must avoid its special meaning by | |
| 544 putting a backslash before it. | |
| 545 If you search for "ter.", you will find these matches: | |
| 546 | |
| 547 We use a computer that became the cummin winter. ~ | |
| 548 xxxx xxxx | |
| 549 | |
| 550 Searching for "ter\." only finds the second match. | |
| 551 | |
| 552 ============================================================================== | |
| 553 *03.10* Using marks | |
| 554 | |
| 555 When you make a jump to a position with the "G" command, Vim remembers the | |
| 556 position from before this jump. This position is called a mark. To go back | |
| 557 where you came from, use this command: > | |
| 558 | |
| 559 `` | |
| 560 | |
| 561 This ` is a backtick or open single-quote character. | |
| 562 If you use the same command a second time you will jump back again. That's | |
| 563 because the ` command is a jump itself, and the position from before this jump | |
| 564 is remembered. | |
| 565 | |
| 566 Generally, every time you do a command that can move the cursor further than | |
| 567 within the same line, this is called a jump. This includes the search | |
| 568 commands "/" and "n" (it doesn't matter how far away the match is). But not | |
| 569 the character searches with "fx" and "tx" or the word movements "w" and "e". | |
| 570 Also, "j" and "k" are not considered to be a jump. Even when you use a | |
| 571 count to make them move the cursor quite a long way away. | |
| 572 | |
| 573 The `` command jumps back and forth, between two points. The CTRL-O command | |
| 574 jumps to older positions (Hint: O for older). CTRL-I then jumps back to newer | |
| 575 positions (Hint: I is just next to O on the keyboard). Consider this sequence | |
| 576 of commands: > | |
| 577 | |
| 578 33G | |
| 579 /^The | |
| 580 CTRL-O | |
| 581 | |
| 582 You first jump to line 33, then search for a line that starts with "The". | |
| 583 Then with CTRL-O you jump back to line 33. Another CTRL-O takes you back to | |
| 584 where you started. If you now use CTRL-I you jump to line 33 again. And | |
| 585 to the match for "The" with another CTRL-I. | |
| 586 | |
| 587 | |
| 588 | example text ^ | | |
| 589 33G | example text | CTRL-O | CTRL-I | |
| 590 | example text | | | |
| 591 V line 33 text ^ V | |
| 592 | example text | | | |
| 593 /^The | example text | CTRL-O | CTRL-I | |
| 594 V There you are | V | |
| 595 example text | |
| 596 | |
| 597 Note: | |
| 598 CTRL-I is the same as <Tab>. | |
| 599 | |
| 600 The ":jumps" command gives a list of positions you jumped to. The entry which | |
| 601 you used last is marked with a ">". | |
| 602 | |
| 603 | |
| 255 | 604 NAMED MARKS *bookmark* |
| 7 | 605 |
| 606 Vim enables you to place your own marks in the text. The command "ma" marks | |
| 607 the place under the cursor as mark a. You can place 26 marks (a through z) in | |
| 608 your text. You can't see them, it's just a position that Vim remembers. | |
| 1121 | 609 To go to a mark, use the command `{mark}, where {mark} is the mark letter. |
| 7 | 610 Thus to move to the a mark: |
| 611 > | |
| 612 `a | |
| 613 | |
| 614 The command 'mark (single quotation mark, or apostrophe) moves you to the | |
| 615 beginning of the line containing the mark. This differs from the `mark | |
| 616 command, which moves you to marked column. | |
| 617 | |
| 618 The marks can be very useful when working on two related parts in a file. | |
| 619 Suppose you have some text near the start of the file you need to look at, | |
| 620 while working on some text near the end of the file. | |
| 621 Move to the text at the start and place the s (start) mark there: > | |
| 622 | |
| 623 ms | |
| 624 | |
| 1121 | 625 Then move to the text you want to work on and put the e (end) mark there: > |
| 7 | 626 |
| 627 me | |
| 628 | |
| 629 Now you can move around, and when you want to look at the start of the file, | |
| 630 you use this to jump there: > | |
| 631 | |
| 632 's | |
| 633 | |
| 634 Then you can use '' to jump back to where you were, or 'e to jump to the text | |
| 635 you were working on at the end. | |
| 636 There is nothing special about using s for start and e for end, they are | |
| 637 just easy to remember. | |
| 638 | |
| 639 You can use this command to get a list of marks: > | |
| 640 | |
| 641 :marks | |
| 642 | |
| 643 You will notice a few special marks. These include: | |
| 644 | |
| 645 ' The cursor position before doing a jump | |
| 646 " The cursor position when last editing the file | |
| 647 [ Start of the last change | |
| 648 ] End of the last change | |
| 649 | |
| 650 ============================================================================== | |
| 651 | |
| 652 Next chapter: |usr_04.txt| Making small changes | |
| 653 | |
| 654 Copyright: see |manual-copyright| vim:tw=78:ts=8:ft=help:norl: |