Mercurial > vim
annotate runtime/doc/change.txt @ 34221:f2d904d44ebd v9.1.0059
patch 9.1.0059: No event triggered before creating a window
Commit: https://github.com/vim/vim/commit/1f47db75fdc8c53c5c778b26ecfa0942ac801f22
Author: Sergey Vlasov <sergey@vlasov.me>
Date: Thu Jan 25 23:07:00 2024 +0100
patch 9.1.0059: No event triggered before creating a window
Problem: No event is triggered before creating a window.
(Sergey Vlasov)
Solution: Add the WinNewPre event (Sergey Vlasov)
fixes: #10635
closes: #12761
Signed-off-by: Sergey Vlasov <sergey@vlasov.me>
Signed-off-by: Christian Brabandt <cb@256bit.org>
| author | Christian Brabandt <cb@256bit.org> |
|---|---|
| date | Thu, 25 Jan 2024 23:15:04 +0100 |
| parents | 4635e43f2c6f |
| children | 1e6f45f5ca23 |
| rev | line source |
|---|---|
|
34057
4635e43f2c6f
patch 9.1.0000: Vim 9.1 release
Christian Brabandt <cb@256bit.org>
parents:
33976
diff
changeset
|
1 *change.txt* For Vim version 9.1. Last change: 2023 Dec 19 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 This file describes commands that delete or change text. In this context, | |
| 8 changing text means deleting the text and replacing it with other text using | |
| 9 one command. You can undo all of these commands. You can repeat the non-Ex | |
| 10 commands with the "." command. | |
| 11 | |
| 12 1. Deleting text |deleting| | |
| 13 2. Delete and insert |delete-insert| | |
| 14 3. Simple changes |simple-change| *changing* | |
| 15 4. Complex changes |complex-change| | |
| 32 | 16 4.1 Filter commands |filter| |
| 17 4.2 Substitute |:substitute| | |
| 18 4.3 Search and replace |search-replace| | |
| 19 4.4 Changing tabs |change-tabs| | |
| 7 | 20 5. Copying and moving text |copy-move| |
| 21 6. Formatting text |formatting| | |
| 282 | 22 7. Sorting text |sorting| |
| 7 | 23 |
| 24 For inserting text see |insert.txt|. | |
| 25 | |
| 26 ============================================================================== | |
| 27 1. Deleting text *deleting* *E470* | |
| 28 | |
| 29 ["x]<Del> or *<Del>* *x* *dl* | |
| 30 ["x]x Delete [count] characters under and after the cursor | |
| 31 [into register x] (not |linewise|). Does the same as | |
| 32 "dl". | |
| 33 The <Del> key does not take a [count]. Instead, it | |
| 34 deletes the last character of the count. | |
| 35 See |:fixdel| if the <Del> key does not do what you | |
| 36 want. See |'whichwrap'| for deleting a line break | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
37 (join lines). |
| 7 | 38 |
| 39 *X* *dh* | |
| 40 ["x]X Delete [count] characters before the cursor [into | |
| 41 register x] (not |linewise|). Does the same as "dh". | |
| 42 Also see |'whichwrap'|. | |
| 43 | |
| 44 *d* | |
| 45 ["x]d{motion} Delete text that {motion} moves over [into register | |
| 46 x]. See below for exceptions. | |
| 47 | |
| 48 *dd* | |
| 49 ["x]dd Delete [count] lines [into register x] |linewise|. | |
| 50 | |
| 51 *D* | |
| 52 ["x]D Delete the characters under the cursor until the end | |
| 53 of the line and [count]-1 more lines [into register | |
| 54 x]; synonym for "d$". | |
| 55 (not |linewise|) | |
| 164 | 56 When the '#' flag is in 'cpoptions' the count is |
| 57 ignored. | |
| 7 | 58 |
| 59 {Visual}["x]x or *v_x* *v_d* *v_<Del>* | |
| 60 {Visual}["x]d or | |
| 61 {Visual}["x]<Del> Delete the highlighted text [into register x] (for | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
62 {Visual} see |Visual-mode|). |
| 7 | 63 |
| 64 {Visual}["x]CTRL-H or *v_CTRL-H* *v_<BS>* | |
| 65 {Visual}["x]<BS> When in Select mode: Delete the highlighted text [into | |
| 66 register x]. | |
| 67 | |
| 68 {Visual}["x]X or *v_X* *v_D* *v_b_D* | |
| 69 {Visual}["x]D Delete the highlighted lines [into register x] (for | |
| 70 {Visual} see |Visual-mode|). In Visual block mode, | |
| 71 "D" deletes the highlighted text plus all text until | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
72 the end of the line. |
| 7 | 73 |
| 5220 | 74 *:d* *:de* *:del* *:delete* *:dl* *:dp* |
| 7 | 75 :[range]d[elete] [x] Delete [range] lines (default: current line) [into |
| 76 register x]. | |
| 5220 | 77 Note these weird abbreviations: |
| 78 :dl delete and list | |
| 79 :dell idem | |
| 80 :delel idem | |
| 81 :deletl idem | |
| 82 :deletel idem | |
| 83 :dp delete and print | |
| 84 :dep idem | |
| 85 :delp idem | |
| 86 :delep idem | |
| 87 :deletp idem | |
| 88 :deletep idem | |
| 7 | 89 |
| 90 :[range]d[elete] [x] {count} | |
| 91 Delete {count} lines, starting with [range] | |
| 92 (default: current line |cmdline-ranges|) [into | |
| 93 register x]. | |
| 94 | |
| 3492 | 95 These commands delete text. You can repeat them with the `.` command |
| 96 (except `:d`) and undo them. Use Visual mode to delete blocks of text. See | |
| 7 | 97 |registers| for an explanation of registers. |
| 98 | |
| 99 An exception for the d{motion} command: If the motion is not linewise, the | |
| 100 start and end of the motion are not in the same line, and there are only | |
|
8061
abd64cf67bcf
commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents:
7876
diff
changeset
|
101 blanks before the start and there are no non-blanks after the end of the |
|
abd64cf67bcf
commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents:
7876
diff
changeset
|
102 motion, the delete becomes linewise. This means that the delete also removes |
|
abd64cf67bcf
commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents:
7876
diff
changeset
|
103 the line of blanks that you might expect to remain. Use the |o_v| operator to |
|
abd64cf67bcf
commit https://github.com/vim/vim/commit/38a55639d603823efcf2d2fdf542dbffdeb60b75
Christian Brabandt <cb@256bit.org>
parents:
7876
diff
changeset
|
104 force the motion to be characterwise. |
| 7 | 105 |
| 106 Trying to delete an empty region of text (e.g., "d0" in the first column) | |
| 107 is an error when 'cpoptions' includes the 'E' flag. | |
| 108 | |
| 109 *J* | |
| 110 J Join [count] lines, with a minimum of two lines. | |
| 111 Remove the indent and insert up to two spaces (see | |
|
8497
da01d5da2cfa
commit https://github.com/vim/vim/commit/77cdfd10382e01cc51f4ba1a9177032351843151
Christian Brabandt <cb@256bit.org>
parents:
8148
diff
changeset
|
112 below). Fails when on the last line of the buffer. |
| 13857 | 113 If [count] is too big it is reduced to the number of |
|
8497
da01d5da2cfa
commit https://github.com/vim/vim/commit/77cdfd10382e01cc51f4ba1a9177032351843151
Christian Brabandt <cb@256bit.org>
parents:
8148
diff
changeset
|
114 lines available. |
| 7 | 115 |
| 116 *v_J* | |
| 117 {Visual}J Join the highlighted lines, with a minimum of two | |
| 118 lines. Remove the indent and insert up to two spaces | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
119 (see below). |
| 7 | 120 |
| 121 *gJ* | |
| 122 gJ Join [count] lines, with a minimum of two lines. | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
123 Don't insert or remove any spaces. |
| 7 | 124 |
| 125 *v_gJ* | |
| 126 {Visual}gJ Join the highlighted lines, with a minimum of two | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
127 lines. Don't insert or remove any spaces. |
| 7 | 128 |
| 129 *:j* *:join* | |
| 168 | 130 :[range]j[oin][!] [flags] |
| 131 Join [range] lines. Same as "J", except with [!] | |
| 7 | 132 the join does not insert or delete any spaces. |
| 133 If a [range] has equal start and end values, this | |
| 134 command does nothing. The default behavior is to | |
| 135 join the current line with the line below it. | |
| 168 | 136 See |ex-flags| for [flags]. |
| 7 | 137 |
| 168 | 138 :[range]j[oin][!] {count} [flags] |
| 7 | 139 Join {count} lines, starting with [range] (default: |
| 140 current line |cmdline-ranges|). Same as "J", except | |
| 141 with [!] the join does not insert or delete any | |
| 142 spaces. | |
| 168 | 143 See |ex-flags| for [flags]. |
| 7 | 144 |
| 145 These commands delete the <EOL> between lines. This has the effect of joining | |
| 3492 | 146 multiple lines into one line. You can repeat these commands (except `:j`) and |
| 7 | 147 undo them. |
| 148 | |
| 149 These commands, except "gJ", insert one space in place of the <EOL> unless | |
| 150 there is trailing white space or the next line starts with a ')'. These | |
| 151 commands, except "gJ", delete any leading white space on the next line. If | |
| 152 the 'joinspaces' option is on, these commands insert two spaces after a '.', | |
| 153 '!' or '?' (but if 'cpoptions' includes the 'j' flag, they insert two spaces | |
| 154 only after a '.'). | |
| 155 The 'B' and 'M' flags in 'formatoptions' change the behavior for inserting | |
| 21991 | 156 spaces before and after a multibyte character |fo-table|. |
| 7 | 157 |
|
5692
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5663
diff
changeset
|
158 The '[ mark is set at the end of the first line that was joined, '] at the end |
|
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5663
diff
changeset
|
159 of the resulting line. |
|
80e5f9584b02
Update runtime files. Add Euphoria syntax files.
Bram Moolenaar <bram@vim.org>
parents:
5663
diff
changeset
|
160 |
| 7 | 161 |
| 162 ============================================================================== | |
| 163 2. Delete and insert *delete-insert* *replacing* | |
| 164 | |
| 165 *R* | |
| 166 R Enter Replace mode: Each character you type replaces | |
| 167 an existing character, starting with the character | |
| 168 under the cursor. Repeat the entered text [count]-1 | |
| 169 times. See |Replace-mode| for more details. | |
| 170 | |
| 171 *gR* | |
| 172 gR Enter Virtual Replace mode: Each character you type | |
| 173 replaces existing characters in screen space. So a | |
| 174 <Tab> may replace several characters at once. | |
| 175 Repeat the entered text [count]-1 times. See | |
| 176 |Virtual-Replace-mode| for more details. | |
| 177 | |
| 178 *c* | |
| 179 ["x]c{motion} Delete {motion} text [into register x] and start | |
| 180 insert. When 'cpoptions' includes the 'E' flag and | |
| 181 there is no text to delete (e.g., with "cTx" when the | |
| 182 cursor is just after an 'x'), an error occurs and | |
| 183 insert mode does not start (this is Vi compatible). | |
| 184 When 'cpoptions' does not include the 'E' flag, the | |
| 185 "c" command always starts insert mode, even if there | |
| 186 is no text to delete. | |
| 187 | |
| 188 *cc* | |
| 189 ["x]cc Delete [count] lines [into register x] and start | |
| 190 insert |linewise|. If 'autoindent' is on, preserve | |
| 191 the indent of the first line. | |
| 192 | |
| 193 *C* | |
| 194 ["x]C Delete from the cursor position to the end of the | |
| 195 line and [count]-1 more lines [into register x], and | |
| 196 start insert. Synonym for c$ (not |linewise|). | |
| 197 | |
| 198 *s* | |
| 199 ["x]s Delete [count] characters [into register x] and start | |
| 200 insert (s stands for Substitute). Synonym for "cl" | |
| 201 (not |linewise|). | |
| 202 | |
| 203 *S* | |
| 204 ["x]S Delete [count] lines [into register x] and start | |
| 205 insert. Synonym for "cc" |linewise|. | |
| 206 | |
| 207 {Visual}["x]c or *v_c* *v_s* | |
| 208 {Visual}["x]s Delete the highlighted text [into register x] and | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
209 start insert (for {Visual} see |Visual-mode|). |
| 7 | 210 |
| 211 *v_r* | |
| 20115 | 212 {Visual}r{char} Replace all selected characters by {char}. |
|
33299
4c975fa0a442
patch 9.0.1915: r_CTRL-C works differently in visual mode
Christian Brabandt <cb@256bit.org>
parents:
32294
diff
changeset
|
213 CTRL-C will be inserted literally. |
| 7 | 214 |
| 215 *v_C* | |
| 216 {Visual}["x]C Delete the highlighted lines [into register x] and | |
| 217 start insert. In Visual block mode it works | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
218 differently |v_b_C|. |
| 7 | 219 *v_S* |
| 220 {Visual}["x]S Delete the highlighted lines [into register x] and | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
221 start insert (for {Visual} see |Visual-mode|). |
| 7 | 222 *v_R* |
| 223 {Visual}["x]R Currently just like {Visual}["x]S. In a next version | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
224 it might work differently. |
| 7 | 225 |
| 226 Notes: | |
| 227 - You can end Insert and Replace mode with <Esc>. | |
| 228 - See the section "Insert and Replace mode" |mode-ins-repl| for the other | |
| 229 special characters in these modes. | |
| 230 - The effect of [count] takes place after Vim exits Insert or Replace mode. | |
| 231 - When the 'cpoptions' option contains '$' and the change is within one line, | |
| 232 Vim continues to show the text to be deleted and puts a '$' at the last | |
| 233 deleted character. | |
| 234 | |
| 235 See |registers| for an explanation of registers. | |
| 236 | |
| 237 Replace mode is just like Insert mode, except that every character you enter | |
| 238 deletes one character. If you reach the end of a line, Vim appends any | |
| 239 further characters (just like Insert mode). In Replace mode, the backspace | |
| 240 key restores the original text (if there was any). (See section "Insert and | |
| 241 Replace mode" |mode-ins-repl|). | |
| 242 | |
| 243 *cw* *cW* | |
| 1621 | 244 Special case: When the cursor is in a word, "cw" and "cW" do not include the |
| 245 white space after a word, they only change up to the end of the word. This is | |
| 246 because Vim interprets "cw" as change-word, and a word does not include the | |
| 247 following white space. | |
| 248 {Vi: "cw" when on a blank followed by other blanks changes only the first | |
| 249 blank; this is probably a bug, because "dw" deletes all the blanks; use the | |
| 250 'w' flag in 'cpoptions' to make it work like Vi anyway} | |
| 7 | 251 |
| 252 If you prefer "cw" to include the space after a word, use this mapping: > | |
| 253 :map cw dwi | |
| 1621 | 254 Or use "caw" (see |aw|). |
| 255 | |
| 7 | 256 *:c* *:ch* *:change* |
| 168 | 257 :{range}c[hange][!] Replace lines of text with some different text. |
| 7 | 258 Type a line containing only "." to stop replacing. |
| 259 Without {range}, this command changes only the current | |
| 260 line. | |
| 168 | 261 Adding [!] toggles 'autoindent' for the time this |
| 262 command is executed. | |
| 26779 | 263 This command is not supported in |Vim9| script, |
| 264 because it is too easily confused with a variable | |
| 265 name. | |
| 7 | 266 |
| 267 ============================================================================== | |
| 268 3. Simple changes *simple-change* | |
| 269 | |
| 270 *r* | |
| 271 r{char} Replace the character under the cursor with {char}. | |
| 272 If {char} is a <CR> or <NL>, a line break replaces the | |
| 273 character. To replace with a real <CR>, use CTRL-V | |
| 274 <CR>. CTRL-V <NL> replaces with a <Nul>. | |
|
3507
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
275 |
|
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
276 If {char} is CTRL-E or CTRL-Y the character from the |
|
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
277 line below or above is used, just like with |i_CTRL-E| |
|
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
278 and |i_CTRL-Y|. This also works with a count, thus |
|
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
279 `10r<C-E>` copies 10 characters from the line below. |
|
8201108e9cf0
More runtime file fixes for 'compatible' mode.
Bram Moolenaar <bram@vim.org>
parents:
3493
diff
changeset
|
280 |
| 7 | 281 If you give a [count], Vim replaces [count] characters |
| 282 with [count] {char}s. When {char} is a <CR> or <NL>, | |
| 283 however, Vim inserts only one <CR>: "5r<CR>" replaces | |
| 284 five characters with a single line break. | |
| 285 When {char} is a <CR> or <NL>, Vim performs | |
| 286 autoindenting. This works just like deleting the | |
| 287 characters that are replaced and then doing | |
| 288 "i<CR><Esc>". | |
| 289 {char} can be entered as a digraph |digraph-arg|. | |
| 290 |:lmap| mappings apply to {char}. The CTRL-^ command | |
| 291 in Insert mode can be used to switch this on/off | |
| 292 |i_CTRL-^|. See |utf-8-char-arg| about using | |
| 293 composing characters when 'encoding' is Unicode. | |
| 294 | |
| 295 *gr* | |
| 296 gr{char} Replace the virtual characters under the cursor with | |
| 297 {char}. This replaces in screen space, not file | |
| 298 space. See |gR| and |Virtual-Replace-mode| for more | |
| 299 details. As with |r| a count may be given. | |
| 32061 | 300 {char} can be entered like with |r|, but characters |
| 301 that have a special meaning in Insert mode, such as | |
| 302 most CTRL-keys, cannot be used. | |
| 7 | 303 |
| 304 *digraph-arg* | |
| 305 The argument for Normal mode commands like |r| and |t| is a single character. | |
| 306 When 'cpo' doesn't contain the 'D' flag, this character can also be entered | |
| 307 like |digraphs|. First type CTRL-K and then the two digraph characters. | |
| 308 {not available when compiled without the |+digraphs| feature} | |
| 309 | |
| 310 *case* | |
| 311 The following commands change the case of letters. The currently active | |
| 312 |locale| is used. See |:language|. The LC_CTYPE value matters here. | |
| 313 | |
| 314 *~* | |
| 315 ~ 'notildeop' option: Switch case of the character | |
| 316 under the cursor and move the cursor to the right. | |
| 16610 | 317 If a [count] is given, do that many characters. |
| 7 | 318 |
| 16610 | 319 ~{motion} 'tildeop' option: switch case of {motion} text. |
| 7 | 320 |
| 321 *g~* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
322 g~{motion} Switch case of {motion} text. |
| 7 | 323 |
| 324 g~g~ *g~g~* *g~~* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
325 g~~ Switch case of current line. |
| 7 | 326 |
| 327 *v_~* | |
| 328 {Visual}~ Switch case of highlighted text (for {Visual} see | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
329 |Visual-mode|). |
| 7 | 330 |
| 331 *v_U* | |
| 332 {Visual}U Make highlighted text uppercase (for {Visual} see | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
333 |Visual-mode|). |
| 7 | 334 |
| 335 *gU* *uppercase* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
336 gU{motion} Make {motion} text uppercase. |
| 7 | 337 Example: > |
| 338 :map! <C-F> <Esc>gUiw`]a | |
| 339 < This works in Insert mode: press CTRL-F to make the | |
| 340 word before the cursor uppercase. Handy to type | |
| 341 words in lowercase and then make them uppercase. | |
| 342 | |
| 343 | |
| 344 gUgU *gUgU* *gUU* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
345 gUU Make current line uppercase. |
| 7 | 346 |
| 347 *v_u* | |
| 348 {Visual}u Make highlighted text lowercase (for {Visual} see | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
349 |Visual-mode|). |
| 7 | 350 |
| 351 *gu* *lowercase* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
352 gu{motion} Make {motion} text lowercase. |
| 7 | 353 |
| 354 gugu *gugu* *guu* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
355 guu Make current line lowercase. |
| 7 | 356 |
| 357 *g?* *rot13* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
358 g?{motion} Rot13 encode {motion} text. |
| 7 | 359 |
| 360 *v_g?* | |
| 361 {Visual}g? Rot13 encode the highlighted text (for {Visual} see | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
362 |Visual-mode|). |
| 7 | 363 |
| 364 g?g? *g?g?* *g??* | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
365 g?? Rot13 encode current line. |
| 7 | 366 |
| 1621 | 367 To turn one line into title caps, make every first letter of a word |
| 368 uppercase: > | |
| 369 :s/\v<(.)(\w*)/\u\1\L\2/g | |
| 370 | |
| 7 | 371 |
| 372 Adding and subtracting ~ | |
| 373 *CTRL-A* | |
| 374 CTRL-A Add [count] to the number or alphabetic character at | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
375 or after the cursor. |
| 7 | 376 |
| 6884 | 377 *v_CTRL-A* |
| 378 {Visual}CTRL-A Add [count] to the number or alphabetic character in | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
379 the highlighted text. |
| 6884 | 380 |
| 381 *v_g_CTRL-A* | |
| 382 {Visual}g CTRL-A Add [count] to the number or alphabetic character in | |
| 383 the highlighted text. If several lines are | |
| 384 highlighted, each one will be incremented by an | |
| 385 additional [count] (so effectively creating a | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
386 [count] incrementing sequence). |
| 6884 | 387 For Example, if you have this list of numbers: |
| 388 1. ~ | |
| 389 1. ~ | |
| 390 1. ~ | |
| 391 1. ~ | |
| 392 Move to the second "1." and Visually select three | |
| 393 lines, pressing g CTRL-A results in: | |
| 394 1. ~ | |
| 395 2. ~ | |
| 396 3. ~ | |
| 397 4. ~ | |
| 398 | |
| 7 | 399 *CTRL-X* |
| 400 CTRL-X Subtract [count] from the number or alphabetic | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
401 character at or after the cursor. |
| 7 | 402 |
| 6884 | 403 *v_CTRL-X* |
| 404 {Visual}CTRL-X Subtract [count] from the number or alphabetic | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
405 character in the highlighted text. |
| 6884 | 406 |
|
8148
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
407 On MS-Windows, this is mapped to cut Visual text |
|
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
408 |dos-standard-mappings|. If you want to disable the |
|
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
409 mapping, use this: > |
|
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
410 silent! vunmap <C-X> |
|
f5da459c5698
commit https://github.com/vim/vim/commit/e0fa3742ead676a3074a10edadbc955e1a89153d
Christian Brabandt <cb@256bit.org>
parents:
8061
diff
changeset
|
411 < |
| 6884 | 412 *v_g_CTRL-X* |
| 413 {Visual}g CTRL-X Subtract [count] from the number or alphabetic | |
| 414 character in the highlighted text. If several lines | |
| 415 are highlighted, each value will be decremented by an | |
| 416 additional [count] (so effectively creating a [count] | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
417 decrementing sequence). |
| 6884 | 418 |
|
7447
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
419 The CTRL-A and CTRL-X commands can work for: |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
420 - signed and unsigned decimal numbers |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
421 - unsigned binary, octal and hexadecimal numbers |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
422 - alphabetic characters |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
423 |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
424 This depends on the 'nrformats' option: |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
425 - When 'nrformats' includes "bin", Vim assumes numbers starting with '0b' or |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
426 '0B' are binary. |
| 36 | 427 - When 'nrformats' includes "octal", Vim considers numbers starting with a '0' |
| 39 | 428 to be octal, unless the number includes a '8' or '9'. Other numbers are |
| 429 decimal and may have a preceding minus sign. | |
| 36 | 430 If the cursor is on a number, the commands apply to that number; otherwise |
| 431 Vim uses the number to the right of the cursor. | |
| 7 | 432 - When 'nrformats' includes "hex", Vim assumes numbers starting with '0x' or |
| 433 '0X' are hexadecimal. The case of the rightmost letter in the number | |
| 434 determines the case of the resulting hexadecimal number. If there is no | |
| 435 letter in the current number, Vim uses the previously detected case. | |
| 36 | 436 - When 'nrformats' includes "alpha", Vim will change the alphabetic character |
| 437 under or after the cursor. This is useful to make lists with an alphabetic | |
| 438 index. | |
| 7 | 439 |
| 6884 | 440 For decimals a leading negative sign is considered for incrementing/ |
|
7477
05cf4cc72a9f
commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents:
7447
diff
changeset
|
441 decrementing, for binary, octal and hex values, it won't be considered. To |
| 13857 | 442 ignore the sign Visually select the number before using CTRL-A or CTRL-X. |
| 6884 | 443 |
| 7 | 444 For numbers with leading zeros (including all octal and hexadecimal numbers), |
| 445 Vim preserves the number of characters in the number when possible. CTRL-A on | |
| 36 | 446 "0077" results in "0100", CTRL-X on "0x100" results in "0x0ff". |
| 39 | 447 There is one exception: When a number that starts with a zero is found not to |
| 448 be octal (it contains a '8' or '9'), but 'nrformats' does include "octal", | |
| 449 leading zeros are removed to avoid that the result may be recognized as an | |
| 450 octal number. | |
| 36 | 451 |
| 452 Note that when 'nrformats' includes "octal", decimal numbers with leading | |
| 39 | 453 zeros cause mistakes, because they can be confused with octal numbers. |
| 7 | 454 |
|
33976
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
455 Note similarly, when 'nrformats' includes both "bin" and "hex", binary numbers |
|
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
456 with a leading '0x' or '0X' can be interpreted as hexadecimal rather than |
|
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
457 binary since '0b' are valid hexadecimal digits. CTRL-A on "0x0b11" results in |
|
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
458 "0x0b12", not "0x0b100". |
|
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
459 When 'nrformats' includes "bin" and doesn't include "hex", CTRL-A on "0b11" in |
|
accd07813f71
runtime(doc): Update change.txt (#13725)
Christian Brabandt <cb@256bit.org>
parents:
33895
diff
changeset
|
460 "0x0b11" results in "0x0b100". |
|
7447
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
461 |
| 32294 | 462 When the number under the cursor is too big to fit into 32 or 64 bit |
| 463 (depending on how Vim was build), it will be rounded off to the nearest number | |
| 464 that can be represented, and the addition/subtraction is skipped. E.g. with | |
| 465 64 bit support using CTRL-X on 18446744073709551616 results in | |
| 466 18446744073709551615. Same for larger numbers, such as 18446744073709551618. | |
| 467 | |
| 7 | 468 The CTRL-A command is very useful in a macro. Example: Use the following |
| 469 steps to make a numbered list. | |
| 470 | |
| 471 1. Create the first list entry, make sure it starts with a number. | |
| 99 | 472 2. qa - start recording into register 'a' |
| 7 | 473 3. Y - yank the entry |
| 474 4. p - put a copy of the entry below the first one | |
| 475 5. CTRL-A - increment the number | |
| 476 6. q - stop recording | |
| 477 7. <count>@a - repeat the yank, put and increment <count> times | |
| 478 | |
| 479 | |
| 480 SHIFTING LINES LEFT OR RIGHT *shift-left-right* | |
| 481 | |
| 482 *<* | |
| 483 <{motion} Shift {motion} lines one 'shiftwidth' leftwards. | |
| 484 | |
|
15062
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
485 If the 'vartabstop' feature is enabled, and the |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
486 'shiftwidth' option is set to zero, the amount of |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
487 indent is calculated at the first non-blank character |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
488 in the line. |
| 7 | 489 *<<* |
| 490 << Shift [count] lines one 'shiftwidth' leftwards. | |
| 491 | |
| 492 *v_<* | |
| 493 {Visual}[count]< Shift the highlighted lines [count] 'shiftwidth' | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
494 leftwards (for {Visual} see |Visual-mode|). |
| 7 | 495 |
| 496 *>* | |
| 497 >{motion} Shift {motion} lines one 'shiftwidth' rightwards. | |
| 498 | |
|
15062
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
499 If the 'vartabstop' feature is enabled, and the |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
500 'shiftwidth' option is set to zero, the amount of |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
501 indent is calculated at the first non-blank character |
|
3a94f7918980
patch 8.1.0542: shiftwidth() does not take 'vartabstop' into account
Bram Moolenaar <Bram@vim.org>
parents:
14999
diff
changeset
|
502 in the line. |
| 7 | 503 *>>* |
| 504 >> Shift [count] lines one 'shiftwidth' rightwards. | |
| 505 | |
| 506 *v_>* | |
| 507 {Visual}[count]> Shift the highlighted lines [count] 'shiftwidth' | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
508 rightwards (for {Visual} see |Visual-mode|). |
| 7 | 509 |
| 510 *:<* | |
| 511 :[range]< Shift [range] lines one 'shiftwidth' left. Repeat '<' | |
| 512 for shifting multiple 'shiftwidth's. | |
| 513 | |
| 514 :[range]< {count} Shift {count} lines one 'shiftwidth' left, starting | |
| 515 with [range] (default current line |cmdline-ranges|). | |
| 516 Repeat '<' for shifting multiple 'shiftwidth's. | |
| 517 | |
| 518 :[range]le[ft] [indent] left align lines in [range]. Sets the indent in the | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
519 lines to [indent] (default 0). |
| 7 | 520 |
| 521 *:>* | |
|
33883
3f4883e56207
runtime(doc): remove non-existent parameter in shift-command (#13626)
Christian Brabandt <cb@256bit.org>
parents:
33776
diff
changeset
|
522 :[range]> [flags] Shift [range] lines one 'shiftwidth' right. |
| 7 | 523 Repeat '>' for shifting multiple 'shiftwidth's. |
| 168 | 524 See |ex-flags| for [flags]. |
| 7 | 525 |
| 168 | 526 :[range]> {count} [flags] |
| 527 Shift {count} lines one 'shiftwidth' right, starting | |
| 7 | 528 with [range] (default current line |cmdline-ranges|). |
| 529 Repeat '>' for shifting multiple 'shiftwidth's. | |
| 168 | 530 See |ex-flags| for [flags]. |
| 7 | 531 |
| 532 The ">" and "<" commands are handy for changing the indentation within | |
| 533 programs. Use the 'shiftwidth' option to set the size of the white space | |
| 534 which these commands insert or delete. Normally the 'shiftwidth' option is 8, | |
| 535 but you can set it to, say, 3 to make smaller indents. The shift leftwards | |
| 536 stops when there is no indent. The shift right does not affect empty lines. | |
| 537 | |
| 538 If the 'shiftround' option is on, the indent is rounded to a multiple of | |
| 539 'shiftwidth'. | |
| 540 | |
| 541 If the 'smartindent' option is on, or 'cindent' is on and 'cinkeys' contains | |
| 5466 | 542 '#' with a zero value, shift right does not affect lines starting with '#' |
| 543 (these are supposed to be C preprocessor lines that must stay in column 1). | |
| 13735 | 544 This can be changed with the 'cino' option, see |cino-#|. |
| 7 | 545 |
| 546 When the 'expandtab' option is off (this is the default) Vim uses <Tab>s as | |
| 547 much as possible to make the indent. You can use ">><<" to replace an indent | |
| 548 made out of spaces with the same indent made out of <Tab>s (and a few spaces | |
| 549 if necessary). If the 'expandtab' option is on, Vim uses only spaces. Then | |
| 550 you can use ">><<" to replace <Tab>s in the indent by spaces (or use | |
| 3492 | 551 `:retab!`). |
| 7 | 552 |
| 3492 | 553 To move a line several 'shiftwidth's, use Visual mode or the `:` commands. |
| 7 | 554 For example: > |
| 555 Vjj4> move three lines 4 indents to the right | |
| 556 :<<< move current line 3 indents to the left | |
| 557 :>> 5 move 5 lines 2 indents to the right | |
| 558 :5>> move line 5 2 indents to the right | |
| 559 | |
| 560 ============================================================================== | |
| 561 4. Complex changes *complex-change* | |
| 562 | |
| 856 | 563 4.1 Filter commands *filter* |
| 32 | 564 |
| 565 A filter is a program that accepts text at standard input, changes it in some | |
| 566 way, and sends it to standard output. You can use the commands below to send | |
| 1621 | 567 some text through a filter, so that it is replaced by the filter output. |
| 32 | 568 Examples of filters are "sort", which sorts lines alphabetically, and |
| 569 "indent", which formats C program files (you need a version of indent that | |
| 570 works like a filter; not all versions do). The 'shell' option specifies the | |
| 571 shell Vim uses to execute the filter command (See also the 'shelltype' | |
| 572 option). You can repeat filter commands with ".". Vim does not recognize a | |
| 3492 | 573 comment (starting with '"') after the `:!` command. |
| 32 | 574 |
| 575 *!* | |
| 7 | 576 !{motion}{filter} Filter {motion} text lines through the external |
| 577 program {filter}. | |
| 578 | |
| 579 *!!* | |
| 580 !!{filter} Filter [count] lines through the external program | |
| 581 {filter}. | |
| 582 | |
| 583 *v_!* | |
| 584 {Visual}!{filter} Filter the highlighted lines through the external | |
| 585 program {filter} (for {Visual} see |Visual-mode|). | |
| 586 | |
| 587 :{range}![!]{filter} [!][arg] *:range!* | |
| 588 Filter {range} lines through the external program | |
| 589 {filter}. Vim replaces the optional bangs with the | |
| 590 latest given command and appends the optional [arg]. | |
| 591 Vim saves the output of the filter command in a | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
592 temporary file and then reads the file into the buffer |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
593 |tempfile|. Vim uses the 'shellredir' option to |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
594 redirect the filter output to the temporary file. |
| 603 | 595 However, if the 'shelltemp' option is off then pipes |
| 596 are used when possible (on Unix). | |
| 7 | 597 When the 'R' flag is included in 'cpoptions' marks in |
| 598 the filtered lines are deleted, unless the | |
| 599 |:keepmarks| command is used. Example: > | |
| 600 :keepmarks '<,'>!sort | |
| 601 < When the number of lines after filtering is less than | |
| 602 before, marks in the missing lines are deleted anyway. | |
| 603 | |
| 604 *=* | |
| 605 ={motion} Filter {motion} lines through the external program | |
| 606 given with the 'equalprg' option. When the 'equalprg' | |
| 607 option is empty (this is the default), use the | |
| 2833 | 608 internal formatting function |C-indenting| and |
| 609 |'lisp'|. But when 'indentexpr' is not empty, it will | |
| 610 be used instead |indent-expression|. When Vim was | |
| 611 compiled without internal formatting then the "indent" | |
| 612 program is used as a last resort. | |
| 7 | 613 |
| 614 *==* | |
| 615 == Filter [count] lines like with ={motion}. | |
| 616 | |
| 617 *v_=* | |
| 618 {Visual}= Filter the highlighted lines like with ={motion}. | |
| 619 | |
| 620 | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
621 *tempfile* *setuid* |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
622 Vim uses temporary files for filtering, generating diffs and also for |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
623 tempname(). For Unix, the file will be in a private directory (only |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
624 accessible by the current user) to avoid security problems (e.g., a symlink |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
625 attack or other people reading your file). When Vim exits the directory and |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
626 all files in it are deleted. When Vim has the setuid bit set this may cause |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
627 problems, the temp file is owned by the setuid user but the filter command |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
628 probably runs as the original user. |
| 28517 | 629 Directory for temporary files is created in the first of these directories |
| 630 that works: | |
| 631 Unix: $TMPDIR, /tmp, current-dir, $HOME. | |
| 632 Windows: $TMP, $TEMP, c:\TMP, c:\TEMP | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
633 For MS-Windows the GetTempFileName() system function is used. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
634 For other systems the tmpnam() library function is used. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
635 |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
636 |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
637 |
| 32 | 638 4.2 Substitute *:substitute* |
| 639 *:s* *:su* | |
| 170 | 640 :[range]s[ubstitute]/{pattern}/{string}/[flags] [count] |
| 7 | 641 For each line in [range] replace a match of {pattern} |
| 642 with {string}. | |
| 643 For the {pattern} see |pattern|. | |
| 644 {string} can be a literal string, or something | |
| 645 special; see |sub-replace-special|. | |
| 646 When [range] and [count] are omitted, replace in the | |
|
10895
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10449
diff
changeset
|
647 current line only. When [count] is given, replace in |
|
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10449
diff
changeset
|
648 [count] lines, starting with the last line in [range]. |
|
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10449
diff
changeset
|
649 When [range] is omitted start in the current line. |
|
33776
9503dc55b5ed
patch 9.0.2108: [security]: overflow with count for :s command
Christian Brabandt <cb@256bit.org>
parents:
33299
diff
changeset
|
650 *E939* *E1510* |
|
9503dc55b5ed
patch 9.0.2108: [security]: overflow with count for :s command
Christian Brabandt <cb@256bit.org>
parents:
33299
diff
changeset
|
651 [count] must be a positive number (max 2147483647) |
|
9503dc55b5ed
patch 9.0.2108: [security]: overflow with count for :s command
Christian Brabandt <cb@256bit.org>
parents:
33299
diff
changeset
|
652 Also see |cmdline-ranges|. |
|
10895
c391bfbdb452
Updated runtime files.
Christian Brabandt <cb@256bit.org>
parents:
10449
diff
changeset
|
653 |
| 170 | 654 See |:s_flags| for [flags]. |
| 19404 | 655 The delimiter doesn't need to be /, see |
| 656 |pattern-delimiter|. | |
| 7 | 657 |
| 170 | 658 :[range]s[ubstitute] [flags] [count] |
| 659 :[range]&[&][flags] [count] *:&* | |
| 7 | 660 Repeat last :substitute with same search pattern and |
| 661 substitute string, but without the same flags. You | |
| 170 | 662 may add [flags], see |:s_flags|. |
| 3492 | 663 Note that after `:substitute` the '&' flag can't be |
| 7 | 664 used, it's recognized as a pattern separator. |
| 7013 | 665 The space between `:substitute` and the 'c', 'g', |
| 666 'i', 'I' and 'r' flags isn't required, but in scripts | |
| 667 it's a good idea to keep it to avoid confusion. | |
| 24103 | 668 Also see the two and three letter commands to repeat |
| 669 :substitute below |:substitute-repeat|. | |
| 7 | 670 |
| 170 | 671 :[range]~[&][flags] [count] *:~* |
| 7 | 672 Repeat last substitute with same substitute string |
| 673 but with last used search pattern. This is like | |
| 3492 | 674 `:&r`. See |:s_flags| for [flags]. |
| 7 | 675 |
| 170 | 676 *&* |
| 3492 | 677 & Synonym for `:s` (repeat last substitute). Note |
| 7 | 678 that the flags are not remembered, thus it might |
| 3492 | 679 actually work differently. You can use `:&&` to keep |
| 7 | 680 the flags. |
| 681 | |
| 170 | 682 *g&* |
| 3920 | 683 g& Synonym for `:%s//~/&` (repeat last substitute with |
| 684 last search pattern on all lines with the same flags). | |
| 4186 | 685 For example, when you first do a substitution with |
| 3920 | 686 `:s/pattern/repl/flags` and then `/search` for |
| 687 something else, `g&` will do `:%s/search/repl/flags`. | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
688 Mnemonic: global substitute. |
| 7 | 689 |
| 690 *:snomagic* *:sno* | |
| 3492 | 691 :[range]sno[magic] ... Same as `:substitute`, but always use 'nomagic'. |
| 7 | 692 |
| 693 *:smagic* *:sm* | |
| 3492 | 694 :[range]sm[agic] ... Same as `:substitute`, but always use 'magic'. |
| 7 | 695 |
| 696 *:s_flags* | |
| 697 The flags that you can use for the substitute commands: | |
| 698 | |
|
10449
222b1432814e
commit https://github.com/vim/vim/commit/5162822914372fc916a93f85848c0c82209e7cec
Christian Brabandt <cb@256bit.org>
parents:
10245
diff
changeset
|
699 *:&&* |
| 7 | 700 [&] Must be the first one: Keep the flags from the previous substitute |
| 701 command. Examples: > | |
| 702 :&& | |
| 703 :s/this/that/& | |
| 3492 | 704 < Note that `:s` and `:&` don't keep the flags. |
| 7 | 705 |
| 706 [c] Confirm each substitution. Vim highlights the matching string (with | |
| 707 |hl-IncSearch|). You can type: *:s_c* | |
| 708 'y' to substitute this match | |
| 709 'l' to substitute this match and then quit ("last") | |
| 710 'n' to skip this match | |
| 711 <Esc> to quit substituting | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
712 'a' to substitute this and all remaining matches |
|
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
713 'q' to quit substituting |
|
17809
59f8948b7590
patch 8.1.1901: the +insert_expand feature is not always available
Bram Moolenaar <Bram@vim.org>
parents:
17372
diff
changeset
|
714 CTRL-E to scroll the screen up |
|
59f8948b7590
patch 8.1.1901: the +insert_expand feature is not always available
Bram Moolenaar <Bram@vim.org>
parents:
17372
diff
changeset
|
715 CTRL-Y to scroll the screen down |
| 7 | 716 If the 'edcompatible' option is on, Vim remembers the [c] flag and |
| 717 toggles it each time you use it, but resets it when you give a new | |
| 718 search pattern. | |
| 719 | |
| 14864 | 720 *:s_e* |
| 7 | 721 [e] When the search pattern fails, do not issue an error message and, in |
| 722 particular, continue in maps as if no error occurred. This is most | |
| 723 useful to prevent the "No match" error from breaking a mapping. Vim | |
| 724 does not suppress the following error messages, however: | |
| 725 Regular expressions can't be delimited by letters | |
| 726 \ should be followed by /, ? or & | |
| 727 No previous substitute regular expression | |
| 728 Trailing characters | |
| 729 Interrupted | |
| 730 | |
| 14864 | 731 *:s_g* |
| 7 | 732 [g] Replace all occurrences in the line. Without this argument, |
| 733 replacement occurs only for the first occurrence in each line. If | |
| 734 the 'edcompatible' option is on, Vim remembers this flag and toggles | |
| 735 it each time you use it, but resets it when you give a new search | |
| 736 pattern. If the 'gdefault' option is on, this flag is on by default | |
| 737 and the [g] argument switches it off. | |
| 738 | |
| 14864 | 739 *:s_i* |
| 7 | 740 [i] Ignore case for the pattern. The 'ignorecase' and 'smartcase' options |
| 741 are not used. | |
| 742 | |
| 14864 | 743 *:s_I* |
| 7 | 744 [I] Don't ignore case for the pattern. The 'ignorecase' and 'smartcase' |
| 745 options are not used. | |
| 746 | |
| 14864 | 747 *:s_n* |
| 170 | 748 [n] Report the number of matches, do not actually substitute. The [c] |
| 749 flag is ignored. The matches are reported as if 'report' is zero. | |
| 750 Useful to |count-items|. | |
| 3750 | 751 If \= |sub-replace-expression| is used, the expression will be |
| 752 evaluated in the |sandbox| at every match. | |
| 170 | 753 |
| 14864 | 754 [p] Print the line containing the last substitute. *:s_p* |
| 755 | |
| 756 [#] Like [p] and prepend the line number. *:s_#* | |
| 168 | 757 |
| 14864 | 758 [l] Like [p] but print the text like |:list|. *:s_l* |
| 168 | 759 |
| 14864 | 760 *:s_r* |
| 3492 | 761 [r] Only useful in combination with `:&` or `:s` without arguments. `:&r` |
| 762 works the same way as `:~`: When the search pattern is empty, use the | |
| 7 | 763 previously used search pattern instead of the search pattern from the |
| 3492 | 764 last substitute or `:global`. If the last command that did a search |
| 765 was a substitute or `:global`, there is no effect. If the last | |
| 7 | 766 command was a search command such as "/", use the pattern from that |
| 767 command. | |
| 3492 | 768 For `:s` with an argument this already happens: > |
| 7 | 769 :s/blue/red/ |
| 770 /green | |
| 771 :s//red/ or :~ or :&r | |
| 772 < The last commands will replace "green" with "red". > | |
| 773 :s/blue/red/ | |
| 774 /green | |
| 775 :& | |
| 776 < The last command will replace "blue" with "red". | |
| 777 | |
| 778 Note that there is no flag to change the "magicness" of the pattern. A | |
| 1621 | 779 different command is used instead, or you can use |/\v| and friends. The |
| 780 reason is that the flags can only be found by skipping the pattern, and in | |
| 781 order to skip the pattern the "magicness" must be known. Catch 22! | |
| 7 | 782 |
| 783 If the {pattern} for the substitute command is empty, the command uses the | |
| 3492 | 784 pattern from the last substitute or `:global` command. If there is none, but |
| 2725 | 785 there is a previous search pattern, that one is used. With the [r] flag, the |
| 3492 | 786 command uses the pattern from the last substitute, `:global`, or search |
| 7 | 787 command. |
| 788 | |
| 1121 | 789 If the {string} is omitted the substitute is done as if it's empty. Thus the |
| 790 matched pattern is deleted. The separator after {pattern} can also be left | |
| 791 out then. Example: > | |
| 792 :%s/TESTING | |
| 793 This deletes "TESTING" from all lines, but only one per line. | |
| 28010 | 794 *E1270* |
| 795 For compatibility with Vi these two exceptions are allowed in legacy script: | |
| 7 | 796 "\/{string}/" and "\?{string}?" do the same as "//{string}/r". |
| 797 "\&{string}&" does the same as "//{string}/". | |
| 27537 | 798 *pattern-delimiter* *E146* *E1241* *E1242* |
| 25056 | 799 Instead of the '/' which surrounds the pattern and replacement string, you can |
| 800 use another single-byte character. This is useful if you want to include a | |
| 801 '/' in the search pattern or replacement string. Example: > | |
| 7 | 802 :s+/+//+ |
| 803 | |
| 25056 | 804 You can use most characters, but not an alphanumeric character, '\', '"' or |
| 805 '|'. In Vim9 script you should not use '#' because it may be recognized as | |
| 806 the start of a comment. | |
| 807 | |
| 1621 | 808 For the definition of a pattern, see |pattern|. In Visual block mode, use |
| 809 |/\%V| in the pattern to have the substitute work in the block only. | |
| 810 Otherwise it works on whole lines anyway. | |
| 7 | 811 |
| 812 *sub-replace-special* *:s\=* | |
| 813 When the {string} starts with "\=" it is evaluated as an expression, see | |
| 2908 | 814 |sub-replace-expression|. You can use that for complex replacement or special |
| 815 characters. | |
| 816 | |
| 29533 | 817 The substitution is limited in recursion to 4 levels. *E1290* |
| 818 | |
| 452 | 819 Otherwise these characters in {string} have a special meaning: |
| 168 | 820 *:s%* |
| 843 | 821 When {string} is equal to "%" and '/' is included with the 'cpoptions' option, |
| 2908 | 822 then the {string} of the previous substitute command is used, see |cpo-/| |
| 7 | 823 |
| 824 magic nomagic action ~ | |
| 825 & \& replaced with the whole matched pattern *s/\&* | |
| 826 \& & replaced with & | |
| 827 \0 replaced with the whole matched pattern *\0* *s/\0* | |
| 828 \1 replaced with the matched pattern in the first | |
| 829 pair of () *s/\1* | |
| 26 | 830 \2 replaced with the matched pattern in the second |
| 7 | 831 pair of () *s/\2* |
| 832 .. .. *s/\3* | |
| 833 \9 replaced with the matched pattern in the ninth | |
| 834 pair of () *s/\9* | |
| 835 ~ \~ replaced with the {string} of the previous | |
| 836 substitute *s~* | |
| 837 \~ ~ replaced with ~ *s/\~* | |
| 838 \u next character made uppercase *s/\u* | |
| 839 \U following characters made uppercase, until \E *s/\U* | |
| 840 \l next character made lowercase *s/\l* | |
| 841 \L following characters made lowercase, until \E *s/\L* | |
| 842 \e end of \u, \U, \l and \L (NOTE: not <Esc>!) *s/\e* | |
| 843 \E end of \u, \U, \l and \L *s/\E* | |
| 844 <CR> split line in two at this point | |
| 845 (Type the <CR> as CTRL-V <Enter>) *s<CR>* | |
| 846 \r idem *s/\r* | |
| 847 \<CR> insert a carriage-return (CTRL-M) | |
| 848 (Type the <CR> as CTRL-V <Enter>) *s/\<CR>* | |
| 849 \n insert a <NL> (<NUL> in the file) | |
| 850 (does NOT break the line) *s/\n* | |
| 851 \b insert a <BS> *s/\b* | |
| 852 \t insert a <Tab> *s/\t* | |
| 853 \\ insert a single backslash *s/\\* | |
| 854 \x where x is any character not mentioned above: | |
| 855 Reserved for future expansion | |
| 856 | |
| 2908 | 857 The special meaning is also used inside the third argument {sub} of |
| 858 the |substitute()| function with the following exceptions: | |
| 859 - A % inserts a percent literally without regard to 'cpoptions'. | |
| 860 - magic is always set without regard to 'magic'. | |
| 861 - A ~ inserts a tilde literally. | |
| 862 - <CR> and \r inserts a carriage-return (CTRL-M). | |
| 14999 | 863 - \<CR> does not have a special meaning. It's just one of \x. |
| 2908 | 864 |
| 7 | 865 Examples: > |
| 866 :s/a\|b/xxx\0xxx/g modifies "a b" to "xxxaxxx xxxbxxx" | |
| 867 :s/\([abc]\)\([efg]\)/\2\1/g modifies "af fa bg" to "fa fa gb" | |
| 868 :s/abcde/abc^Mde/ modifies "abcde" to "abc", "de" (two lines) | |
| 869 :s/$/\^M/ modifies "abcde" to "abcde^M" | |
| 772 | 870 :s/\w\+/\u\0/g modifies "bla bla" to "Bla Bla" |
|
8951
0bdeaf7092bc
commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents:
8497
diff
changeset
|
871 :s/\w\+/\L\u\0/g modifies "BLA bla" to "Bla Bla" |
| 4264 | 872 |
| 873 Note: "\L\u" can be used to capitalize the first letter of a word. This is | |
| 874 not compatible with Vi and older versions of Vim, where the "\u" would cancel | |
| 875 out the "\L". Same for "\U\l". | |
| 7 | 876 |
| 877 Note: In previous versions CTRL-V was handled in a special way. Since this is | |
| 878 not Vi compatible, this was removed. Use a backslash instead. | |
| 879 | |
| 880 command text result ~ | |
| 881 :s/aa/a^Ma/ aa a<line-break>a | |
| 882 :s/aa/a\^Ma/ aa a^Ma | |
| 883 :s/aa/a\\^Ma/ aa a\<line-break>a | |
| 884 | |
| 885 (you need to type CTRL-V <CR> to get a ^M here) | |
| 886 | |
| 887 The numbering of "\1", "\2" etc. is done based on which "\(" comes first in | |
| 888 the pattern (going left to right). When a parentheses group matches several | |
| 889 times, the last one will be used for "\1", "\2", etc. Example: > | |
| 890 :s/\(\(a[a-d] \)*\)/\2/ modifies "aa ab x" to "ab x" | |
|
10186
a5ef9968638c
commit https://github.com/vim/vim/commit/7e1479b86c590a66b63a274c079b7f18907d45a4
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
891 The "\2" is for "\(a[a-d] \)". At first it matches "aa ", secondly "ab ". |
| 7 | 892 |
| 893 When using parentheses in combination with '|', like in \([ab]\)\|\([cd]\), | |
| 894 either the first or second pattern in parentheses did not match, so either | |
| 895 \1 or \2 is empty. Example: > | |
| 896 :s/\([ab]\)\|\([cd]\)/\1x/g modifies "a b c d" to "ax bx x x" | |
| 897 < | |
| 898 | |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
899 *:sc* *:sce* *:scg* *:sci* *:scI* *:scl* *:scp* *:sg* *:sgc* |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
900 *:sge* *:sgi* *:sgI* *:sgl* *:sgn* *:sgp* *:sgr* *:sI* *:si* |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
901 *:sic* *:sIc* *:sie* *:sIe* *:sIg* *:sIl* *:sin* *:sIn* *:sIp* |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
902 *:sip* *:sIr* *:sir* *:sr* *:src* *:srg* *:sri* *:srI* *:srl* |
| 24103 | 903 *:srn* *:srp* *:substitute-repeat* |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
904 2-letter and 3-letter :substitute commands ~ |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
905 |
| 24103 | 906 These commands repeat the previous `:substitute` command with the given flags. |
| 907 The first letter is always "s", followed by one or two of the possible flag | |
| 908 characters. For example `:sce` works like `:s///ce`. The table lists the | |
| 909 possible combinations, not all flags are possible, because the command is | |
| 910 short for another command. | |
| 911 | |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
912 List of :substitute commands |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
913 | c e g i I n p l r |
| 24103 | 914 | c :sc :sce :scg :sci :scI :scn :scp :scl |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
915 | e |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
916 | g :sgc :sge :sg :sgi :sgI :sgn :sgp :sgl :sgr |
| 24103 | 917 | i :sic :sie :si :siI :sin :sip :sir |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
918 | I :sIc :sIe :sIg :sIi :sI :sIn :sIp :sIl :sIr |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
919 | n |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
920 | p |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
921 | l |
| 24103 | 922 | r :src :srg :sri :srI :srn :srp :srl :sr |
|
7183
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
923 |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
924 Exceptions: |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
925 :scr is `:scriptnames` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
926 :se is `:set` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
927 :sig is `:sign` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
928 :sil is `:silent` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
929 :sn is `:snext` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
930 :sp is `:split` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
931 :sl is `:sleep` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
932 :sre is `:srewind` |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
933 |
|
ffad29dc7eee
commit https://github.com/vim/vim/commit/a0f849ee40cbea3c889345256786b640b0becca2
Christian Brabandt <cb@256bit.org>
parents:
7100
diff
changeset
|
934 |
| 7 | 935 Substitute with an expression *sub-replace-expression* |
|
5663
1dea14d4c738
Update runtime files. Add support for systemverilog.
Bram Moolenaar <bram@vim.org>
parents:
5618
diff
changeset
|
936 *sub-replace-\=* *s/\=* |
| 270 | 937 When the substitute string starts with "\=" the remainder is interpreted as an |
|
10245
d76ccdacb41e
commit https://github.com/vim/vim/commit/6100d02aab7c8294b581cb299250eea164b50e9d
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
938 expression. |
| 7 | 939 |
| 940 The special meaning for characters as mentioned at |sub-replace-special| does | |
| 2908 | 941 not apply except for "<CR>". A <NL> character is used as a line break, you |
| 942 can get one with a double-quote string: "\n". Prepend a backslash to get a | |
| 943 real <NL> character (which will be a NUL in the file). | |
| 7 | 944 |
| 2908 | 945 The "\=" notation can also be used inside the third argument {sub} of |
| 946 |substitute()| function. In this case, the special meaning for characters as | |
| 947 mentioned at |sub-replace-special| does not apply at all. Especially, <CR> and | |
| 948 <NL> are interpreted not as a line break but as a carriage-return and a | |
| 949 new-line respectively. | |
| 7 | 950 |
| 714 | 951 When the result is a |List| then the items are joined with separating line |
| 952 breaks. Thus each item becomes a line, except that they can contain line | |
| 953 breaks themselves. | |
| 954 | |
| 15194 | 955 The |submatch()| function can be used to obtain matched text. The whole |
| 956 matched text can be accessed with "submatch(0)". The text matched with the | |
| 957 first pair of () with "submatch(1)". Likewise for further sub-matches in (). | |
| 7 | 958 |
| 959 Be careful: The separation character must not appear in the expression! | |
| 960 Consider using a character like "@" or ":". There is no problem if the result | |
| 961 of the expression contains the separation character. | |
| 962 | |
| 452 | 963 Examples: > |
| 27903 | 964 :s@\n@\="\r" .. expand("$HOME") .. "\r"@ |
| 452 | 965 This replaces an end-of-line with a new line containing the value of $HOME. > |
| 966 | |
| 967 s/E/\="\<Char-0x20ac>"/g | |
| 1668 | 968 This replaces each 'E' character with a euro sign. Read more in |<Char->|. |
| 7 | 969 |
| 970 | |
| 32 | 971 4.3 Search and replace *search-replace* |
| 972 | |
| 973 *:pro* *:promptfind* | |
| 7 | 974 :promptf[ind] [string] |
| 975 Put up a Search dialog. When [string] is given, it is | |
| 976 used as the initial search string. | |
| 977 {only for Win32, Motif and GTK GUI} | |
| 978 | |
| 979 *:promptr* *:promptrepl* | |
| 980 :promptr[epl] [string] | |
| 981 Put up a Search/Replace dialog. When [string] is | |
| 982 given, it is used as the initial search string. | |
| 983 {only for Win32, Motif and GTK GUI} | |
| 984 | |
| 32 | 985 |
| 986 4.4 Changing tabs *change-tabs* | |
| 3492 | 987 *:ret* *:retab* *:retab!* |
| 7 | 988 :[range]ret[ab][!] [new_tabstop] |
| 989 Replace all sequences of white-space containing a | |
| 990 <Tab> with new strings of white-space using the new | |
| 991 tabstop value given. If you do not specify a new | |
| 992 tabstop size or it is zero, Vim uses the current value | |
| 993 of 'tabstop'. | |
| 994 The current value of 'tabstop' is always used to | |
| 995 compute the width of existing tabs. | |
| 996 With !, Vim also replaces strings of only normal | |
| 997 spaces with tabs where appropriate. | |
| 998 With 'expandtab' on, Vim replaces all tabs with the | |
| 999 appropriate number of spaces. | |
| 1000 This command sets 'tabstop' to the new value given, | |
| 1001 and if performed on the whole file, which is default, | |
| 1002 should not make any visible change. | |
| 1003 Careful: This command modifies any <Tab> characters | |
| 1004 inside of strings in a C program. Use "\t" to avoid | |
| 1005 this (that's a good habit anyway). | |
| 3492 | 1006 `:retab!` may also change a sequence of spaces by |
| 7 | 1007 <Tab> characters, which can mess up a printf(). |
|
14175
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
1008 If the |+vartabs| feature is enabled then a list of |
|
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
1009 tab widths separated by commas may be used in place of |
|
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
1010 a single tabstop. Each value in the list represents |
|
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
1011 the width of one tabstop, except the final value which |
|
2ad722003b36
patch 8.1.0105: all tab stops are the same
Christian Brabandt <cb@256bit.org>
parents:
13963
diff
changeset
|
1012 applies to all following tabstops. |
| 7 | 1013 |
| 1014 *retab-example* | |
| 1015 Example for using autocommands and ":retab" to edit a file which is stored | |
| 1016 with tabstops at 8 but edited with tabstops set at 4. Warning: white space | |
| 1017 inside of strings can change! Also see 'softtabstop' option. > | |
| 1018 | |
| 1019 :auto BufReadPost *.xx retab! 4 | |
| 1020 :auto BufWritePre *.xx retab! 8 | |
| 1021 :auto BufWritePost *.xx retab! 4 | |
| 1022 :auto BufNewFile *.xx set ts=4 | |
| 1023 | |
| 1024 ============================================================================== | |
| 1025 5. Copying and moving text *copy-move* | |
| 1026 | |
| 1027 *quote* | |
| 20241 | 1028 "{register} Use {register} for next delete, yank or put. Use |
| 1029 an uppercase character to append with delete and yank. | |
| 1030 Registers ".", "%", "#" and ":" only work with put. | |
| 7 | 1031 |
| 1032 *:reg* *:registers* | |
|
18436
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1033 :reg[isters] Display the type and contents of all numbered and |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1034 named registers. If a register is written to for |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1035 |:redir| it will not be listed. |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1036 Type can be one of: |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1037 "c" for |characterwise| text |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1038 "l" for |linewise| text |
|
6ec1bfb4690b
patch 8.1.2212: cannot see the selection type in :reg output
Bram Moolenaar <Bram@vim.org>
parents:
18343
diff
changeset
|
1039 "b" for |blockwise-visual| text |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1040 |
| 7 | 1041 |
| 1042 :reg[isters] {arg} Display the contents of the numbered and named | |
| 1043 registers that are mentioned in {arg}. For example: > | |
|
7477
05cf4cc72a9f
commit https://github.com/vim/vim/commit/fa7353428f705f7a13465a1943dddeede4083023
Christian Brabandt <cb@256bit.org>
parents:
7447
diff
changeset
|
1044 :reg 1a |
| 7 | 1045 < to display registers '1' and 'a'. Spaces are allowed |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1046 in {arg}. |
| 7 | 1047 |
| 32061 | 1048 *:di* *:dis* *:display* |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1049 :di[splay] [arg] Same as :registers. |
| 7 | 1050 |
| 1051 *y* *yank* | |
| 1052 ["x]y{motion} Yank {motion} text [into register x]. When no | |
| 1053 characters are to be yanked (e.g., "y0" in column 1), | |
| 1054 this is an error when 'cpoptions' includes the 'E' | |
| 1055 flag. | |
| 1056 | |
| 1057 *yy* | |
| 1058 ["x]yy Yank [count] lines [into register x] |linewise|. | |
| 1059 | |
| 1060 *Y* | |
| 1061 ["x]Y yank [count] lines [into register x] (synonym for | |
| 1062 yy, |linewise|). If you like "Y" to work from the | |
| 1063 cursor to the end of line (which is more logical, | |
| 1064 but not Vi-compatible) use ":map Y y$". | |
| 1065 | |
|
24866
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1066 *zy* |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1067 ["x]zy{motion} Yank {motion} text [into register x]. Only differs |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1068 from `y` when selecting a block of text, see |v_zy|. |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1069 |
| 7 | 1070 *v_y* |
| 1071 {Visual}["x]y Yank the highlighted text [into register x] (for | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1072 {Visual} see |Visual-mode|). |
| 7 | 1073 |
| 1074 *v_Y* | |
| 1075 {Visual}["x]Y Yank the highlighted lines [into register x] (for | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1076 {Visual} see |Visual-mode|). |
| 7 | 1077 |
|
24866
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1078 *v_zy* |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1079 {Visual}["x]zy Yank the highlighted text [into register x]. Trailing |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1080 whitespace at the end of each line of a selected block |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1081 won't be yanked. Especially useful in combination |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1082 with `zp`. (for {Visual} see |Visual-mode|) |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1083 |
| 2791 | 1084 *:y* *:yank* *E850* |
| 1085 :[range]y[ank] [x] Yank [range] lines [into register x]. Yanking to the | |
| 2826 | 1086 "* or "+ registers is possible only when the |
| 1087 |+clipboard| feature is included. | |
| 7 | 1088 |
| 1089 :[range]y[ank] [x] {count} | |
| 1090 Yank {count} lines, starting with last line number | |
| 1091 in [range] (default: current line |cmdline-ranges|), | |
| 1092 [into register x]. | |
| 1093 | |
| 27537 | 1094 *p* *put* *E353* *E1240* |
| 7 | 1095 ["x]p Put the text [from register x] after the cursor |
| 16610 | 1096 [count] times. |
| 7 | 1097 |
| 1098 *P* | |
| 1099 ["x]P Put the text [from register x] before the cursor | |
| 16610 | 1100 [count] times. |
| 7 | 1101 |
| 1102 *<MiddleMouse>* | |
| 1103 ["x]<MiddleMouse> Put the text from a register before the cursor [count] | |
| 1104 times. Uses the "* register, unless another is | |
| 856 | 1105 specified. |
| 36 | 1106 Leaves the cursor at the end of the new text. |
| 1107 Using the mouse only works when 'mouse' contains 'n' | |
| 1108 or 'a'. | |
| 7 | 1109 If you have a scrollwheel and often accidentally paste |
| 1110 text, you can use these mappings to disable the | |
| 1111 pasting with the middle mouse button: > | |
| 1112 :map <MiddleMouse> <Nop> | |
| 1113 :imap <MiddleMouse> <Nop> | |
| 1114 < You might want to disable the multi-click versions | |
| 1115 too, see |double-click|. | |
| 1116 | |
| 1117 *gp* | |
| 1118 ["x]gp Just like "p", but leave the cursor just after the new | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1119 text. |
| 7 | 1120 |
| 1121 *gP* | |
| 1122 ["x]gP Just like "P", but leave the cursor just after the new | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1123 text. |
| 7 | 1124 |
| 1125 *:pu* *:put* | |
| 1126 :[line]pu[t] [x] Put the text [from register x] after [line] (default | |
| 1127 current line). This always works |linewise|, thus | |
| 1128 this command can be used to put a yanked block as new | |
| 1129 lines. | |
| 3492 | 1130 If no register is specified, it depends on the 'cb' |
| 1131 option: If 'cb' contains "unnamedplus", paste from the | |
| 1132 + register |quoteplus|. Otherwise, if 'cb' contains | |
|
3493
1be42b88900e
Updated runtime files, include fixes for line continuation.
Bram Moolenaar <bram@vim.org>
parents:
3492
diff
changeset
|
1133 "unnamed", paste from the * register |quotestar|. |
| 3492 | 1134 Otherwise, paste from the unnamed register |
| 1135 |quote_quote|. | |
| 7 | 1136 The register can also be '=' followed by an optional |
| 1137 expression. The expression continues until the end of | |
| 1138 the command. You need to escape the '|' and '"' | |
| 1139 characters to prevent them from terminating the | |
| 1140 command. Example: > | |
| 27903 | 1141 :put ='path' .. \",/test\" |
| 7 | 1142 < If there is no expression after '=', Vim uses the |
| 1143 previous expression. You can see it with ":dis =". | |
| 1144 | |
| 1145 :[line]pu[t]! [x] Put the text [from register x] before [line] (default | |
| 1146 current line). | |
| 1147 | |
| 1148 ["x]]p or *]p* *]<MiddleMouse>* | |
| 1149 ["x]]<MiddleMouse> Like "p", but adjust the indent to the current line. | |
| 1150 Using the mouse only works when 'mouse' contains 'n' | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1151 or 'a'. |
| 7 | 1152 |
| 1153 ["x][P or *[P* | |
| 1154 ["x]]P or *]P* | |
| 1155 ["x][p or *[p* *[<MiddleMouse>* | |
| 1156 ["x][<MiddleMouse> Like "P", but adjust the indent to the current line. | |
| 1157 Using the mouse only works when 'mouse' contains 'n' | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1158 or 'a'. |
| 7 | 1159 |
|
24752
1ce39e257f1b
patch 8.2.2914: cannot paste a block without adding padding
Bram Moolenaar <Bram@vim.org>
parents:
24103
diff
changeset
|
1160 ["x]zp or *zp* *zP* |
|
1ce39e257f1b
patch 8.2.2914: cannot paste a block without adding padding
Bram Moolenaar <Bram@vim.org>
parents:
24103
diff
changeset
|
1161 ["x]zP Like "p" and "P", except without adding trailing spaces |
|
1ce39e257f1b
patch 8.2.2914: cannot paste a block without adding padding
Bram Moolenaar <Bram@vim.org>
parents:
24103
diff
changeset
|
1162 when pasting a block. Thus the inserted text will not |
|
24866
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1163 always be a rectangle. Especially useful in |
|
f1121eb17e14
patch 8.2.2971: cannot yank a block without trailing spaces
Bram Moolenaar <Bram@vim.org>
parents:
24752
diff
changeset
|
1164 combination with |v_zy|. |
|
24752
1ce39e257f1b
patch 8.2.2914: cannot paste a block without adding padding
Bram Moolenaar <Bram@vim.org>
parents:
24103
diff
changeset
|
1165 |
| 7 | 1166 You can use these commands to copy text from one place to another. Do this |
| 1167 by first getting the text into a register with a yank, delete or change | |
| 1168 command, then inserting the register contents with a put command. You can | |
| 1169 also use these commands to move text from one file to another, because Vim | |
| 1170 preserves all registers when changing buffers (the CTRL-^ command is a quick | |
| 1171 way to toggle between two files). | |
| 1172 | |
| 1173 *linewise-register* *characterwise-register* | |
| 1174 You can repeat the put commands with "." (except for :put) and undo them. If | |
| 1175 the command that was used to get the text into the register was |linewise|, | |
| 1176 Vim inserts the text below ("p") or above ("P") the line where the cursor is. | |
| 1177 Otherwise Vim inserts the text after ("p") or before ("P") the cursor. With | |
| 1178 the ":put" command, Vim always inserts the text in the next line. You can | |
| 1179 exchange two characters with the command sequence "xp". You can exchange two | |
| 1180 lines with the command sequence "ddp". You can exchange two words with the | |
| 1181 command sequence "deep" (start with the cursor in the blank space before the | |
| 1182 first word). You can use the "']" or "`]" command after the put command to | |
| 1183 move the cursor to the end of the inserted text, or use "'[" or "`[" to move | |
| 1184 the cursor to the start. | |
| 1185 | |
| 1186 *put-Visual-mode* *v_p* *v_P* | |
| 1187 When using a put command like |p| or |P| in Visual mode, Vim will try to | |
| 1188 replace the selected text with the contents of the register. Whether this | |
| 1189 works well depends on the type of selection and the type of the text in the | |
| 1190 register. With blockwise selection it also depends on the size of the block | |
| 236 | 1191 and whether the corners are on an existing character. (Implementation detail: |
| 7 | 1192 it actually works by first putting the register after the selection and then |
| 236 | 1193 deleting the selection.) |
|
28714
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1194 With |p| the previously selected text is put in the unnamed register (and |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1195 possibly the selection and/or clipboard). This is useful if you want to put |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1196 that text somewhere else. But you cannot repeat the same change. |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1197 With |P| the unnamed register is not changed (and neither the selection or |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1198 clipboard), you can repeat the same change. But the deleted text cannot be |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1199 used. If you do need it you can use |p| with another register. E.g., yank |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1200 the text to copy, Visually select the text to replace and use "0p . You can |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1201 repeat this as many times as you like, and the unnamed register will be |
|
5eea8a249f86
patch 8.2.4881: "P" in Visual mode still changes some registers
Bram Moolenaar <Bram@vim.org>
parents:
28517
diff
changeset
|
1202 changed each time. |
| 30324 | 1203 *blockwise-put* |
| 1204 When a register contains text from one line (characterwise), using a | |
| 1205 blockwise Visual selection, putting that register will paste that text | |
| 1206 repeatedly in each of the selected lines, thus replacing the blockwise | |
| 1207 selected region by multiple copies of the register text. For example: | |
| 1208 - yank the word "TEXT" into a register with `yw` | |
| 1209 - select a visual block, marked with "v" in this text: | |
| 1210 aaavvaaa | |
| 1211 bbbvvbbb | |
| 1212 cccvvccc | |
| 1213 - press `p`, results in: | |
| 1214 aaaTEXTaaa | |
| 1215 bbbTEXTbbb | |
| 1216 cccTEXTccc | |
| 5365 | 1217 |
| 7 | 1218 *blockwise-register* |
| 1219 If you use a blockwise Visual mode command to get the text into the register, | |
| 1220 the block of text will be inserted before ("P") or after ("p") the cursor | |
| 1221 column in the current and next lines. Vim makes the whole block of text start | |
| 1222 in the same column. Thus the inserted text looks the same as when it was | |
| 1223 yanked or deleted. Vim may replace some <Tab> characters with spaces to make | |
| 1224 this happen. However, if the width of the block is not a multiple of a <Tab> | |
| 1225 width and the text after the inserted block contains <Tab>s, that text may be | |
| 1226 misaligned. | |
| 1227 | |
| 25973 | 1228 Use |zP|/|zp| to paste a blockwise yanked register without appending trailing |
| 1229 spaces. | |
| 1230 | |
| 7 | 1231 Note that after a characterwise yank command, Vim leaves the cursor on the |
| 1232 first yanked character that is closest to the start of the buffer. This means | |
| 1233 that "yl" doesn't move the cursor, but "yh" moves the cursor one character | |
| 1234 left. | |
| 1235 Rationale: In Vi the "y" command followed by a backwards motion would | |
| 1236 sometimes not move the cursor to the first yanked character, | |
| 1237 because redisplaying was skipped. In Vim it always moves to | |
| 1238 the first character, as specified by Posix. | |
| 1239 With a linewise yank command the cursor is put in the first line, but the | |
| 1240 column is unmodified, thus it may not be on the first yanked character. | |
| 1241 | |
| 18186 | 1242 There are ten types of registers: *registers* *{register}* *E354* |
| 7 | 1243 1. The unnamed register "" |
| 1244 2. 10 numbered registers "0 to "9 | |
| 1245 3. The small delete register "- | |
| 1246 4. 26 named registers "a to "z or "A to "Z | |
| 17372 | 1247 5. Three read-only registers ":, "., "% |
| 1248 6. Alternate buffer register "# | |
| 1249 7. The expression register "= | |
| 6557 | 1250 8. The selection and drop registers "*, "+ and "~ |
| 1251 9. The black hole register "_ | |
| 1252 10. Last search pattern register "/ | |
| 7 | 1253 |
| 1254 1. Unnamed register "" *quote_quote* *quotequote* | |
| 1255 Vim fills this register with text deleted with the "d", "c", "s", "x" commands | |
| 1256 or copied with the yank "y" command, regardless of whether or not a specific | |
| 8 | 1257 register was used (e.g. "xdd). This is like the unnamed register is pointing |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1258 to the last used register. Thus when appending using an uppercase register |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1259 name, the unnamed register contains the same text as the named register. |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1260 An exception is the '_' register: "_dd does not store the deleted text in any |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1261 register. |
| 42 | 1262 Vim uses the contents of the unnamed register for any put command (p or P) |
| 1263 which does not specify a register. Additionally you can access it with the | |
| 1264 name '"'. This means you have to type two double quotes. Writing to the "" | |
| 1265 register writes to register "0. | |
| 7 | 1266 {Vi: register contents are lost when changing files, no '"'} |
| 1267 | |
|
8951
0bdeaf7092bc
commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents:
8497
diff
changeset
|
1268 2. Numbered registers "0 to "9 *quote_number* *quote0* *quote1* |
| 7 | 1269 *quote2* *quote3* *quote4* *quote9* |
| 1270 Vim fills these registers with text from yank and delete commands. | |
| 1271 Numbered register 0 contains the text from the most recent yank command, | |
| 1272 unless the command specified another register with ["x]. | |
| 1273 Numbered register 1 contains the text deleted by the most recent delete or | |
| 1274 change command, unless the command specified another register or the text is | |
| 1275 less than one line (the small delete register is used then). An exception is | |
| 42 | 1276 made for the delete operator with these movement commands: |%|, |(|, |)|, |`|, |
| 1277 |/|, |?|, |n|, |N|, |{| and |}|. Register "1 is always used then (this is Vi | |
| 1278 compatible). The "- register is used as well if the delete is within a line. | |
|
5362
ab1508486b12
Update runtime files. Add support for J.
Bram Moolenaar <bram@vim.org>
parents:
5340
diff
changeset
|
1279 Note that these characters may be mapped. E.g. |%| is mapped by the matchit |
| 5340 | 1280 plugin. |
| 7 | 1281 With each successive deletion or change, Vim shifts the previous contents |
| 1282 of register 1 into register 2, 2 into 3, and so forth, losing the previous | |
| 1283 contents of register 9. | |
| 1284 {Vi: numbered register contents are lost when changing files; register 0 does | |
| 1285 not exist} | |
| 1286 | |
| 1287 3. Small delete register "- *quote_-* *quote-* | |
| 1288 This register contains text from commands that delete less than one line, | |
| 1289 except when the command specifies a register with ["x]. | |
| 1290 | |
| 1291 4. Named registers "a to "z or "A to "Z *quote_alpha* *quotea* | |
| 1292 Vim fills these registers only when you say so. Specify them as lowercase | |
| 1293 letters to replace their previous contents or as uppercase letters to append | |
| 164 | 1294 to their previous contents. When the '>' flag is present in 'cpoptions' then |
| 1295 a line break is inserted before the appended text. | |
| 7 | 1296 |
| 6557 | 1297 5. Read-only registers ":, ". and "% |
| 29066 | 1298 These are '%', ':' and '.'. You can use them only with the "p", "P", |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1299 and ":put" commands and with CTRL-R. |
| 7 | 1300 *quote_.* *quote.* *E29* |
| 1301 ". Contains the last inserted text (the same as what is inserted | |
| 1302 with the insert mode commands CTRL-A and CTRL-@). Note: this | |
| 1303 doesn't work with CTRL-R on the command-line. It works a bit | |
| 1304 differently, like inserting the text instead of putting it | |
| 1305 ('textwidth' and other options affect what is inserted). | |
| 1306 *quote_%* *quote%* | |
| 1307 "% Contains the name of the current file. | |
| 1308 *quote_:* *quote:* *E30* | |
| 1309 ": Contains the most recent executed command-line. Example: Use | |
| 1310 "@:" to repeat the previous command-line command. | |
| 1311 The command-line is only stored in this register when at least | |
| 1312 one character of it was typed. Thus it remains unchanged if | |
| 1313 the command was completely from a mapping. | |
| 1314 {not available when compiled without the |+cmdline_hist| | |
| 1315 feature} | |
| 6557 | 1316 *quote_#* *quote#* |
| 1317 6. Alternate file register "# | |
| 1318 Contains the name of the alternate file for the current window. It will | |
| 1319 change how the |CTRL-^| command works. | |
| 1320 This register is writable, mainly to allow for restoring it after a plugin has | |
| 1321 changed it. It accepts buffer number: > | |
| 1322 let altbuf = bufnr(@#) | |
| 1323 ... | |
| 1324 let @# = altbuf | |
| 1325 It will give error |E86| if you pass buffer number and this buffer does not | |
| 1326 exist. | |
| 1327 It can also accept a match with an existing buffer name: > | |
| 1328 let @# = 'buffer_name' | |
| 1329 Error |E93| if there is more than one buffer matching the given name or |E94| | |
| 1330 if none of buffers matches the given name. | |
| 7 | 1331 |
| 6557 | 1332 7. Expression register "= *quote_=* *quote=* *@=* |
| 7 | 1333 This is not really a register that stores text, but is a way to use an |
| 1334 expression in commands which use a register. The expression register is | |
| 6647 | 1335 read-write. |
| 1336 | |
| 1337 When typing the '=' after " or CTRL-R the cursor moves to the command-line, | |
| 1338 where you can enter any expression (see |expression|). All normal | |
| 1339 command-line editing commands are available, including a special history for | |
| 1340 expressions. When you end the command-line by typing <CR>, Vim computes the | |
| 1341 result of the expression. If you end it with <Esc>, Vim abandons the | |
| 1342 expression. If you do not enter an expression, Vim uses the previous | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1343 expression (like with the "/" command). |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1344 |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1345 The expression must evaluate to a String. A Number is always automatically |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1346 converted to a String. For the "p" and ":put" command, if the result is a |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1347 Float it's converted into a String. If the result is a List each element is |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1348 turned into a String and used as a line. A Dictionary or FuncRef results in |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1349 an error message (use string() to convert). |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1350 |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1351 If the "= register is used for the "p" command, the String is split up at <NL> |
|
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1352 characters. If the String ends in a <NL>, it is regarded as a linewise |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1353 register. |
| 7 | 1354 |
| 6557 | 1355 8. Selection and drop registers "*, "+ and "~ |
|
2207
b17bbfa96fa0
Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
1356 Use these registers for storing and retrieving the selected text for the GUI. |
| 7 | 1357 See |quotestar| and |quoteplus|. When the clipboard is not available or not |
| 571 | 1358 working, the unnamed register is used instead. For Unix systems the clipboard |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1359 is only available when the |+xterm_clipboard| feature is present. |
| 7 | 1360 |
| 1361 Note that there is only a distinction between "* and "+ for X11 systems. For | |
| 1362 an explanation of the difference, see |x11-selection|. Under MS-Windows, use | |
| 1363 of "* and "+ is actually synonymous and refers to the |gui-clipboard|. | |
| 1364 | |
| 1365 *quote_~* *quote~* *<Drop>* | |
| 1366 The read-only "~ register stores the dropped text from the last drag'n'drop | |
| 1367 operation. When something has been dropped onto Vim, the "~ register is | |
| 1368 filled in and the <Drop> pseudo key is sent for notification. You can remap | |
| 1369 this key if you want; the default action (for all modes) is to insert the | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1370 contents of the "~ register at the cursor position. |
| 9 | 1371 {only available when compiled with the |+dnd| feature, currently only with the |
| 7 | 1372 GTK GUI} |
| 1373 | |
| 1374 Note: The "~ register is only used when dropping plain text onto Vim. | |
| 1375 Drag'n'drop of URI lists is handled internally. | |
| 1376 | |
| 6557 | 1377 9. Black hole register "_ *quote_* |
| 7 | 1378 When writing to this register, nothing happens. This can be used to delete |
| 1379 text without affecting the normal registers. When reading from this register, | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1380 nothing is returned. |
| 7 | 1381 |
| 18186 | 1382 10. Last search pattern register "/ *quote_/* *quote/* |
| 7 | 1383 Contains the most recent search-pattern. This is used for "n" and 'hlsearch'. |
| 3492 | 1384 It is writable with `:let`, you can change it to have 'hlsearch' highlight |
| 7 | 1385 other matches without actually searching. You can't yank or delete into this |
| 1621 | 1386 register. The search direction is available in |v:searchforward|. |
| 6647 | 1387 Note that the value is restored when returning from a function |
| 1621 | 1388 |function-search-undo|. |
| 7 | 1389 |
| 1390 *@/* | |
| 3492 | 1391 You can write to a register with a `:let` command |:let-@|. Example: > |
| 7 | 1392 :let @/ = "the" |
| 1393 | |
| 1394 If you use a put command without specifying a register, Vim uses the register | |
| 1395 that was last filled (this is also the contents of the unnamed register). If | |
| 3492 | 1396 you are confused, use the `:dis` command to find out what Vim will put (this |
| 7 | 1397 command displays all named and numbered registers; the unnamed register is |
| 1398 labelled '"'). | |
| 1399 | |
| 1400 The next three commands always work on whole lines. | |
| 1401 | |
| 1402 :[range]co[py] {address} *:co* *:copy* | |
| 1403 Copy the lines given by [range] to below the line | |
| 1404 given by {address}. | |
| 1405 | |
| 1406 *:t* | |
| 1407 :t Synonym for copy. | |
| 26779 | 1408 This command is not supported in |Vim9| script, |
| 1409 because it is too easily confused with a variable | |
| 1410 name. | |
| 7 | 1411 |
| 1412 :[range]m[ove] {address} *:m* *:mo* *:move* *E134* | |
| 1413 Move the lines given by [range] to below the line | |
| 1414 given by {address}. | |
| 1415 | |
| 1416 ============================================================================== | |
| 1417 6. Formatting text *formatting* | |
| 1418 | |
| 1419 :[range]ce[nter] [width] *:ce* *:center* | |
| 1420 Center lines in [range] between [width] columns | |
| 1421 (default 'textwidth' or 80 when 'textwidth' is 0). | |
| 1422 | |
| 1423 :[range]ri[ght] [width] *:ri* *:right* | |
| 1424 Right-align lines in [range] at [width] columns | |
| 1425 (default 'textwidth' or 80 when 'textwidth' is 0). | |
| 1426 | |
| 1427 *:le* *:left* | |
| 1428 :[range]le[ft] [indent] | |
| 1429 Left-align lines in [range]. Sets the indent in the | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1430 lines to [indent] (default 0). |
| 7 | 1431 |
| 1432 *gq* | |
| 216 | 1433 gq{motion} Format the lines that {motion} moves over. |
| 667 | 1434 Formatting is done with one of three methods: |
| 1435 1. If 'formatexpr' is not empty the expression is | |
| 1436 evaluated. This can differ for each buffer. | |
| 670 | 1437 2. If 'formatprg' is not empty an external program |
| 667 | 1438 is used. |
| 843 | 1439 3. Otherwise formatting is done internally. |
| 667 | 1440 |
| 1441 In the third case the 'textwidth' option controls the | |
| 1442 length of each formatted line (see below). | |
| 216 | 1443 If the 'textwidth' option is 0, the formatted line |
| 1444 length is the screen width (with a maximum width of | |
| 667 | 1445 79). |
| 7 | 1446 The 'formatoptions' option controls the type of |
| 1447 formatting |fo-table|. | |
| 216 | 1448 The cursor is left on the first non-blank of the last |
| 1449 formatted line. | |
| 7 | 1450 NOTE: The "Q" command formerly performed this |
| 1451 function. If you still want to use "Q" for | |
| 1452 formatting, use this mapping: > | |
| 1453 :nnoremap Q gq | |
| 1454 | |
| 1455 gqgq *gqgq* *gqq* | |
|
2434
86532ee3ea41
Updated runtime files. Add logcheck filetype plugin. (James Vega)
Bram Moolenaar <bram@vim.org>
parents:
2413
diff
changeset
|
1456 gqq Format the current line. With a count format that |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1457 many lines. |
| 7 | 1458 |
| 1459 *v_gq* | |
| 1460 {Visual}gq Format the highlighted text. (for {Visual} see | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1461 |Visual-mode|). |
| 7 | 1462 |
| 1463 *gw* | |
| 1464 gw{motion} Format the lines that {motion} moves over. Similar to | |
| 1465 |gq| but puts the cursor back at the same position in | |
| 667 | 1466 the text. However, 'formatprg' and 'formatexpr' are |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1467 not used. |
| 7 | 1468 |
| 9 | 1469 gwgw *gwgw* *gww* |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1470 gww Format the current line as with "gw". |
| 9 | 1471 |
| 1472 *v_gw* | |
| 1473 {Visual}gw Format the highlighted text as with "gw". (for | |
|
16553
0e473e9e70c2
patch 8.1.1280: remarks about functionality not in Vi clutters the help
Bram Moolenaar <Bram@vim.org>
parents:
15878
diff
changeset
|
1474 {Visual} see |Visual-mode|). |
| 9 | 1475 |
| 7 | 1476 Example: To format the current paragraph use: *gqap* > |
| 1477 gqap | |
| 1478 | |
| 1479 The "gq" command leaves the cursor in the line where the motion command takes | |
| 1480 the cursor. This allows you to repeat formatting repeated with ".". This | |
| 1481 works well with "gqj" (format current and next line) and "gq}" (format until | |
| 1482 end of paragraph). Note: When 'formatprg' is set, "gq" leaves the cursor on | |
| 1483 the first formatted line (as with using a filter command). | |
| 1484 | |
| 1485 If you want to format the current paragraph and continue where you were, use: > | |
| 1486 gwap | |
| 1487 If you always want to keep paragraphs formatted you may want to add the 'a' | |
| 1488 flag to 'formatoptions'. See |auto-format|. | |
| 1489 | |
| 1490 If the 'autoindent' option is on, Vim uses the indent of the first line for | |
| 1491 the following lines. | |
| 1492 | |
| 1493 Formatting does not change empty lines (but it does change lines with only | |
| 1494 white space!). | |
| 1495 | |
| 1496 The 'joinspaces' option is used when lines are joined together. | |
| 1497 | |
| 667 | 1498 You can set the 'formatexpr' option to an expression or the 'formatprg' option |
| 1499 to the name of an external program for Vim to use for text formatting. The | |
| 1500 'textwidth' and other options have no effect on formatting by an external | |
| 1501 program. | |
| 7 | 1502 |
| 13912 | 1503 *format-formatexpr* |
| 14519 | 1504 The 'formatexpr' option can be set to a Vim script function that performs |
| 13912 | 1505 reformatting of the buffer. This should usually happen in an |ftplugin|, |
| 1506 since formatting is highly dependent on the type of file. It makes | |
| 1507 sense to use an |autoload| script, so the corresponding script is only loaded | |
| 1508 when actually needed and the script should be called <filetype>format.vim. | |
| 1509 | |
| 1510 For example, the XML filetype plugin distributed with Vim in the $VIMRUNTIME | |
| 1511 directory, sets the 'formatexpr' option to: > | |
| 1512 | |
| 1513 setlocal formatexpr=xmlformat#Format() | |
| 1514 | |
| 1515 That means, you will find the corresponding script, defining the | |
| 1516 xmlformat#Format() function, in the directory: | |
| 1517 `$VIMRUNTIME/autoload/xmlformat.vim` | |
| 1518 | |
| 1519 Here is an example script that removes trailing whitespace from the selected | |
| 1520 text. Put it in your autoload directory, e.g. ~/.vim/autoload/format.vim: > | |
| 1521 | |
| 1522 func! format#Format() | |
| 1523 " only reformat on explicit gq command | |
| 1524 if mode() != 'n' | |
| 19968 | 1525 " fall back to Vim's internal reformatting |
| 13912 | 1526 return 1 |
| 1527 endif | |
| 1528 let lines = getline(v:lnum, v:lnum + v:count - 1) | |
| 1529 call map(lines, {key, val -> substitute(val, '\s\+$', '', 'g')}) | |
| 1530 call setline('.', lines) | |
| 1531 | |
| 1532 " do not run internal formatter! | |
| 1533 return 0 | |
| 1534 endfunc | |
| 1535 | |
| 1536 You can then enable the formatting by executing: > | |
| 1537 setlocal formatexpr=format#Format() | |
| 14519 | 1538 |
| 13912 | 1539 Note: this function explicitly returns non-zero when called from insert mode |
| 1540 (which basically means, text is inserted beyond the 'textwidth' limit). This | |
| 1541 causes Vim to fall back to reformat the text by using the internal formatter. | |
| 1542 | |
| 1543 However, if the |gq| command is used to reformat the text, the function | |
| 1544 will receive the selected lines, trim trailing whitespace from those lines and | |
| 1545 put them back in place. If you are going to split single lines into multiple | |
| 1546 lines, be careful not to overwrite anything. | |
| 1547 | |
| 1548 If you want to allow reformatting of text from insert or replace mode, one has | |
| 1549 to be very careful, because the function might be called recursively. For | |
| 1550 debugging it helps to set the 'debug' option. | |
| 1551 | |
| 7 | 1552 *right-justify* |
| 1553 There is no command in Vim to right justify text. You can do it with | |
| 1554 an external command, like "par" (e.g.: "!}par" to format until the end of the | |
| 1555 paragraph) or set 'formatprg' to "par". | |
| 1556 | |
| 1557 *format-comments* | |
| 1621 | 1558 An overview of comment formatting is in section |30.6| of the user manual. |
| 1559 | |
| 1560 Vim can automatically insert and format comments in a special way. Vim | |
| 1561 recognizes a comment by a specific string at the start of the line (ignoring | |
| 1562 white space). Three types of comments can be used: | |
| 7 | 1563 |
| 1564 - A comment string that repeats at the start of each line. An example is the | |
| 1565 type of comment used in shell scripts, starting with "#". | |
| 1566 - A comment string that occurs only in the first line, not in the following | |
| 1567 lines. An example is this list with dashes. | |
| 1568 - Three-piece comments that have a start string, an end string, and optional | |
| 1569 lines in between. The strings for the start, middle and end are different. | |
| 1621 | 1570 An example is the C style comment: |
| 7 | 1571 /* |
| 1572 * this is a C comment | |
| 1573 */ | |
| 1574 | |
| 1575 The 'comments' option is a comma-separated list of parts. Each part defines a | |
| 1576 type of comment string. A part consists of: | |
| 1577 {flags}:{string} | |
| 1578 | |
| 1579 {string} is the literal text that must appear. | |
| 1580 | |
| 1581 {flags}: | |
| 1582 n Nested comment. Nesting with mixed parts is allowed. If 'comments' | |
| 1583 is "n:),n:>" a line starting with "> ) >" is a comment. | |
| 1584 | |
| 1585 b Blank (<Space>, <Tab> or <EOL>) required after {string}. | |
| 1586 | |
| 1587 f Only the first line has the comment string. Do not repeat comment on | |
| 1588 the next line, but preserve indentation (e.g., a bullet-list). | |
| 1589 | |
| 1590 s Start of three-piece comment | |
| 1591 | |
| 1592 m Middle of a three-piece comment | |
| 1593 | |
| 1594 e End of a three-piece comment | |
| 1595 | |
| 1621 | 1596 l Left align. Used together with 's' or 'e', the leftmost character of |
| 1597 start or end will line up with the leftmost character from the middle. | |
| 1598 This is the default and can be omitted. See below for more details. | |
| 7 | 1599 |
| 1621 | 1600 r Right align. Same as above but rightmost instead of leftmost. See |
| 1601 below for more details. | |
| 7 | 1602 |
| 1621 | 1603 O Don't consider this comment for the "O" command. |
| 7 | 1604 |
| 1605 x Allows three-piece comments to be ended by just typing the last | |
| 1621 | 1606 character of the end-comment string as the first action on a new |
| 1607 line when the middle-comment string has been inserted automatically. | |
| 1608 See below for more details. | |
| 7 | 1609 |
| 1610 {digits} | |
| 1621 | 1611 When together with 's' or 'e': add {digit} amount of offset to an |
| 1612 automatically inserted middle or end comment leader. The offset begins | |
| 1613 from a left alignment. See below for more details. | |
| 7 | 1614 |
| 1615 -{digits} | |
| 1616 Like {digits} but reduce the indent. This only works when there is | |
| 1617 some indent for the start or end part that can be removed. | |
| 1618 | |
| 1619 When a string has none of the 'f', 's', 'm' or 'e' flags, Vim assumes the | |
| 1620 comment string repeats at the start of each line. The flags field may be | |
| 1621 empty. | |
| 1622 | |
| 1623 Any blank space in the text before and after the {string} is part of the | |
| 1624 {string}, so do not include leading or trailing blanks unless the blanks are a | |
| 1625 required part of the comment string. | |
| 1626 | |
| 1627 When one comment leader is part of another, specify the part after the whole. | |
| 1628 For example, to include both "-" and "->", use > | |
| 1629 :set comments=f:->,f:- | |
| 1630 | |
| 1631 A three-piece comment must always be given as start,middle,end, with no other | |
| 1632 parts in between. An example of a three-piece comment is > | |
| 1633 sr:/*,mb:*,ex:*/ | |
| 1634 for C-comments. To avoid recognizing "*ptr" as a comment, the middle string | |
| 1635 includes the 'b' flag. For three-piece comments, Vim checks the text after | |
| 1636 the start and middle strings for the end string. If Vim finds the end string, | |
| 1637 the comment does not continue on the next line. Three-piece comments must | |
| 1638 have a middle string because otherwise Vim can't recognize the middle lines. | |
| 1639 | |
| 1640 Notice the use of the "x" flag in the above three-piece comment definition. | |
| 1641 When you hit Return in a C-comment, Vim will insert the middle comment leader | |
| 1621 | 1642 for the new line: " * ". To close this comment you just have to type "/" |
| 7 | 1643 before typing anything else on the new line. This will replace the |
| 1621 | 1644 middle-comment leader with the end-comment leader and apply any specified |
| 6647 | 1645 alignment, leaving just " */". There is no need to hit Backspace first. |
| 1621 | 1646 |
| 6647 | 1647 When there is a match with a middle part, but there also is a matching end |
| 1648 part which is longer, the end part is used. This makes a C style comment work | |
| 2826 | 1649 without requiring the middle part to end with a space. |
| 1621 | 1650 |
| 1651 Here is an example of alignment flags at work to make a comment stand out | |
| 2826 | 1652 (kind of looks like a 1 too). Consider comment string: > |
| 1653 :set comments=sr:/***,m:**,ex-2:******/ | |
| 1654 < | |
| 1655 /*** ~ | |
| 1656 **<--right aligned from "r" flag ~ | |
| 1657 ** ~ | |
| 1658 offset 2 spaces for the "-2" flag--->** ~ | |
| 1659 ******/ ~ | |
| 1621 | 1660 In this case, the first comment was typed, then return was pressed 4 times, |
| 1661 then "/" was pressed to end the comment. | |
| 7 | 1662 |
| 1621 | 1663 Here are some finer points of three part comments. There are three times when |
| 1664 alignment and offset flags are taken into consideration: opening a new line | |
| 1665 after a start-comment, opening a new line before an end-comment, and | |
| 1666 automatically ending a three-piece comment. The end alignment flag has a | |
| 1667 backwards perspective; the result is that the same alignment flag used with | |
| 1668 "s" and "e" will result in the same indent for the starting and ending pieces. | |
| 1669 Only one alignment per comment part is meant to be used, but an offset number | |
| 1670 will override the "r" and "l" flag. | |
| 1671 | |
| 1672 Enabling 'cindent' will override the alignment flags in many cases. | |
| 1673 Reindenting using a different method like |gq| or |=| will not consult | |
| 1674 alignment flags either. The same behaviour can be defined in those other | |
| 1675 formatting options. One consideration is that 'cindent' has additional options | |
| 1676 for context based indenting of comments but cannot replicate many three piece | |
| 2826 | 1677 indent alignments. However, 'indentexpr' has the ability to work better with |
| 1678 three piece comments. | |
| 1621 | 1679 |
| 1680 Other examples: > | |
| 7 | 1681 "b:*" Includes lines starting with "*", but not if the "*" is |
| 1682 followed by a non-blank. This avoids a pointer dereference | |
| 1683 like "*str" to be recognized as a comment. | |
| 1684 "n:>" Includes a line starting with ">", ">>", ">>>", etc. | |
| 1685 "fb:-" Format a list that starts with "- ". | |
| 1686 | |
| 1687 By default, "b:#" is included. This means that a line that starts with | |
| 1688 "#include" is not recognized as a comment line. But a line that starts with | |
| 1689 "# define" is recognized. This is a compromise. | |
| 1690 | |
| 1691 *fo-table* | |
| 1692 You can use the 'formatoptions' option to influence how Vim formats text. | |
| 1693 'formatoptions' is a string that can contain any of the letters below. The | |
| 1694 default setting is "tcq". You can separate the option letters with commas for | |
| 1695 readability. | |
| 1696 | |
| 1697 letter meaning when present in 'formatoptions' ~ | |
| 23737 | 1698 *fo-t* |
|
28765
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1699 t Auto-wrap text using 'textwidth' |
| 23737 | 1700 *fo-c* |
|
28765
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1701 c Auto-wrap comments using 'textwidth', inserting the current comment |
| 7 | 1702 leader automatically. |
| 23737 | 1703 *fo-r* |
| 7 | 1704 r Automatically insert the current comment leader after hitting |
| 1705 <Enter> in Insert mode. | |
| 23737 | 1706 *fo-o* |
| 7 | 1707 o Automatically insert the current comment leader after hitting 'o' or |
| 26847 | 1708 'O' in Normal mode. In case comment is unwanted in a specific place |
| 1709 use CTRL-U to quickly delete it. |i_CTRL-U| | |
|
28765
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1710 *fo-/* |
|
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1711 / When 'o' is included: do not insert the comment leader for a // |
|
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1712 comment after a statement, only when // is at the start of the line. |
| 23737 | 1713 *fo-q* |
| 7 | 1714 q Allow formatting of comments with "gq". |
| 1715 Note that formatting will not change blank lines or lines containing | |
| 1716 only the comment leader. A new paragraph starts after such a line, | |
| 1717 or when the comment leader changes. | |
| 23737 | 1718 *fo-w* |
| 7 | 1719 w Trailing white space indicates a paragraph continues in the next line. |
| 1720 A line that ends in a non-white character ends a paragraph. | |
| 23737 | 1721 *fo-a* |
| 7 | 1722 a Automatic formatting of paragraphs. Every time text is inserted or |
| 1723 deleted the paragraph will be reformatted. See |auto-format|. | |
| 1724 When the 'c' flag is present this only happens for recognized | |
| 1725 comments. | |
| 23737 | 1726 *fo-n* |
| 41 | 1727 n When formatting text, recognize numbered lists. This actually uses |
| 1728 the 'formatlistpat' option, thus any kind of list can be used. The | |
| 1729 indent of the text after the number is used for the next line. The | |
| 1621 | 1730 default is to find a number, optionally followed by '.', ':', ')', |
| 41 | 1731 ']' or '}'. Note that 'autoindent' must be set too. Doesn't work |
| 1732 well together with "2". | |
| 7 | 1733 Example: > |
| 1734 1. the first item | |
| 1735 wraps | |
| 1736 2. the second item | |
| 23737 | 1737 < *fo-2* |
| 7 | 1738 2 When formatting text, use the indent of the second line of a paragraph |
| 1739 for the rest of the paragraph, instead of the indent of the first | |
| 1740 line. This supports paragraphs in which the first line has a | |
| 1741 different indent than the rest. Note that 'autoindent' must be set | |
| 1742 too. Example: > | |
| 1743 first line of a paragraph | |
| 1744 second line of the same paragraph | |
| 1745 third line. | |
| 3682 | 1746 < This also works inside comments, ignoring the comment leader. |
| 23737 | 1747 *fo-v* |
| 7 | 1748 v Vi-compatible auto-wrapping in insert mode: Only break a line at a |
| 1749 blank that you have entered during the current insert command. (Note: | |
| 1750 this is not 100% Vi compatible. Vi has some "unexpected features" or | |
| 1751 bugs in this area. It uses the screen column instead of the line | |
| 1752 column.) | |
| 23737 | 1753 *fo-b* |
| 7 | 1754 b Like 'v', but only auto-wrap if you enter a blank at or before |
| 1755 the wrap margin. If the line was longer than 'textwidth' when you | |
| 1756 started the insert, or you do not enter a blank in the insert before | |
| 1757 reaching 'textwidth', Vim does not perform auto-wrapping. | |
| 23737 | 1758 *fo-l* |
| 7 | 1759 l Long lines are not broken in insert mode: When a line was longer than |
| 1760 'textwidth' when the insert command started, Vim does not | |
| 1761 automatically format it. | |
| 23737 | 1762 *fo-m* |
| 21991 | 1763 m Also break at a multibyte character above 255. This is useful for |
| 7 | 1764 Asian text where every character is a word on its own. |
| 23737 | 1765 *fo-M* |
| 21991 | 1766 M When joining lines, don't insert a space before or after a multibyte |
| 7 | 1767 character. Overrules the 'B' flag. |
| 23737 | 1768 *fo-B* |
| 21991 | 1769 B When joining lines, don't insert a space between two multibyte |
| 7 | 1770 characters. Overruled by the 'M' flag. |
| 23737 | 1771 *fo-1* |
| 7 | 1772 1 Don't break a line after a one-letter word. It's broken before it |
| 1773 instead (if possible). | |
| 23737 | 1774 *fo-]* |
|
28765
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1775 ] Respect 'textwidth' rigorously. With this flag set, no line can be |
|
38698deeda58
patch 8.2.4907: some users do not want a line comment always inserted
Bram Moolenaar <Bram@vim.org>
parents:
28714
diff
changeset
|
1776 longer than 'textwidth', unless line-break-prohibition rules make this |
|
20695
cea8ae407452
patch 8.2.0901: formatting CJK text isn't optimal
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
1777 impossible. Mainly for CJK scripts and works only if 'encoding' is |
|
cea8ae407452
patch 8.2.0901: formatting CJK text isn't optimal
Bram Moolenaar <Bram@vim.org>
parents:
20241
diff
changeset
|
1778 "utf-8". |
| 23737 | 1779 *fo-j* |
| 3562 | 1780 j Where it makes sense, remove a comment leader when joining lines. For |
| 1781 example, joining: | |
| 1782 int i; // the index ~ | |
| 1783 // in the list ~ | |
| 1784 Becomes: | |
| 1785 int i; // the index in the list ~ | |
| 23737 | 1786 *fo-p* |
|
15440
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1787 p Don't break lines at single spaces that follow periods. This is |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1788 intended to complement 'joinspaces' and |cpo-J|, for prose with |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1789 sentences separated by two spaces. For example, with 'textwidth' set |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1790 to 28: > |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1791 Surely you're joking, Mr. Feynman! |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1792 < Becomes: > |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1793 Surely you're joking, |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1794 Mr. Feynman! |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1795 < Instead of: > |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1796 Surely you're joking, Mr. |
|
5ecac7734184
patch 8.1.0728: cannot avoid breaking after a single space.
Bram Moolenaar <Bram@vim.org>
parents:
15194
diff
changeset
|
1797 Feynman! |
| 7 | 1798 |
| 1799 | |
| 1800 With 't' and 'c' you can specify when Vim performs auto-wrapping: | |
| 1801 value action ~ | |
| 1802 "" no automatic formatting (you can use "gq" for manual formatting) | |
| 1803 "t" automatic formatting of text, but not comments | |
| 1804 "c" automatic formatting for comments, but not text (good for C code) | |
| 1805 "tc" automatic formatting for text and comments | |
| 1806 | |
| 867 | 1807 Note that when 'textwidth' is 0, Vim does no automatic formatting anyway (but |
| 1808 does insert comment leaders according to the 'comments' option). An exception | |
| 1809 is when the 'a' flag is present. |auto-format| | |
| 7 | 1810 |
| 1811 Note that when 'paste' is on, Vim does no formatting at all. | |
| 1812 | |
| 1813 Note that 'textwidth' can be non-zero even if Vim never performs auto-wrapping; | |
| 1814 'textwidth' is still useful for formatting with "gq". | |
| 1815 | |
| 1816 If the 'comments' option includes "/*", "*" and/or "*/", then Vim has some | |
| 1817 built in stuff to treat these types of comments a bit more cleverly. | |
| 1818 Opening a new line before or after "/*" or "*/" (with 'r' or 'o' present in | |
| 1819 'formatoptions') gives the correct start of the line automatically. The same | |
| 236 | 1820 happens with formatting and auto-wrapping. Opening a line after a line |
| 7 | 1821 starting with "/*" or "*" and containing "*/", will cause no comment leader to |
| 1822 be inserted, and the indent of the new line is taken from the line containing | |
| 1823 the start of the comment. | |
| 1824 E.g.: | |
| 1825 /* ~ | |
| 1826 * Your typical comment. ~ | |
| 1827 */ ~ | |
| 1828 The indent on this line is the same as the start of the above | |
| 1829 comment. | |
| 1830 | |
| 1831 All of this should be really cool, especially in conjunction with the new | |
| 1832 :autocmd command to prepare different settings for different types of file. | |
| 1833 | |
| 1834 Some examples: | |
| 1835 for C code (only format comments): > | |
| 1836 :set fo=croq | |
| 1837 < for Mail/news (format all, don't start comment with "o" command): > | |
| 1838 :set fo=tcrq | |
| 1839 < | |
| 1840 | |
| 3492 | 1841 Automatic formatting *auto-format* *autoformat* |
| 7 | 1842 |
| 1843 When the 'a' flag is present in 'formatoptions' text is formatted | |
| 21499 | 1844 automatically when inserting text or deleting text. This works nicely for |
| 7 | 1845 editing text paragraphs. A few hints on how to use this: |
| 1846 | |
| 1847 - You need to properly define paragraphs. The simplest is paragraphs that are | |
| 1848 separated by a blank line. When there is no separating blank line, consider | |
| 1849 using the 'w' flag and adding a space at the end of each line in the | |
| 1850 paragraphs except the last one. | |
| 1851 | |
| 1852 - You can set the 'formatoptions' based on the type of file |filetype| or | |
| 1853 specifically for one file with a |modeline|. | |
| 1854 | |
| 1855 - Set 'formatoptions' to "aw2tq" to make text with indents like this: | |
| 1856 | |
| 32061 | 1857 bla bla foobar bla |
| 7 | 1858 bla foobar bla foobar bla |
| 32061 | 1859 bla bla foobar bla |
| 7 | 1860 bla foobar bla bla foobar |
| 1861 | |
| 1862 - Add the 'c' flag to only auto-format comments. Useful in source code. | |
| 1863 | |
| 867 | 1864 - Set 'textwidth' to the desired width. If it is zero then 79 is used, or the |
| 1865 width of the screen if this is smaller. | |
| 1866 | |
| 7 | 1867 And a few warnings: |
| 1868 | |
| 1869 - When part of the text is not properly separated in paragraphs, making | |
| 1870 changes in this text will cause it to be formatted anyway. Consider doing > | |
| 1871 | |
| 1872 :set fo-=a | |
| 1873 | |
| 1874 - When using the 'w' flag (trailing space means paragraph continues) and | |
| 1875 deleting the last line of a paragraph with |dd|, the paragraph will be | |
| 1876 joined with the next one. | |
| 1877 | |
| 1878 - Changed text is saved for undo. Formatting is also a change. Thus each | |
| 1879 format action saves text for undo. This may consume quite a lot of memory. | |
| 1880 | |
| 1881 - Formatting a long paragraph and/or with complicated indenting may be slow. | |
| 1882 | |
| 282 | 1883 ============================================================================== |
| 1884 7. Sorting text *sorting* | |
| 1885 | |
| 1886 Vim has a sorting function and a sorting command. The sorting function can be | |
| 5747 | 1887 found here: |sort()|, |uniq()|. |
| 282 | 1888 |
| 1889 *:sor* *:sort* | |
|
22770
3e4981de5636
patch 8.2.1933: cannot sort using locale ordering
Bram Moolenaar <Bram@vim.org>
parents:
21991
diff
changeset
|
1890 :[range]sor[t][!] [b][f][i][l][n][o][r][u][x] [/{pattern}/] |
| 586 | 1891 Sort lines in [range]. When no range is given all |
| 1892 lines are sorted. | |
| 282 | 1893 |
| 1894 With [!] the order is reversed. | |
| 1895 | |
| 1896 With [i] case is ignored. | |
| 1897 | |
| 22824 | 1898 With [l] sort uses the current collation locale. |
| 1899 Implementation details: strcoll() is used to compare | |
| 1900 strings. See |:language| to check or set the collation | |
| 1901 locale. Example: > | |
| 1902 :language collate en_US.UTF-8 | |
| 1903 :%sort l | |
| 1904 < |v:collate| can also used to check the current locale. | |
| 1905 Sorting using the locale typically ignores case. | |
| 1906 This does not work properly on Mac. | |
|
22770
3e4981de5636
patch 8.2.1933: cannot sort using locale ordering
Bram Moolenaar <Bram@vim.org>
parents:
21991
diff
changeset
|
1907 |
|
7689
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1908 Options [n][f][x][o][b] are mutually exclusive. |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1909 |
| 293 | 1910 With [n] sorting is done on the first decimal number |
| 826 | 1911 in the line (after or inside a {pattern} match). |
| 1698 | 1912 One leading '-' is included in the number. |
| 293 | 1913 |
|
7689
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1914 With [f] sorting is done on the Float in the line. |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1915 The value of Float is determined similar to passing |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1916 the text (after or inside a {pattern} match) to |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1917 str2float() function. This option is available only |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1918 if Vim was compiled with Floating point support. |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1919 |
| 293 | 1920 With [x] sorting is done on the first hexadecimal |
| 826 | 1921 number in the line (after or inside a {pattern} |
| 1922 match). A leading "0x" or "0X" is ignored. | |
| 1698 | 1923 One leading '-' is included in the number. |
| 293 | 1924 |
| 1925 With [o] sorting is done on the first octal number in | |
| 826 | 1926 the line (after or inside a {pattern} match). |
| 293 | 1927 |
|
7447
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
1928 With [b] sorting is done on the first binary number in |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
1929 the line (after or inside a {pattern} match). |
|
ad432f8f68fb
commit https://github.com/vim/vim/commit/887c1fea4a114e7170091942d0446c8882701b5b
Christian Brabandt <cb@256bit.org>
parents:
7183
diff
changeset
|
1930 |
|
7689
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1931 With [u] (u stands for unique) only keep the first of |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1932 a sequence of identical lines (ignoring case when [i] |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1933 is used). Without this flag, a sequence of identical |
|
20dc2763a3b9
commit https://github.com/vim/vim/commit/f7edf40448a09e04eec3bd05e043f7fea93b07c9
Christian Brabandt <cb@256bit.org>
parents:
7477
diff
changeset
|
1934 lines will be kept in their original order. |
| 293 | 1935 Note that leading and trailing white space may cause |
| 1936 lines to be different. | |
| 282 | 1937 |
| 826 | 1938 When /{pattern}/ is specified and there is no [r] flag |
| 1939 the text matched with {pattern} is skipped, so that | |
| 1940 you sort on what comes after the match. | |
| 22958 | 1941 'ignorecase' applies to the pattern, but 'smartcase' |
| 1942 is not used. | |
| 282 | 1943 Instead of the slash any non-letter can be used. |
| 1944 For example, to sort on the second comma-separated | |
| 1945 field: > | |
| 1946 :sort /[^,]*,/ | |
| 1947 < To sort on the text at virtual column 10 (thus | |
| 1948 ignoring the difference between tabs and spaces): > | |
| 1949 :sort /.*\%10v/ | |
| 824 | 1950 < To sort on the first number in the line, no matter |
| 1951 what is in front of it: > | |
| 1621 | 1952 :sort /.\{-}\ze\d/ |
| 1953 < (Explanation: ".\{-}" matches any text, "\ze" sets the | |
| 1954 end of the match and \d matches a digit.) | |
| 1955 With [r] sorting is done on the matching {pattern} | |
| 826 | 1956 instead of skipping past it as described above. |
| 1957 For example, to sort on only the first three letters | |
| 1958 of each line: > | |
| 1959 :sort /\a\a\a/ r | |
| 1960 | |
| 1961 < If a {pattern} is used, any lines which don't have a | |
| 1962 match for {pattern} are kept in their current order, | |
| 1963 but separate from the lines which do match {pattern}. | |
| 1964 If you sorted in reverse, they will be in reverse | |
| 1965 order after the sorted lines, otherwise they will be | |
| 1966 in their original order, right before the sorted | |
| 1967 lines. | |
| 1968 | |
| 1314 | 1969 If {pattern} is empty (e.g. // is specified), the |
| 1970 last search pattern is used. This allows trying out | |
| 1971 a pattern first. | |
| 1972 | |
| 3492 | 1973 Note that using `:sort` with `:global` doesn't sort the matching lines, it's |
| 293 | 1974 quite useless. |
| 7 | 1975 |
|
22770
3e4981de5636
patch 8.2.1933: cannot sort using locale ordering
Bram Moolenaar <Bram@vim.org>
parents:
21991
diff
changeset
|
1976 `:sort` does not use the current locale unless the l flag is used. |
|
6032
b8f703a4e55f
Updated runtime files. Overhauled HTML indent script.
Bram Moolenaar <bram@vim.org>
parents:
5747
diff
changeset
|
1977 Vim does do a "stable" sort. |
| 359 | 1978 |
| 826 | 1979 The sorting can be interrupted, but if you interrupt it too late in the |
| 1980 process you may end up with duplicated lines. This also depends on the system | |
| 1981 library function used. | |
| 481 | 1982 |
| 14421 | 1983 vim:tw=78:ts=8:noet:ft=help:norl: |