diff options
author | Bram Moolenaar <Bram@vim.org> | 2019-05-05 18:13:34 +0200 |
---|---|---|
committer | Bram Moolenaar <Bram@vim.org> | 2019-05-05 18:13:34 +0200 |
commit | 25c9c680ec4dfbb51f4ef21c3460a48d3c67ffc8 (patch) | |
tree | 0b70444195e194bf5c99df419361bc2052373c02 /runtime/doc/change.txt | |
parent | 9a061cb78ccbf78ec9ae454d37a49edccb4e94fc (diff) |
patch 8.1.1280: remarks about functionality not in Vi clutters the helpv8.1.1280
Problem: Remarks about functionality not in Vi clutters the help.
Solution: Move all info about what is new in Vim or already existed in Vi to
vi_diff.txt. Remove {not in Vi} remarks. (closes #4268) Add
"noet" to the help files modeline. Also include many other help
file improvements.
Diffstat (limited to 'runtime/doc/change.txt')
-rw-r--r-- | runtime/doc/change.txt | 140 |
1 files changed, 58 insertions, 82 deletions
diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 4c5b402a7e..a904aec387 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -1,4 +1,4 @@ -*change.txt* For Vim version 8.1. Last change: 2019 Feb 05 +*change.txt* For Vim version 8.1. Last change: 2019 May 05 VIM REFERENCE MANUAL by Bram Moolenaar @@ -34,7 +34,7 @@ For inserting text see |insert.txt|. deletes the last character of the count. See |:fixdel| if the <Del> key does not do what you want. See |'whichwrap'| for deleting a line break - (join lines). {Vi does not support <Del>} + (join lines). *X* *dh* ["x]X Delete [count] characters before the cursor [into @@ -59,7 +59,7 @@ For inserting text see |insert.txt|. {Visual}["x]x or *v_x* *v_d* *v_<Del>* {Visual}["x]d or {Visual}["x]<Del> Delete the highlighted text [into register x] (for - {Visual} see |Visual-mode|). {not in Vi} + {Visual} see |Visual-mode|). {Visual}["x]CTRL-H or *v_CTRL-H* *v_<BS>* {Visual}["x]<BS> When in Select mode: Delete the highlighted text [into @@ -69,7 +69,7 @@ For inserting text see |insert.txt|. {Visual}["x]D Delete the highlighted lines [into register x] (for {Visual} see |Visual-mode|). In Visual block mode, "D" deletes the highlighted text plus all text until - the end of the line. {not in Vi} + the end of the line. *:d* *:de* *:del* *:delete* *:dl* *:dp* :[range]d[elete] [x] Delete [range] lines (default: current line) [into @@ -116,16 +116,15 @@ J Join [count] lines, with a minimum of two lines. *v_J* {Visual}J Join the highlighted lines, with a minimum of two lines. Remove the indent and insert up to two spaces - (see below). {not in Vi} + (see below). *gJ* gJ Join [count] lines, with a minimum of two lines. - Don't insert or remove any spaces. {not in Vi} + Don't insert or remove any spaces. *v_gJ* {Visual}gJ Join the highlighted lines, with a minimum of two - lines. Don't insert or remove any spaces. {not in - Vi} + lines. Don't insert or remove any spaces. *:j* *:join* :[range]j[oin][!] [flags] @@ -134,7 +133,6 @@ gJ Join [count] lines, with a minimum of two lines. If a [range] has equal start and end values, this command does nothing. The default behavior is to join the current line with the line below it. - {not in Vi: !} See |ex-flags| for [flags]. :[range]j[oin][!] {count} [flags] @@ -142,7 +140,6 @@ gJ Join [count] lines, with a minimum of two lines. current line |cmdline-ranges|). Same as "J", except with [!] the join does not insert or delete any spaces. - {not in Vi: !} See |ex-flags| for [flags]. These commands delete the <EOL> between lines. This has the effect of joining @@ -209,8 +206,7 @@ gR Enter Virtual Replace mode: Each character you type {Visual}["x]c or *v_c* *v_s* {Visual}["x]s Delete the highlighted text [into register x] and - start insert (for {Visual} see |Visual-mode|). {not - in Vi} + start insert (for {Visual} see |Visual-mode|). *v_r* {Visual}["x]r{char} Replace all selected characters by {char}. @@ -218,14 +214,13 @@ gR Enter Virtual Replace mode: Each character you type *v_C* {Visual}["x]C Delete the highlighted lines [into register x] and start insert. In Visual block mode it works - differently |v_b_C|. {not in Vi} + differently |v_b_C|. *v_S* {Visual}["x]S Delete the highlighted lines [into register x] and - start insert (for {Visual} see |Visual-mode|). {not - in Vi} + start insert (for {Visual} see |Visual-mode|). *v_R* {Visual}["x]R Currently just like {Visual}["x]S. In a next version - it might work differently. {not in Vi} + it might work differently. Notes: - You can end Insert and Replace mode with <Esc>. @@ -322,21 +317,21 @@ The following commands change the case of letters. The currently active tilde cannot be used as an operator} *g~* -g~{motion} Switch case of {motion} text. {not in Vi} +g~{motion} Switch case of {motion} text. g~g~ *g~g~* *g~~* -g~~ Switch case of current line. {not in Vi}. +g~~ Switch case of current line. *v_~* {Visual}~ Switch case of highlighted text (for {Visual} see - |Visual-mode|). {not in Vi} + |Visual-mode|). *v_U* {Visual}U Make highlighted text uppercase (for {Visual} see - |Visual-mode|). {not in Vi} + |Visual-mode|). *gU* *uppercase* -gU{motion} Make {motion} text uppercase. {not in Vi} +gU{motion} Make {motion} text uppercase. Example: > :map! <C-F> <Esc>gUiw`]a < This works in Insert mode: press CTRL-F to make the @@ -345,27 +340,27 @@ gU{motion} Make {motion} text uppercase. {not in Vi} gUgU *gUgU* *gUU* -gUU Make current line uppercase. {not in Vi}. +gUU Make current line uppercase. *v_u* {Visual}u Make highlighted text lowercase (for {Visual} see - |Visual-mode|). {not in Vi} + |Visual-mode|). *gu* *lowercase* -gu{motion} Make {motion} text lowercase. {not in Vi} +gu{motion} Make {motion} text lowercase. gugu *gugu* *guu* -guu Make current line lowercase. {not in Vi}. +guu Make current line lowercase. *g?* *rot13* -g?{motion} Rot13 encode {motion} text. {not in Vi} +g?{motion} Rot13 encode {motion} text. *v_g?* {Visual}g? Rot13 encode the highlighted text (for {Visual} see - |Visual-mode|). {not in Vi} + |Visual-mode|). g?g? *g?g?* *g??* -g?? Rot13 encode current line. {not in Vi}. +g?? Rot13 encode current line. To turn one line into title caps, make every first letter of a word uppercase: > @@ -375,18 +370,18 @@ uppercase: > Adding and subtracting ~ *CTRL-A* CTRL-A Add [count] to the number or alphabetic character at - or after the cursor. {not in Vi} + or after the cursor. *v_CTRL-A* {Visual}CTRL-A Add [count] to the number or alphabetic character in - the highlighted text. {not in Vi} + the highlighted text. *v_g_CTRL-A* {Visual}g CTRL-A Add [count] to the number or alphabetic character in the highlighted text. If several lines are highlighted, each one will be incremented by an additional [count] (so effectively creating a - [count] incrementing sequence). {not in Vi} + [count] incrementing sequence). For Example, if you have this list of numbers: 1. ~ 1. ~ @@ -401,11 +396,11 @@ CTRL-A Add [count] to the number or alphabetic character at *CTRL-X* CTRL-X Subtract [count] from the number or alphabetic - character at or after the cursor. {not in Vi} + character at or after the cursor. *v_CTRL-X* {Visual}CTRL-X Subtract [count] from the number or alphabetic - character in the highlighted text. {not in Vi} + character in the highlighted text. On MS-Windows, this is mapped to cut Visual text |dos-standard-mappings|. If you want to disable the @@ -417,7 +412,7 @@ CTRL-X Subtract [count] from the number or alphabetic character in the highlighted text. If several lines are highlighted, each value will be decremented by an additional [count] (so effectively creating a [count] - decrementing sequence). {not in Vi} + decrementing sequence). The CTRL-A and CTRL-X commands can work for: - signed and unsigned decimal numbers @@ -485,8 +480,7 @@ SHIFTING LINES LEFT OR RIGHT *shift-left-right* *v_<* {Visual}[count]< Shift the highlighted lines [count] 'shiftwidth' - leftwards (for {Visual} see |Visual-mode|). {not in - Vi} + leftwards (for {Visual} see |Visual-mode|). *>* >{motion} Shift {motion} lines one 'shiftwidth' rightwards. @@ -500,8 +494,7 @@ SHIFTING LINES LEFT OR RIGHT *shift-left-right* *v_>* {Visual}[count]> Shift the highlighted lines [count] 'shiftwidth' - rightwards (for {Visual} see |Visual-mode|). {not in - Vi} + rightwards (for {Visual} see |Visual-mode|). *:<* :[range]< Shift [range] lines one 'shiftwidth' left. Repeat '<' @@ -512,7 +505,7 @@ SHIFTING LINES LEFT OR RIGHT *shift-left-right* Repeat '<' for shifting multiple 'shiftwidth's. :[range]le[ft] [indent] left align lines in [range]. Sets the indent in the - lines to [indent] (default 0). {not in Vi} + lines to [indent] (default 0). *:>* :[range]> [flags] Shift {count} [range] lines one 'shiftwidth' right. @@ -579,7 +572,6 @@ comment (starting with '"') after the `:!` command. *v_!* {Visual}!{filter} Filter the highlighted lines through the external program {filter} (for {Visual} see |Visual-mode|). - {not in Vi} :{range}![!]{filter} [!][arg] *:range!* Filter {range} lines through the external program @@ -613,7 +605,6 @@ comment (starting with '"') after the `:!` command. *v_=* {Visual}= Filter the highlighted lines like with ={motion}. - {not in Vi} *tempfile* *setuid* @@ -678,15 +669,13 @@ g& Synonym for `:%s//~/&` (repeat last substitute with For example, when you first do a substitution with `:s/pattern/repl/flags` and then `/search` for something else, `g&` will do `:%s/search/repl/flags`. - Mnemonic: global substitute. {not in Vi} + Mnemonic: global substitute. *:snomagic* *:sno* :[range]sno[magic] ... Same as `:substitute`, but always use 'nomagic'. - {not in Vi} *:smagic* *:sm* :[range]sm[agic] ... Same as `:substitute`, but always use 'magic'. - {not in Vi} *:s_flags* The flags that you can use for the substitute commands: @@ -697,7 +686,6 @@ The flags that you can use for the substitute commands: :&& :s/this/that/& < Note that `:s` and `:&` don't keep the flags. - {not in Vi} [c] Confirm each substitution. Vim highlights the matching string (with |hl-IncSearch|). You can type: *:s_c* @@ -705,16 +693,15 @@ The flags that you can use for the substitute commands: 'l' to substitute this match and then quit ("last") 'n' to skip this match <Esc> to quit substituting - 'a' to substitute this and all remaining matches {not in Vi} - 'q' to quit substituting {not in Vi} - CTRL-E to scroll the screen up {not in Vi, not available when - compiled without the |+insert_expand| feature} - CTRL-Y to scroll the screen down {not in Vi, not available when - compiled without the |+insert_expand| feature} + 'a' to substitute this and all remaining matches + 'q' to quit substituting + CTRL-E to scroll the screen up {not available when compiled + without the |+insert_expand| feature} + CTRL-Y to scroll the screen down {not available when compiled + without the |+insert_expand| feature} If the 'edcompatible' option is on, Vim remembers the [c] flag and toggles it each time you use it, but resets it when you give a new search pattern. - {not in Vi: highlighting of the match, other responses than 'y' or 'n'} *:s_e* [e] When the search pattern fails, do not issue an error message and, in @@ -726,7 +713,6 @@ The flags that you can use for the substitute commands: No previous substitute regular expression Trailing characters Interrupted - {not in Vi} *:s_g* [g] Replace all occurrences in the line. Without this argument, @@ -739,12 +725,10 @@ The flags that you can use for the substitute commands: *:s_i* [i] Ignore case for the pattern. The 'ignorecase' and 'smartcase' options are not used. - {not in Vi} *:s_I* [I] Don't ignore case for the pattern. The 'ignorecase' and 'smartcase' options are not used. - {not in Vi} *:s_n* [n] Report the number of matches, do not actually substitute. The [c] @@ -776,7 +760,6 @@ The flags that you can use for the substitute commands: /green :& < The last command will replace "blue" with "red". - {not in Vi} Note that there is no flag to change the "magicness" of the pattern. A different command is used instead, or you can use |/\v| and friends. The @@ -1002,7 +985,6 @@ This replaces each 'E' character with a euro sign. Read more in |<Char->|. a single tabstop. Each value in the list represents the width of one tabstop, except the final value which applies to all following tabstops. - {not in Vi} *retab-example* Example for using autocommands and ":retab" to edit a file which is stored @@ -1026,17 +1008,16 @@ inside of strings can change! Also see 'softtabstop' option. > :reg[isters] Display the contents of all numbered and named registers. If a register is written to for |:redir| it will not be listed. - {not in Vi} :reg[isters] {arg} Display the contents of the numbered and named registers that are mentioned in {arg}. For example: > :reg 1a < to display registers '1' and 'a'. Spaces are allowed - in {arg}. {not in Vi} + in {arg}. *:di* *:display* -:di[splay] [arg] Same as :registers. {not in Vi} +:di[splay] [arg] Same as :registers. *y* *yank* ["x]y{motion} Yank {motion} text [into register x]. When no @@ -1055,11 +1036,11 @@ inside of strings can change! Also see 'softtabstop' option. > *v_y* {Visual}["x]y Yank the highlighted text [into register x] (for - {Visual} see |Visual-mode|). {not in Vi} + {Visual} see |Visual-mode|). *v_Y* {Visual}["x]Y Yank the highlighted lines [into register x] (for - {Visual} see |Visual-mode|). {not in Vi} + {Visual} see |Visual-mode|). *:y* *:yank* *E850* :[range]y[ank] [x] Yank [range] lines [into register x]. Yanking to the @@ -1086,7 +1067,6 @@ inside of strings can change! Also see 'softtabstop' option. > Leaves the cursor at the end of the new text. Using the mouse only works when 'mouse' contains 'n' or 'a'. - {not in Vi} If you have a scrollwheel and often accidentally paste text, you can use these mappings to disable the pasting with the middle mouse button: > @@ -1097,11 +1077,11 @@ inside of strings can change! Also see 'softtabstop' option. > *gp* ["x]gp Just like "p", but leave the cursor just after the new - text. {not in Vi} + text. *gP* ["x]gP Just like "P", but leave the cursor just after the new - text. {not in Vi} + text. *:pu* *:put* :[line]pu[t] [x] Put the text [from register x] after [line] (default @@ -1129,14 +1109,14 @@ inside of strings can change! Also see 'softtabstop' option. > ["x]]p or *]p* *]<MiddleMouse>* ["x]]<MiddleMouse> Like "p", but adjust the indent to the current line. Using the mouse only works when 'mouse' contains 'n' - or 'a'. {not in Vi} + or 'a'. ["x][P or *[P* ["x]]P or *]P* ["x][p or *[p* *[<MiddleMouse>* ["x][<MiddleMouse> Like "P", but adjust the indent to the current line. Using the mouse only works when 'mouse' contains 'n' - or 'a'. {not in Vi} + or 'a'. You can use these commands to copy text from one place to another. Do this by first getting the text into a register with a yank, delete or change @@ -1246,7 +1226,6 @@ not exist} 3. Small delete register "- *quote_-* *quote-* This register contains text from commands that delete less than one line, except when the command specifies a register with ["x]. -{not in Vi} 4. Named registers "a to "z or "A to "Z *quote_alpha* *quotea* Vim fills these registers only when you say so. Specify them as lowercase @@ -1256,7 +1235,7 @@ a line break is inserted before the appended text. 5. Read-only registers ":, ". and "% These are '%', '#', ':' and '.'. You can use them only with the "p", "P", -and ":put" commands and with CTRL-R. {not in Vi} +and ":put" commands and with CTRL-R. *quote_.* *quote.* *E29* ". Contains the last inserted text (the same as what is inserted with the insert mode commands CTRL-A and CTRL-@). Note: this @@ -1310,13 +1289,13 @@ an error message (use string() to convert). If the "= register is used for the "p" command, the String is split up at <NL> characters. If the String ends in a <NL>, it is regarded as a linewise -register. {not in Vi} +register. 8. Selection and drop registers "*, "+ and "~ Use these registers for storing and retrieving the selected text for the GUI. See |quotestar| and |quoteplus|. When the clipboard is not available or not working, the unnamed register is used instead. For Unix systems the clipboard -is only available when the |+xterm_clipboard| feature is present. {not in Vi} +is only available when the |+xterm_clipboard| feature is present. Note that there is only a distinction between "* and "+ for X11 systems. For an explanation of the difference, see |x11-selection|. Under MS-Windows, use @@ -1327,7 +1306,7 @@ The read-only "~ register stores the dropped text from the last drag'n'drop operation. When something has been dropped onto Vim, the "~ register is filled in and the <Drop> pseudo key is sent for notification. You can remap this key if you want; the default action (for all modes) is to insert the -contents of the "~ register at the cursor position. {not in Vi} +contents of the "~ register at the cursor position. {only available when compiled with the |+dnd| feature, currently only with the GTK GUI} @@ -1337,7 +1316,7 @@ Drag'n'drop of URI lists is handled internally. 9. Black hole register "_ *quote_* When writing to this register, nothing happens. This can be used to delete text without affecting the normal registers. When reading from this register, -nothing is returned. {not in Vi} +nothing is returned. 10. Last search pattern register "/ *quote_/* *quote/* Contains the most recent search-pattern. This is used for "n" and 'hlsearch'. @@ -1346,7 +1325,6 @@ other matches without actually searching. You can't yank or delete into this register. The search direction is available in |v:searchforward|. Note that the value is restored when returning from a function |function-search-undo|. -{not in Vi} *@/* You can write to a register with a `:let` command |:let-@|. Example: > @@ -1377,17 +1355,15 @@ The next three commands always work on whole lines. :[range]ce[nter] [width] *:ce* *:center* Center lines in [range] between [width] columns (default 'textwidth' or 80 when 'textwidth' is 0). - {not in Vi} :[range]ri[ght] [width] *:ri* *:right* Right-align lines in [range] at [width] columns (default 'textwidth' or 80 when 'textwidth' is 0). - {not in Vi} *:le* *:left* :[range]le[ft] [indent] Left-align lines in [range]. Sets the indent in the - lines to [indent] (default 0). {not in Vi} + lines to [indent] (default 0). *gq* gq{motion} Format the lines that {motion} moves over. @@ -1414,24 +1390,24 @@ gq{motion} Format the lines that {motion} moves over. gqgq *gqgq* *gqq* gqq Format the current line. With a count format that - many lines. {not in Vi} + many lines. *v_gq* {Visual}gq Format the highlighted text. (for {Visual} see - |Visual-mode|). {not in Vi} + |Visual-mode|). *gw* gw{motion} Format the lines that {motion} moves over. Similar to |gq| but puts the cursor back at the same position in the text. However, 'formatprg' and 'formatexpr' are - not used. {not in Vi} + not used. gwgw *gwgw* *gww* -gww Format the current line as with "gw". {not in Vi} +gww Format the current line as with "gw". *v_gw* {Visual}gw Format the highlighted text as with "gw". (for - {Visual} see |Visual-mode|). {not in Vi} + {Visual} see |Visual-mode|). Example: To format the current paragraph use: *gqap* > gqap |