diff options
53 files changed, 635 insertions, 237 deletions
diff --git a/runtime/doc/autocmd.txt b/runtime/doc/autocmd.txt index 73506cc4c0..04f019174b 100644 --- a/runtime/doc/autocmd.txt +++ b/runtime/doc/autocmd.txt @@ -1,4 +1,4 @@ -*autocmd.txt* For Vim version 9.0. Last change: 2022 Dec 12 +*autocmd.txt* For Vim version 9.0. Last change: 2023 Feb 18 VIM REFERENCE MANUAL by Bram Moolenaar @@ -64,7 +64,7 @@ Example in Vim9 script: > In legacy script: > call autocmd_add(#{replace: v:true, \ group: 'DemoGroup', - \ event: 'BufEnter', + \ event: 'BufEnter', \ pattern: '*.txt', \ cmd: 'call DemoBufEnter()' \ }) @@ -398,7 +398,7 @@ Name triggered by ~ |InsertEnter| starting Insert mode |InsertChange| when typing <Insert> while in Insert or Replace mode |InsertLeave| when leaving Insert mode -|InsertLeavePre| just before leaving Insert mode +|InsertLeavePre| just before leaving Insert mode |InsertCharPre| when a character was typed in Insert mode, before inserting it @@ -611,9 +611,11 @@ CmdlineEnter After moving the cursor to the command line, where the user can type a command or search string; including non-interactive use of ":" in a mapping, but not when using |<Cmd>|. + The pattern is matched against the character + representing the type of command-line. + |cmdwin-char| <afile> is set to a single character, indicating the type of command-line. - |cmdwin-char| *CmdlineLeave* CmdlineLeave Before leaving the command line; including non-interactive use of ":" in a mapping, but diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index 8b0da25ecc..a065fcea2d 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 9.0. Last change: 2023 Jan 17 +*builtin.txt* For Vim version 9.0. Last change: 2023 Feb 14 VIM REFERENCE MANUAL by Bram Moolenaar @@ -266,7 +266,7 @@ gettabwinvar({tabnr}, {winnr}, {name} [, {def}]) gettagstack([{nr}]) Dict get the tag stack of window {nr} gettext({text}) String lookup translation of {text} getwininfo([{winid}]) List list of info about each window -getwinpos([{timeout}]) List X and Y coord in pixels of the Vim window +getwinpos([{timeout}]) List X and Y coord in pixels of Vim window getwinposx() Number X coord in pixels of the Vim window getwinposy() Number Y coord in pixels of the Vim window getwinvar({nr}, {varname} [, {def}]) @@ -382,7 +382,7 @@ matchstrpos({expr}, {pat} [, {start} [, {count}]]) max({expr}) Number maximum value of items in {expr} menu_info({name} [, {mode}]) Dict get menu item information min({expr}) Number minimum value of items in {expr} -mkdir({name} [, {path} [, {prot}]]) +mkdir({name} [, {flags} [, {prot}]]) Number create directory {name} mode([expr]) String current editing mode mzeval({expr}) any evaluate |MzScheme| expression @@ -6261,17 +6261,20 @@ min({expr}) Return the minimum value of all items in {expr}. Example: > mylist->min() < *mkdir()* *E739* -mkdir({name} [, {path} [, {prot}]]) +mkdir({name} [, {flags} [, {prot}]]) Create directory {name}. - If {path} contains "p" then intermediate directories are - created as necessary. Otherwise it must be "". + When {flags} is present it must be a string. An empty string + has no effect. - If {path} contains "D" then {name} is deleted at the end of + If {flags} contains "p" then intermediate directories are + created as necessary. + + If {flags} contains "D" then {name} is deleted at the end of the current function, as with: > defer delete({name}, 'd') < - If {path} contains "R" then {name} is deleted recursively at + If {flags} contains "R" then {name} is deleted recursively at the end of the current function, as with: > defer delete({name}, 'rf') < Note that when {name} has more than one part and "p" is used @@ -7958,7 +7961,7 @@ setcellwidths({list}) *setcellwidths()* terminal, counted in screen cells. The values override 'ambiwidth'. Example: > call setcellwidths([ - \ [0x111, 0x111, 1], + \ [0x111, 0x111, 1], \ [0x2194, 0x2199, 2], \ ]) @@ -7972,7 +7975,7 @@ setcellwidths({list}) *setcellwidths()* {width} must be either 1 or 2, indicating the character width in screen cells. *E1112* An error is given if the argument is invalid, also when a - range overlaps with another. *E1113* + range overlaps with another. *E1113* If the new value causes 'fillchars' or 'listchars' to become invalid it is rejected and an error is given. @@ -10551,7 +10554,7 @@ writefile({object}, {fname} [, {flags}]) < 'D' Delete the file when the current function ends. This works like: > - :defer delete({fname}) + :defer delete({fname}) < Fails when not in a function. Also see |:defer|. 's' fsync() is called after writing the file. This flushes diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 5811b8e593..85bacbb038 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -1842,9 +1842,9 @@ editing text paragraphs. A few hints on how to use this: - Set 'formatoptions' to "aw2tq" to make text with indents like this: - bla bla foobar bla + bla bla foobar bla bla foobar bla foobar bla - bla bla foobar bla + bla bla foobar bla bla foobar bla bla foobar - Add the 'c' flag to only auto-format comments. Useful in source code. diff --git a/runtime/doc/cmdline.txt b/runtime/doc/cmdline.txt index b30271e6f3..55b1a63a04 100644 --- a/runtime/doc/cmdline.txt +++ b/runtime/doc/cmdline.txt @@ -1,4 +1,4 @@ -*cmdline.txt* For Vim version 9.0. Last change: 2022 Nov 11 +*cmdline.txt* For Vim version 9.0. Last change: 2023 Feb 08 VIM REFERENCE MANUAL by Bram Moolenaar @@ -617,6 +617,7 @@ followed by another Vim command: :read ! :scscope :sign + :tabdo :tcl :tcldo :tclfile diff --git a/runtime/doc/diff.txt b/runtime/doc/diff.txt index 40167a1b59..216922ad17 100644 --- a/runtime/doc/diff.txt +++ b/runtime/doc/diff.txt @@ -181,7 +181,7 @@ possible to view the changes you have made to a buffer since the file was loaded. Since Vim doesn't allow having two buffers for the same file, you need another buffer. This command is useful: > command DiffOrig vert new | set bt=nofile | r ++edit # | 0d_ - \ | diffthis | wincmd p | diffthis + \ | diffthis | wincmd p | diffthis (this is in |defaults.vim|). Use ":DiffOrig" to see the differences between the current buffer and the file it was loaded from. diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index b133c5aa1a..bee0ad6cb7 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1372,7 +1372,7 @@ Note that the dot is also used for String concatenation. To avoid confusion always put spaces around the dot for String concatenation. -expr10(expr1, ...) |Funcref| function call *E1085* +expr10(expr1, ...) |Funcref| function call *E1085* When expr10 is a |Funcref| type variable, invoke the function it refers to. @@ -1654,7 +1654,7 @@ See below |functions|. lambda expression *expr-lambda* *lambda* ----------------- -{args -> expr1} legacy lambda expression *E451* +{args -> expr1} legacy lambda expression *E451* (args) => expr1 |Vim9| lambda expression A lambda expression creates a new unnamed function which returns the result of diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt index bf61e86e35..b8686a1893 100644 --- a/runtime/doc/filetype.txt +++ b/runtime/doc/filetype.txt @@ -1,4 +1,4 @@ -*filetype.txt* For Vim version 9.0. Last change: 2022 Apr 09 +*filetype.txt* For Vim version 9.0. Last change: 2023 Feb 15 VIM REFERENCE MANUAL by Bram Moolenaar @@ -679,7 +679,10 @@ MARKDOWN *ft-markdown-plugin* To enable folding use this: > let g:markdown_folding = 1 -< + +'expandtab' will be set by default. If you do not want that use this: > + let g:markdown_recommended_style = 0 + PDF *ft-pdf-plugin* diff --git a/runtime/doc/gui.txt b/runtime/doc/gui.txt index 668b4d4acd..17fa848c83 100644 --- a/runtime/doc/gui.txt +++ b/runtime/doc/gui.txt @@ -95,11 +95,11 @@ terminal version. Recommended place for your personal GUI initializations: Unix $HOME/.gvimrc or $HOME/.vim/gvimrc - Win32 $HOME/_gvimrc, $HOME/vimfiles/gvimrc + Win32 $HOME/_gvimrc, $HOME/vimfiles/gvimrc or $VIM/_gvimrc Amiga s:.gvimrc, home:.gvimrc, home:vimfiles:gvimrc or $VIM/.gvimrc - Haiku $HOME/config/settings/vim/gvimrc + Haiku $HOME/config/settings/vim/gvimrc The personal initialization files are searched in the order specified above and only the first one that is found is read. @@ -1181,7 +1181,7 @@ When 'guifont' is set and a valid font is found in it and 'guifontwide' is empty Vim will attempt to find a matching double-width font and set 'guifontwide' to it. -GTK+ GUI only: *guifontwide_gtk* +GTK+ GUI only: *guifontwide_gtk* If set and valid, 'guifontwide' is always used for double width characters, even if 'encoding' is not set to "utf-8". diff --git a/runtime/doc/gui_w32.txt b/runtime/doc/gui_w32.txt index 0cf012b104..d8ce03e514 100644 --- a/runtime/doc/gui_w32.txt +++ b/runtime/doc/gui_w32.txt @@ -17,7 +17,7 @@ Vim's Win32 Graphical User Interface *gui-w32* *win32-gui* Other relevant documentation: |gui.txt| For generic items of the GUI. -|os_win32.txt| For Win32 specific items. +|os_win32.txt| For Win32 specific items. ============================================================================== diff --git a/runtime/doc/helphelp.txt b/runtime/doc/helphelp.txt index 9ea6308069..2f1e3be6e7 100644 --- a/runtime/doc/helphelp.txt +++ b/runtime/doc/helphelp.txt @@ -101,7 +101,7 @@ Help on help files *helphelp* find a tag in a file with the same language as the current file. See |help-translated|. - *:helpc* *:helpclose* + *:helpc* *:helpclose* :helpc[lose] Close one help window, if there is one. Vim will try to restore the window layout (including cursor position) to the same layout it was before diff --git a/runtime/doc/if_pyth.txt b/runtime/doc/if_pyth.txt index 0cf2b0f56b..c2a0094b63 100644 --- a/runtime/doc/if_pyth.txt +++ b/runtime/doc/if_pyth.txt @@ -857,7 +857,7 @@ You can test what Python version is available with: > if has('python') echo 'there is Python 2.x' endif - if has('python3') + if has('python3') echo 'there is Python 3.x' endif @@ -874,7 +874,7 @@ python support: > echo 'Python 2.x dynamically loaded' endif endif - if has('python3_compiled') + if has('python3_compiled') echo 'compiled with Python 3.x support' if has('python3_dynamic') echo 'Python 3.x dynamically loaded' diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index c4363a89fc..a302c59fe9 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -236,7 +236,7 @@ tag char note action in Normal mode ~ |CTRL-\_CTRL-N| CTRL-\ CTRL-N go to Normal mode (no-op) |CTRL-\_CTRL-G| CTRL-\ CTRL-G go to mode specified with 'insertmode' CTRL-\ a - z reserved for extensions - CTRL-\ others not used + CTRL-\ others not used |CTRL-]| CTRL-] :ta to ident under cursor |CTRL-^| CTRL-^ edit Nth alternate file (equivalent to ":e #N") @@ -247,7 +247,7 @@ tag char note action in Normal mode ~ 2 filter Nmove text through the {filter} command |!!| !!{filter} 2 filter N lines through the {filter} command -|quote| "{register} use {register} for next delete, yank or put +|quote| "{register} use {register} for next delete, yank or put ({.%#:} only work with put) |#| # 1 search backward for the Nth occurrence of the ident under the cursor diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 0db0e41761..ccf5178a8a 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -877,7 +877,7 @@ Groß): > func Thesaur(findstart, base) if a:findstart - return searchpos('\<', 'bnW', line('.'))[1] - 1 + return searchpos('\<', 'bnW', line('.'))[1] - 1 endif let res = [] let h = '' @@ -1118,8 +1118,8 @@ cursor column will be replaced with the matches. If the returned value is larger than the cursor column, the cursor column is used. Negative return values: - -2 To cancel silently and stay in completion mode. - -3 To cancel silently and leave completion mode. + -2 To cancel silently and stay in completion mode. + -3 To cancel silently and leave completion mode. Another negative value: completion starts at the cursor column On the second invocation the arguments are: @@ -1176,7 +1176,7 @@ items: item with the same word is already present. empty when non-zero this match will be added even when it is an empty string - user_data custom data which is associated with the item and + user_data custom data which is associated with the item and available in |v:completed_item|; it can be any type; defaults to an empty string diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index c2eb76c5ff..ef3126193c 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1,4 +1,4 @@ -*map.txt* For Vim version 9.0. Last change: 2023 Jan 09 +*map.txt* For Vim version 9.0. Last change: 2023 Feb 18 VIM REFERENCE MANUAL by Bram Moolenaar @@ -845,7 +845,7 @@ option). After that it assumes that the 'q' is to be interpreted as such. If you type slowly, or your system is slow, reset the 'timeout' option. Then you might want to set the 'ttimeout' option. - *map-precedence* + *map-precedence* Buffer-local mappings (defined using |:map-<buffer>|) take precedence over global mappings. When a buffer-local mapping is the same as a global mapping, Vim will use the buffer-local mapping. In addition, Vim will use a complete @@ -923,6 +923,11 @@ in the original Vi, you would get back the text before the first undo). 1.10 MAPPING ALT-KEYS *:map-alt-keys* +For a readable mapping command the <A-k> form can be used. Note that <A-k> +and <A-K> are different, the latter will use an upper case letter. Actually, +<A-K> and <A-S-K> are the same. Instead of "A" you can use "M". If you have +an actual Meta modifier key, please see |:map-meta-keys|. + In the GUI Vim handles the Alt key itself, thus mapping keys with ALT should always work. But in a terminal Vim gets a sequence of bytes and has to figure out whether ALT was pressed or not. @@ -1028,7 +1033,7 @@ enabled when it spots an escape sequence that must have been created by it. To see if Vim detected such an escape sequence use `:verbose map`, the first line will then show "Seen modifyOtherKeys: true" (possibly translated). -This automatic detection depends on receiving an escape code starting with +This automatic detection depends on receiving an escape code starting with "<1b>[27;". This is the normal way xterm sends these key codes. However, if the *formatOtherKeys* resource is set another form is used that is not recognized, therefore you must not set formatOtherKeys. @@ -1069,7 +1074,7 @@ translated). The meaning of {value}: Disabled protocol was used but expected to have been disabled by 't_TE' Cleared protocol expected to have beeen disabled by 't_TE', - previous state is unknown + previous state is unknown 1.14 MAPPING AN OPERATOR *:map-operator* @@ -1212,7 +1217,7 @@ non-id The "non-id" type ends in a non-keyword character, the other Examples of strings that cannot be abbreviations: "a.b", "#def", "a b", "_$r" An abbreviation is only recognized when you type a non-keyword character. -This can also be the <Esc> that ends insert mode or the <CR> that ends a +This can also be the <Esc> that ends Insert mode or the <CR> that ends a command. The non-keyword character which ends the abbreviation is inserted after the expanded abbreviation. An exception to this is the character <C-]>, which is used to expand an abbreviation without inserting any extra @@ -1723,7 +1728,7 @@ by default correspond to the current line, last line and the whole buffer, relate to arguments, (loaded) buffers, windows or tab pages. Possible values are (second column is the short name used in listing): - -addr=lines Range of lines (this is the default for -range) + -addr=lines Range of lines (this is the default for -range) -addr=arguments arg Range for arguments -addr=buffers buf Range for buffers (also not loaded buffers) -addr=loaded_buffers load Range for loaded buffers diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 3d1f2ff8d2..4f0ac45f45 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 9.0. Last change: 2023 Feb 01 +*options.txt* For Vim version 9.0. Last change: 2023 Feb 17 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1547,7 +1547,7 @@ A jump table for the options with a short description can be found at |Q_op|. case mapping, the current locale is not effective. This probably only matters for Turkish. - *'cdhome'* *'cdh'* + *'cdhome'* *'cdh'* *'nocdhome'* *'nocdh'* 'cdhome' 'cdh' boolean (default: off) global When on, |:cd|, |:tcd| and |:lcd| without an argument changes the @@ -4911,7 +4911,7 @@ A jump table for the options with a short description can be found at |Q_op|. < This means that when 'term' contains "kitty, "foot" or "wezterm" somewhere then the "kitty" protocol is used. When 'term' contains - "xterm" somewhere, then the "mok2" protocol is used. + "xterm" somewhere, then the "mok2" protocol is used. The first match is used, thus if you want to have "kitty" use the kitty protocol, but "badkitty" not, then you should match "badkitty" @@ -5665,7 +5665,7 @@ A jump table for the options with a short description can be found at |Q_op|. The 'mousemodel' option is set by the |:behave| command. - *'mousemoveevent'* *'mousemev'* + *'mousemoveevent'* *'mousemev'* *'nomousemoveevent'* *'nomousemev'* 'mousemoveevent' 'mousemev' boolean (default off) global {only works in the GUI} @@ -7157,7 +7157,7 @@ A jump table for the options with a short description can be found at |Q_op|. A don't give the "ATTENTION" message when an existing *shm-A* swap file is found I don't give the intro message when starting Vim, *shm-I* - see |:intro| + see |:intro| c don't give |ins-completion-menu| messages; for *shm-c* example, "-- XXX completion (YYY)", "match 1 of 2", "The only match", "Pattern not found", "Back at original", etc. @@ -7167,8 +7167,8 @@ A jump table for the options with a short description can be found at |Q_op|. F don't give the file info when editing a file, like *shm-F* `:silent` was used for the command; note that this also affects messages from autocommands - S do not show search count message when searching, e.g. *shm-S* - "[1/5]" + S do not show search count message when searching, e.g. *shm-S* + "[1/5]" This gives you the opportunity to avoid that a change between buffers requires you to hit <Enter>, but still gives as useful a message as @@ -7345,9 +7345,9 @@ A jump table for the options with a short description can be found at |Q_op|. {not available when compiled without the |+signs| feature} Whether or not to draw the signcolumn. Valid values are: - "auto" only when there is a sign to display - "no" never - "yes" always + "auto" only when there is a sign to display + "no" never + "yes" always "number" display signs in the 'number' column. If the number column is not present, then behaves like "auto". @@ -8234,7 +8234,7 @@ A jump table for the options with a short description can be found at |Q_op|. :set encoding=utf-8 < You need to do this when your system has no locale support for UTF-8. - *'termguicolors'* *'tgc'* *E954* + *'termguicolors'* *'tgc'* *'notermguicolors'* *'notgc'* *E954* 'termguicolors' 'tgc' boolean (default off) global {not available when compiled without the diff --git a/runtime/doc/os_390.txt b/runtime/doc/os_390.txt index 8dce4a56e0..42c8a8b51b 100644 --- a/runtime/doc/os_390.txt +++ b/runtime/doc/os_390.txt @@ -10,7 +10,7 @@ This file contains the particulars for the z/OS UNIX version of Vim. 2. Putty and Colors |zOS-PuTTY| 3. Motif Problems |zOS-Motif| 4. Bugs |zOS-Bugs| -5. Limitations |zOS-limitations| +5. Limitations |zOS-limitations| 6. Open source on z/OS UNIX |zOS-open-source| Contributors: ~ @@ -75,7 +75,7 @@ There is no solution for this yet. this occurs in both the terminal and gui versions. ============================================================================== -5. Limitations *OS390-limitations* *zOS-limitations* +5. Limitations *OS390-limitations* *zOS-limitations* - No binary search in tag files. The program /bin/sort sorts by ASCII value by default. This program is diff --git a/runtime/doc/os_vms.txt b/runtime/doc/os_vms.txt index 619f4e409e..54eb63cad1 100644 --- a/runtime/doc/os_vms.txt +++ b/runtime/doc/os_vms.txt @@ -203,7 +203,7 @@ You can check that everything is at the right place with the :version command. Example LOGIN.COM: > - $ define/nolog VIM DKA0:[UTIL.VIM81] + $ define/nolog VIM DKA0:[UTIL.VIM81] $ vi*m :== mcr VIM:VIM.EXE $ gv*im:== spawn/nowait/input=NLA0 mcr VIM:VIM.EXE -g -GEOMETRY 80x40 $ set disp/create/node=192.168.10.202/trans=tcpip diff --git a/runtime/doc/pattern.txt b/runtime/doc/pattern.txt index a9452c5c3f..9e048ff64a 100644 --- a/runtime/doc/pattern.txt +++ b/runtime/doc/pattern.txt @@ -1,4 +1,4 @@ -*pattern.txt* For Vim version 9.0. Last change: 2022 Sep 24 +*pattern.txt* For Vim version 9.0. Last change: 2023 Feb 04 VIM REFERENCE MANUAL by Bram Moolenaar @@ -101,6 +101,8 @@ g# Like "#", but don't put "\<" and "\>" around the word. *gd* gd Goto local Declaration. When the cursor is on a local variable, this command will jump to its declaration. + This was made to work for C code, in other languages + it may not work well. First Vim searches for the start of the current function, just like "[[". If it is not found the search stops in line 1. If it is found, Vim goes back @@ -1142,21 +1144,21 @@ x A single character, with no special meaning, matches itself are supported: Name Func Contents ~ *[:alnum:]* [:alnum:] isalnum ASCII letters and digits -*[:alpha:]* [:alpha:] isalpha ASCII letters -*[:blank:]* [:blank:] space and tab -*[:cntrl:]* [:cntrl:] iscntrl ASCII control characters -*[:digit:]* [:digit:] decimal digits '0' to '9' +*[:alpha:]* [:alpha:] isalpha ASCII letters +*[:blank:]* [:blank:] space and tab +*[:cntrl:]* [:cntrl:] iscntrl ASCII control characters +*[:digit:]* [:digit:] decimal digits '0' to '9' *[:graph:]* [:graph:] isgraph ASCII printable characters excluding space *[:lower:]* [:lower:] (1) lowercase letters (all letters when 'ignorecase' is used) -*[:print:]* [:print:] (2) printable characters including space +*[:print:]* [:print:] (2) printable characters including space |