1- *change.txt* For Vim version 8.2. Last change: 2021 Mar 01
1+ *change.txt* For Vim version 8.2. Last change: 2022 Mar 05
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -259,6 +259,9 @@ Or use "caw" (see |aw|).
259259 line.
260260 Adding [!] toggles 'autoindent' for the time this
261261 command is executed.
262+ This command is not supported in | Vim9 | script,
263+ because it is too easily confused with a variable
264+ name.
262265
263266==============================================================================
2642673. Simple changes *simple-change*
@@ -775,17 +778,20 @@ matched pattern is deleted. The separator after {pattern} can also be left
775778out then. Example: >
776779 :%s/TESTING
777780
778-
779- For compatibility with Vi these two exceptions are allowed:
781+ *E1270*
782+ For compatibility with Vi these two exceptions are allowed in legacy script :
780783"\/{string} /" and "\?{string} ?" do the same as "//{string} /r".
781784"\&{string} &" does the same as "//{string} /".
782- *pattern-delimiter* *E146*
783- Instead of the '/' which surrounds the pattern and replacement string, you
784- can use any other single-byte character, but not an alphanumeric character,
785- '\', '"' or '|'. This is useful if you want to include a '/' in the search
786- pattern or replacement string. Example: >
785+ *pattern-delimiter* *E146* *E1241* *E1242*
786+ Instead of the '/' which surrounds the pattern and replacement string, you can
787+ use another single-byte character. This is useful if you want to include a
788+ '/' in the search pattern or replacement string. Example: >
787789 :s+/+//+
788790
791+
792+ '|'. In Vim9 script you should not use '#' because it may be recognized as
793+ the start of a comment.
794+
789795For the definition of a pattern, see | pattern | . In Visual block mode, use
790796| /\%V | in the pattern to have the substitute work in the block only.
791797Otherwise it works on whole lines anyway.
@@ -940,7 +946,7 @@ Consider using a character like "@" or ":". There is no problem if the result
940946of the expression contains the separation character.
941947
942948Examples: >
943- :s@\n@\="\r" . expand("$HOME") . "\r"@
949+ :s@\n@\="\r" .. expand("$HOME") . . "\r"@
944950>
945951
946952 s/E/\="\<Char-0x20ac>"/g
@@ -1042,6 +1048,10 @@ inside of strings can change! Also see 'softtabstop' option. >
10421048 cursor to the end of line (which is more logical,
10431049 but not Vi-compatible) use ":map Y y$".
10441050
1051+ *zy*
1052+ ["x]zy{motion} Yank {motion} text [into register x]. Only differs
1053+ from `y ` when selecting a block of text, see | v_zy | .
1054+
10451055 *v_y*
10461056{Visual} ["x]y Yank the highlighted text [into register x] (for
10471057 {Visual} see | Visual-mode | ).
@@ -1050,6 +1060,12 @@ inside of strings can change! Also see 'softtabstop' option. >
10501060{Visual} ["x]Y Yank the highlighted lines [into register x] (for
10511061 {Visual} see | Visual-mode | ).
10521062
1063+ *v_zy*
1064+ {Visual} ["x]zy Yank the highlighted text [into register x]. Trailing
1065+ whitespace at the end of each line of a selected block
1066+ won't be yanked. Especially useful in combination
1067+ with `zp ` . (for {Visual} see | Visual-mode | )
1068+
10531069 *:y* *:yank* *E850*
10541070:[range] y[ank] [x] Yank [range] lines [into register x]. Yanking to the
10551071 "* or "+ registers is possible only when the
@@ -1060,7 +1076,7 @@ inside of strings can change! Also see 'softtabstop' option. >
10601076 in [range] (default: current line | cmdline-ranges | ),
10611077 [into register x].
10621078
1063- *p* *put* *E353*
1079+ *p* *put* *E353* *E1240 *
10641080["x]p Put the text [from register x] after the cursor
10651081 [count] times.
10661082
@@ -1107,7 +1123,7 @@ inside of strings can change! Also see 'softtabstop' option. >
11071123 the command. You need to escape the '|' and '"'
11081124 characters to prevent them from terminating the
11091125 command. Example: >
1110- :put ='path' . \",/test\"
1126+ :put ='path' .. \",/test\"
11111127< If there is no expression after '=', Vim uses the
11121128 previous expression. You can see it with ":dis =".
11131129
@@ -1126,6 +1142,12 @@ inside of strings can change! Also see 'softtabstop' option. >
11261142 Using the mouse only works when 'mouse' contains 'n'
11271143 or 'a'.
11281144
1145+ ["x]zp or *zp* *zP*
1146+ ["x]zP Like "p" and "P", except without adding trailing spaces
1147+ when pasting a block. Thus the inserted text will not
1148+ always be a rectangle. Especially useful in
1149+ combination with | v_zy | .
1150+
11291151You can use these commands to copy text from one place to another. Do this
11301152by first getting the text into a register with a yank, delete or change
11311153command, then inserting the register contents with a put command. You can
@@ -1154,10 +1176,13 @@ register. With blockwise selection it also depends on the size of the block
11541176and whether the corners are on an existing character. (Implementation detail:
11551177it actually works by first putting the register after the selection and then
11561178deleting the selection.)
1157- The previously selected text is put in the unnamed register. If you want to
1158- put the same text into a Visual selection several times you need to use
1179+ With 'p' the previously selected text is put in the unnamed register. This is
1180+ useful if you want to put that text somewhere else. But you cannot repeat the
1181+ same change.
1182+ With 'P' the unnamed register is not changed, you can repeat the same change.
1183+ But the deleted text cannot be used. If you do need it you can use 'p' with
11591184another register. E.g., yank the text to copy, Visually select the text to
1160- replace and use "0p . You can repeat this as many times as you like, the
1185+ replace and use "0p . You can repeat this as many times as you like, and the
11611186unnamed register will be changed each time.
11621187
11631188When you use a blockwise Visual mode command and yank only a single line into
@@ -1175,6 +1200,9 @@ this happen. However, if the width of the block is not a multiple of a <Tab>
11751200width and the text after the inserted block contains <Tab> s, that text may be
11761201misaligned.
11771202
1203+ Use | zP | /| zp | to paste a blockwise yanked register without appending trailing
1204+ spaces.
1205+
11781206Note that after a characterwise yank command, Vim leaves the cursor on the
11791207first yanked character that is closest to the start of the buffer. This means
11801208that "yl" doesn't move the cursor, but "yh" moves the cursor one character
@@ -1352,6 +1380,9 @@ The next three commands always work on whole lines.
13521380
13531381 *:t*
13541382:t Synonym for copy.
1383+ This command is not supported in | Vim9 | script,
1384+ because it is too easily confused with a variable
1385+ name.
13551386
13561387:[range] m[ove] {address} *:m* *:mo* *:move* *E134*
13571388 Move the lines given by [range] to below the line
@@ -1649,7 +1680,8 @@ r Automatically insert the current comment leader after hitting
16491680 <Enter> in Insert mode.
16501681 *fo-o*
16511682o Automatically insert the current comment leader after hitting 'o' or
1652- 'O' in Normal mode.
1683+ 'O' in Normal mode. In case comment is unwanted in a specific place
1684+ use CTRL-U to quickly delete it. | i_CTRL-U |
16531685 *fo-q*
16541686q Allow formatting of comments with "gq".
16551687 Note that formatting will not change blank lines or lines containing
0 commit comments