Update runtime files
diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index c18df8a..786f9de 100644
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt* For Vim version 8.2. Last change: 2021 Dec 28
+*builtin.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2435,7 +2435,7 @@
For each item in {expr1} evaluate {expr2} and when the result
is zero or false remove the item from the |List| or
|Dictionary|. Similarly for each byte in a |Blob| and each
- charactor in a |String|.
+ character in a |String|.
{expr2} must be a |string| or |Funcref|.
@@ -2466,7 +2466,9 @@
return a:idx % 2 == 1
endfunc
call filter(mylist, function('Odd'))
-< It is shorter when using a |lambda|: >
+< It is shorter when using a |lambda|. In |Vim9| syntax: >
+ call filter(myList, (idx, val) => idx * val <= 42)
+< In legacy script syntax: >
call filter(myList, {idx, val -> idx * val <= 42})
< If you do not use "val" you can leave it out: >
call filter(myList, {idx -> idx % 2 == 1})
@@ -2744,8 +2746,10 @@
function {name} is redefined later.
Unlike |function()|, {name} must be an existing user function.
- Also for autoloaded functions. {name} cannot be a builtin
- function.
+ It only works for an autoloaded function if it has already
+ been loaded (to avoid mistakenly loading the autoload script
+ when only intending to use the function name, use |function()|
+ instead). {name} cannot be a builtin function.
Can also be used as a |method|: >
GetFuncname()->funcref([arg])
@@ -4738,7 +4742,7 @@
Can also be used as a |method|: >
GetObject()->js_encode()
-json_decode({string}) *json_decode()*
+json_decode({string}) *json_decode()* *E491*
This parses a JSON formatted string and returns the equivalent
in Vim values. See |json_encode()| for the relation between
JSON and Vim values.
@@ -5380,7 +5384,7 @@
GetText()->match('word')
GetList()->match('word')
<
- *matchadd()* *E798* *E799* *E801* *E957*
+ *matchadd()* *E290* *E798* *E799* *E801* *E957*
matchadd({group}, {pattern} [, {priority} [, {id} [, {dict}]]])
Defines a pattern to be highlighted in the current window (a
"match"). It will be highlighted with {group}. Returns an
@@ -8130,7 +8134,8 @@
< Can also be used as a |method|: >
GetSoundPath()->sound_playfile()
-< {only available when compiled with the |+sound| feature}
+< There is no error *E538* , but can listen to 538.nl.
+ {only available when compiled with the |+sound| feature}
sound_stop({id}) *sound_stop()*
diff --git a/runtime/doc/cmdline.txt b/runtime/doc/cmdline.txt
index 1d81220..c68c161 100644
--- a/runtime/doc/cmdline.txt
+++ b/runtime/doc/cmdline.txt
@@ -1,4 +1,4 @@
-*cmdline.txt* For Vim version 8.2. Last change: 2021 Dec 26
+*cmdline.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -748,7 +748,8 @@
Each may be followed (several times) by '+' or '-' and an optional number.
This number is added or subtracted from the preceding line number. If the
-number is omitted, 1 is used.
+number is omitted, 1 is used. If there is nothing before the '+' or '-' then
+the current line is used.
The "/" and "?" after {pattern} are required to separate the pattern from
anything that follows.
@@ -778,7 +779,7 @@
number of lines to be used, starting with the line given in the last line
specifier (the default is the cursor line). The commands that accept a count
are the ones that use a range but do not have a file name argument (because
-a file name can also be a number).
+a file name can also be a number). The count cannot be negative.
Examples: >
:s/x/X/g 5 substitute 'x' by 'X' in the current line and four
@@ -949,6 +950,7 @@
and "script {file-name}[{lnum}]" for a script line, and
".." in between items. E.g.:
"function {function-name1}[{lnum}]..{function-name2}[{lnum}]"
+ If there is no call stack you get error *E489* .
*:<slnum>* *<slnum>*
<slnum> When executing a ":source" command, is replaced with the
line number. *E842*
diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index d6161b1..ebb78b0 100644
--- a/runtime/doc/editing.txt
+++ b/runtime/doc/editing.txt
@@ -1770,7 +1770,7 @@
/u/user_x/work/include
/u/user_x/include
-< Note: If your 'path' setting includes an non-existing directory, Vim will
+< Note: If your 'path' setting includes a non-existing directory, Vim will
skip the non-existing directory, but continues searching in the parent of
the non-existing directory if upwards searching is used. E.g. when
searching "../include" and that doesn't exist, and upward searching is
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index dca886e..974f231 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt* For Vim version 8.2. Last change: 2021 Dec 28
+*eval.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -13,9 +13,9 @@
|no-eval-feature|.
This file is mainly about the backwards compatible (legacy) Vim script. For
-specifics of Vim9 script, which executes much faster, supports type checking
-and much more, see |vim9.txt|. Where the syntax or semantics differ a remark
-is given.
+specifics of Vim9 script, which can execute much faster, supports type
+checking and much more, see |vim9.txt|. Where the syntax or semantics differ
+a remark is given.
1. Variables |variables|
1.1 Variable types
@@ -162,8 +162,8 @@
Note that " " and "0" are also non-empty strings, thus considered to be TRUE.
A List, Dictionary or Float is not a Number or String, thus evaluate to FALSE.
- *E745* *E728* *E703* *E729* *E730* *E731* *E908* *E910* *E913*
- *E974* *E975* *E976*
+ *E611* *E745* *E728* *E703* *E729* *E730* *E731* *E908* *E910*
+ *E913* *E974* *E975* *E976*
|List|, |Dictionary|, |Funcref|, |Job|, |Channel| and |Blob| types are not
automatically converted.
@@ -172,7 +172,7 @@
there is no automatic conversion of Float. You can use str2float() for String
to Float, printf() for Float to String and float2nr() for Float to Number.
- *E891* *E892* *E893* *E894* *E907* *E911* *E914*
+ *E362* *E891* *E892* *E893* *E894* *E907* *E911* *E914*
When expecting a Float a Number can also be used, but nothing else.
*no-type-checking*
@@ -1346,7 +1346,7 @@
expr9->name([args]) method call *method* *->*
expr9->{lambda}([args])
- *E276*
+ *E260* *E276*
For methods that are also available as global functions this is the same as: >
name(expr9 [, args])
There can also be methods specifically for the type of "expr9".
@@ -1582,7 +1582,7 @@
lambda expression *expr-lambda* *lambda*
-----------------
-{args -> expr1} legacy lambda expression
+{args -> expr1} legacy lambda expression *E451*
(args) => expr1 |Vim9| lambda expression
A lambda expression creates a new unnamed function which returns the result of
@@ -1659,10 +1659,10 @@
3. Internal variable *internal-variables* *E461*
An internal variable name can be made up of letters, digits and '_'. But it
-cannot start with a digit. In legacy script it also possible to use curly
+cannot start with a digit. In legacy script it is also possible to use curly
braces, see |curly-braces-names|.
-In legacy script ann internal variable is created with the ":let" command
+In legacy script an internal variable is created with the ":let" command
|:let|. An internal variable is explicitly destroyed with the ":unlet"
command |:unlet|.
Using a name that is not an internal variable or refers to a variable that has
@@ -2162,7 +2162,8 @@
|sandbox|.
*v:maxcol* *maxcol-variable*
-v:maxcol Maximum line length.
+v:maxcol Maximum line length. Depending on where it is used it can be
+ screen columns, characters or bytes.
*v:mouse_win* *mouse_win-variable*
v:mouse_win Window number for a mouse click obtained with |getchar()|.
@@ -2573,7 +2574,7 @@
In |Vim9| script functions are local to the script by default, prefix "g:" to
define a global function.
- *:fu* *:function* *E128* *E129* *E123*
+ *:fu* *:function* *E128* *E129* *E123* *E454*
:fu[nction] List all functions and their arguments.
:fu[nction] {name} List function {name}.
@@ -2699,7 +2700,7 @@
command, use line breaks instead of |:bar|: >
:exe "func Foo()\necho 'foo'\nendfunc"
<
- *:delf* *:delfunction* *E130* *E131* *E933*
+ *:delf* *:delfunction* *E131* *E933*
:delf[unction][!] {name}
Delete function {name}.
{name} can also be a |Dictionary| entry that is a
@@ -4946,7 +4947,7 @@
silently ignored, and the command is executed.
==============================================================================
-12. The sandbox *eval-sandbox* *sandbox* *E48*
+12. The sandbox *eval-sandbox* *sandbox*
The 'foldexpr', 'formatexpr', 'includeexpr', 'indentexpr', 'statusline' and
'foldtext' options may be evaluated in a sandbox. This means that you are
@@ -4954,7 +4955,7 @@
safety for when these options are set from a modeline. It is also used when
the command from a tags file is executed and for CTRL-R = in the command line.
The sandbox is also used for the |:sandbox| command.
-
+ *E48*
These items are not allowed in the sandbox:
- changing the buffer text
- defining or changing mapping, autocommands, user commands
diff --git a/runtime/doc/helphelp.txt b/runtime/doc/helphelp.txt
index 357a64e..d01b3da 100644
--- a/runtime/doc/helphelp.txt
+++ b/runtime/doc/helphelp.txt
@@ -1,4 +1,4 @@
-*helphelp.txt* For Vim version 8.2. Last change: 2021 Dec 13
+*helphelp.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -224,7 +224,7 @@
dialog. {only when compiled with |+GUI_GTK|}
*:helpt* *:helptags*
- *E154* *E150* *E151* *E152* *E153* *E670*
+ *E150* *E151* *E152* *E153* *E154* *E670*
:helpt[ags] [++t] {dir}
Generate the help tags file(s) for directory {dir}.
When {dir} is ALL then all "doc" directories in
diff --git a/runtime/doc/if_cscop.txt b/runtime/doc/if_cscop.txt
index aa6512a..ea84869 100644
--- a/runtime/doc/if_cscop.txt
+++ b/runtime/doc/if_cscop.txt
@@ -1,4 +1,4 @@
-*if_cscop.txt* For Vim version 8.2. Last change: 2019 May 05
+*if_cscop.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Andy Kahn
@@ -89,7 +89,7 @@
==============================================================================
2. Cscope related commands *cscope-commands*
- *:cscope* *:cs* *:scs* *:scscope* *E259* *E262* *E561* *E560*
+ *:cscope* *:cs* *:scs* *:scscope* *E259* *E262* *E560* *E561*
All cscope commands are accessed through suboptions to the cscope commands.
`:cscope` or `:cs` is the main command
`:scscope` or `:scs` does the same and splits the window
diff --git a/runtime/doc/if_perl.txt b/runtime/doc/if_perl.txt
index b0bad1e..a85b680 100644
--- a/runtime/doc/if_perl.txt
+++ b/runtime/doc/if_perl.txt
@@ -1,4 +1,4 @@
-*if_perl.txt* For Vim version 8.2. Last change: 2019 Dec 07
+*if_perl.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Sven Verdoolaege
@@ -104,7 +104,6 @@
:perl VIM::Msg("hello")
:perl $line = $curbuf->Get(42)
<
- *E299*
Executing Perl commands in the |sandbox| is limited. ":perldo" will not be
possible at all. ":perl" will be evaluated in the Safe environment, if
possible.
diff --git a/runtime/doc/if_tcl.txt b/runtime/doc/if_tcl.txt
index 88ab119..99301f3 100644
--- a/runtime/doc/if_tcl.txt
+++ b/runtime/doc/if_tcl.txt
@@ -1,4 +1,4 @@
-*if_tcl.txt* For Vim version 8.2. Last change: 2021 May 27
+*if_tcl.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Ingo Wilken
@@ -16,9 +16,9 @@
8. Examples |tcl-examples|
9. Dynamic loading |tcl-dynamic|
-*E280*
{only available when Vim was compiled with the |+tcl| feature}
+ *E280*
WARNING: There are probably still some bugs. Please send bug reports,
comments, ideas etc to <Ingo.Wilken@informatik.uni-oldenburg.de>
diff --git a/runtime/doc/indent.txt b/runtime/doc/indent.txt
index 87bbd48..d82f742 100644
--- a/runtime/doc/indent.txt
+++ b/runtime/doc/indent.txt
@@ -879,7 +879,7 @@
*PHP_outdentphpescape*
To indent PHP escape tags as the surrounding non-PHP code (only affects the
PHP escape tags): >
-:let g:PHP_outdentphpescape = 0
+ :let g:PHP_outdentphpescape = 0
-------------
*PHP_removeCRwhenUnix*
@@ -1206,7 +1206,7 @@
VIM *ft-vim-indent*
-
+ *g:vim_indent_cont*
For indenting Vim scripts there is one variable that specifies the amount of
indent for a continuation line, a line that starts with a backslash: >
diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index 3751f27..acc7865 100644
--- a/runtime/doc/insert.txt
+++ b/runtime/doc/insert.txt
@@ -850,7 +850,7 @@
For an example, imagine the 'thesaurus' file has a line like this: >
angry furious mad enraged
-<Placing the cursor after the letters "ang" and typing CTRL-X CTRL-T would
+Placing the cursor after the letters "ang" and typing CTRL-X CTRL-T would
complete the word "angry"; subsequent presses would change the word to
"furious", "mad" etc.
@@ -862,7 +862,7 @@
Unpack thesaurus_pkg.zip, put the thesaurus.txt file somewhere, e.g.
~/.vim/thesaurus/english.txt, and the 'thesaurus' option to this file name.
-
+
Completing keywords with 'thesaurusfunc' *compl-thesaurusfunc*
If the 'thesaurusfunc' option is set, then the user specified function is
diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt
index 479f447..e87d430 100644
--- a/runtime/doc/map.txt
+++ b/runtime/doc/map.txt
@@ -1,4 +1,4 @@
-*map.txt* For Vim version 8.2. Last change: 2021 Dec 24
+*map.txt* For Vim version 8.2. Last change: 2022 Jan 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -6,7 +6,7 @@
Key mapping, abbreviations and user-defined commands.
-This subject is introduced in sections |05.3|, |24.7| and |40.1| of the user
+This subject is introduced in sections |05.4|, |24.7| and |40.1| of the user
manual.
1. Key mapping |key-mapping|
@@ -97,8 +97,7 @@
map command applies. The mapping may remain defined
for other modes where it applies.
It also works when {lhs} matches the {rhs} of a
- mapping. This is for when when an abbreviation
- applied.
+ mapping. This is for when an abbreviation applied.
Note: Trailing spaces are included in the {lhs}. This
unmap does NOT work: >
:map @@ foo
diff --git a/runtime/doc/mbyte.txt b/runtime/doc/mbyte.txt
index 08c3ac1..4747d48 100644
--- a/runtime/doc/mbyte.txt
+++ b/runtime/doc/mbyte.txt
@@ -1,4 +1,4 @@
-*mbyte.txt* For Vim version 8.2. Last change: 2021 Oct 04
+*mbyte.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar et al.
@@ -862,8 +862,8 @@
window specific to the input method.
-USING XIM *multibyte-input* *E284* *E286* *E287* *E288*
- *E285* *E289*
+USING XIM *multibyte-input* *E284* *E285* *E286* *E287*
+ *E288* *E289*
Note that Display and Input are independent. It is possible to see your
language even though you have no input method for it. But when your Display
diff --git a/runtime/doc/message.txt b/runtime/doc/message.txt
index 1690e41..f174884 100644
--- a/runtime/doc/message.txt
+++ b/runtime/doc/message.txt
@@ -1,4 +1,4 @@
-*message.txt* For Vim version 8.2. Last change: 2021 Dec 13
+*message.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -118,7 +118,8 @@
*E95* >
Buffer with this name already exists
-You cannot have two buffers with the same name.
+You cannot have two buffers with exactly the same name. This includes the
+path leading to the file.
*E72* >
Close error on swap file
@@ -534,10 +535,10 @@
*E22* >
Scripts nested too deep
-Scripts can be read with the "-s" command-line argument and with the ":source"
-command. The script can then again read another script. This can continue
-for about 14 levels. When more nesting is done, Vim assumes that there is a
-recursive loop somewhere and stops with this error message.
+Scripts can be read with the "-s" command-line argument and with the
+`:source!` command. The script can then again read another script. This can
+continue for about 14 levels. When more nesting is done, Vim assumes that
+there is a recursive loop and stops with this error message.
*E319* >
Sorry, the command is not available in this version
@@ -727,6 +728,7 @@
Trailing characters
An argument has been added to an Ex command that does not permit one.
+Or the argument has invalid characters and has not been recognized.
*E477* *E478* >
No ! allowed
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 1967167..c7fbde6 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt* For Vim version 8.2. Last change: 2021 Dec 26
+*options.txt* For Vim version 8.2. Last change: 2022 Jan 02
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -369,7 +369,7 @@
This will make the local value of 'path' empty, so that the global value is
used. Thus it does the same as: >
:setlocal path=
-Note: In the future more global options can be made global-local. Using
+Note: In the future more global options can be made |global-local|. Using
":setlocal" on a global option might work differently then.
@@ -877,11 +877,11 @@
global
Write the contents of the file, if it has been modified, on each
`:next`, `:rewind`, `:last`, `:first`, `:previous`, `:stop`,
- `:suspend`, `:tag, `:!`, ``:make`, CTRL-] and CTRL-^ command; and when
- a :buffer, CTRL-O, CTRL-I, '{A-Z0-9}, or `{A-Z0-9} command takes one
+ `:suspend`, `:tag`, `:!`, `:make`, CTRL-] and CTRL-^ command; and when
+ a `:buffer`, CTRL-O, CTRL-I, '{A-Z0-9}, or `{A-Z0-9} command takes one
to another file.
A buffer is not written if it becomes hidden, e.g. when 'bufhidden' is
- set to "hide" and `:next` is used
+ set to "hide" and `:next` is used.
Note that for some commands the 'autowrite' option is not used, see
'autowriteall' for that.
Some buffers will not be written, specifically when 'buftype' is
@@ -6684,6 +6684,8 @@
Don't include both "curdir" and "sesdir".
When neither "curdir" nor "sesdir" is included, file names are stored
with absolute paths.
+ If you leave out "options" many things won't work well after restoring
+ the session.
"slash" and "unix" are useful on Windows when sharing session files
with Unix. The Unix version of Vim cannot source dos format scripts,
but the Windows version of Vim can source unix format scripts.
@@ -8126,7 +8128,7 @@
another default. Backticks cannot be used in this option for security
reasons.
- *'thesaurusfunc'* *tsrfu'*
+ *'thesaurusfunc'* *'tsrfu'*
'thesaurusfunc' 'tsrfu' string (default: empty)
global or local to buffer |global-local|
{not available when compiled without the |+eval|
diff --git a/runtime/doc/os_dos.txt b/runtime/doc/os_dos.txt
index b473134..b315be8 100644
--- a/runtime/doc/os_dos.txt
+++ b/runtime/doc/os_dos.txt
@@ -342,12 +342,12 @@
See |option-backslash| about including spaces in 'shellcmdflag' when using
multiple flags.
-The 'shellpipe' and 'shellredir' option values re-encode the UTF-16le output
+The 'shellpipe' and 'shellredir' option values re-encode the UTF-16LE output
from PowerShell Desktop to your currently configured console codepage. The
output can be forced into a different encoding by changing "default" to one of
the following:
- unicode - UTF-16le (default output from PowerShell 5.1)
+ unicode - UTF-16LE (default output from PowerShell 5.1)
bigendianunicode - UTF-16
utf8 - UTF-8
utf7 - UTF-7 (no BOM)
@@ -356,7 +356,7 @@
default - System's active code page (typically ANSI)
oem - System's current OEM code page
-Note The abovce multi-byte Unicode encodings include a leading BOM unless
+Note The above multi-byte Unicode encodings include a leading BOM unless
otherwise indicated.
By default PowerShell Core's output is UTF-8 encoded without a BOM. If you
@@ -365,10 +365,10 @@
encoding is one of the following:
ascii - 7-bit ASCII character set
- bigendianunicode - UTF-16be
- bigendianutf32 - UTF-32be
+ bigendianunicode - UTF-16BE
+ bigendianutf32 - UTF-32BE
oem - System's current OEM code page
- unicode - UTF-16le
+ unicode - UTF-16LE
utf7 - UTF-7
utf8 - UTF-8
utf8BOM - UTF-8, with BOM
diff --git a/runtime/doc/pattern.txt b/runtime/doc/pattern.txt
index 8f6d77e..ce1d0f4 100644
--- a/runtime/doc/pattern.txt
+++ b/runtime/doc/pattern.txt
@@ -1,4 +1,4 @@
-*pattern.txt* For Vim version 8.2. Last change: 2021 Jul 16
+*pattern.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -315,7 +315,7 @@
==============================================================================
2. The definition of a pattern *search-pattern* *pattern* *[pattern]*
*regular-expression* *regexp* *Pattern*
- *E76* *E383* *E476*
+ *E383* *E476*
For starters, read chapter 27 of the user manual |usr_27.txt|.
@@ -929,9 +929,9 @@
\%23l Matches in a specific line.
\%<23l Matches above a specific line (lower line number).
\%>23l Matches below a specific line (higher line number).
-\%.l Matches at the cursor line.
-\%<.l Matches above the cursor line.
-\%>.l Matches below the cursor line.
+\%.l Matches at the cursor line.
+\%<.l Matches above the cursor line.
+\%>.l Matches below the cursor line.
These six can be used to match specific lines in a buffer. The "23"
can be any line number. The first line is 1.
WARNING: When inserting or deleting lines Vim does not automatically
@@ -950,9 +950,9 @@
\%23c Matches in a specific column.
\%<23c Matches before a specific column.
\%>23c Matches after a specific column.
-\%.c Matches at the cursor column.
-\%<.c Matches before the cursor column.
-\%>.c Matches after the cursor column.
+\%.c Matches at the cursor column.
+\%<.c Matches before the cursor column.
+\%>.c Matches after the cursor column.
These six can be used to match specific columns in a buffer or string.
The "23" can be any column number. The first column is 1. Actually,
the column is the byte number (thus it's not exactly right for
@@ -976,9 +976,9 @@
\%23v Matches in a specific virtual column.
\%<23v Matches before a specific virtual column.
\%>23v Matches after a specific virtual column.
-\%.v Matches at the current virtual column.
-\%<.v Matches before the current virtual column.
-\%>.v Matches after the current virtual column.
+\%.v Matches at the current virtual column.
+\%<.v Matches before the current virtual column.
+\%>.v Matches after the current virtual column.
These six can be used to match specific virtual columns in a buffer or
string. When not matching with a buffer in a window, the option
values of the current window are used (e.g., 'tabstop').
@@ -1070,6 +1070,8 @@
\(\) A pattern enclosed by escaped parentheses. */\(* */\(\)* */\)*
E.g., "\(^a\)" matches 'a' at the start of a line.
+ There can only be ten of these. You can use "\%(" to add more, but
+ not counting it as a sub-expression.
*E51* *E54* *E55* *E872* *E873*
\1 Matches the same string that was matched by */\1* *E65*
@@ -1092,7 +1094,7 @@
\x A backslash followed by a single character, with no special meaning,
is reserved for future expansions
-[] (with 'nomagic': \[]) */[]* */\[]* */\_[]* */collection*
+[] (with 'nomagic': \[]) */[]* */\[]* */\_[]* */collection* *E76*
\_[]
A collection. This is a sequence of characters enclosed in square
brackets. It matches any single character in the collection.
@@ -1488,5 +1490,4 @@
The "f" flag of `:vimgrep` enables fuzzy matching.
-
vim:tw=78:ts=8:noet:ft=help:norl:
diff --git a/runtime/doc/popup.txt b/runtime/doc/popup.txt
index b4d7702..6645a7b 100644
--- a/runtime/doc/popup.txt
+++ b/runtime/doc/popup.txt
@@ -1,4 +1,4 @@
-*popup.txt* For Vim version 8.2. Last change: 2021 Nov 29
+*popup.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -54,7 +54,7 @@
The size can be up to the whole Vim window and it overlaps other windows.
Popup windows can also overlap each other. The "zindex" property specifies
what goes on top of what.
-
+ *E366*
The popup window contains a buffer, and that buffer is always associated with
the popup window. The window cannot be in Normal, Visual or Insert mode, it
does not get keyboard focus. You can use functions like `setbufline()` to
@@ -262,7 +262,7 @@
popup_create({what}, {options}) *popup_create()*
- Open a popup window showing {what}, which is either:
+ Open a popup window showing {what}, which is either: *E450*
- a buffer number
- a string
- a list of strings
diff --git a/runtime/doc/quickfix.txt b/runtime/doc/quickfix.txt
index 47ead21..b7a01bd 100644
--- a/runtime/doc/quickfix.txt
+++ b/runtime/doc/quickfix.txt
@@ -1,4 +1,4 @@
-*quickfix.txt* For Vim version 8.2. Last change: 2021 Dec 03
+*quickfix.txt* For Vim version 8.2. Last change: 2022 Jan 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -244,7 +244,7 @@
[!] is not used. It works like ":qall!" |:qall|,
except that Vim returns a non-zero exit code.
- *:cf* *:cfile*
+ *:cf* *:cfi* *:cfile*
:cf[ile][!] [errorfile] Read the error file and jump to the first error.
This is done automatically when Vim is started with
the -q option. You can use this command when you
diff --git a/runtime/doc/starting.txt b/runtime/doc/starting.txt
index d4e8cf8..edd3fa8 100644
--- a/runtime/doc/starting.txt
+++ b/runtime/doc/starting.txt
@@ -1,4 +1,4 @@
-*starting.txt* For Vim version 8.2. Last change: 2021 May 08
+*starting.txt* For Vim version 8.2. Last change: 2022 Jan 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -560,6 +560,8 @@
":source!". When the "scriptout" file already exists, new
characters are appended. See also |complex-repeat|.
{scriptout} cannot start with a digit.
+ If you want to record what is typed in a human readable for
+ you can use |ch_logfile()|, It adds "raw key input" lines.
*-W*
-W {scriptout} Like -w, but do not append, overwrite an existing file.
diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index 35a4e3a..737e063 100644
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -1442,7 +1442,7 @@
:let g:filetype_euphoria = "euphoria4"
-Elixir and Euphoria share the *.ex file extension. If the filetype is
+Elixir and Euphoria share the *.ex file extension. If the filetype is
specifically set as Euphoria with the g:filetype_euphoria variable, or the
file is determined to be Euphoria based on keywords in the file, then the
filetype will be set as Euphoria. Otherwise, the filetype will default to
@@ -1473,7 +1473,7 @@
*.ex, *.exs, *.eex, *.leex, *.lock
-Elixir and Euphoria share the *.ex file extension. If the filetype is
+Elixir and Euphoria share the *.ex file extension. If the filetype is
specifically set as Euphoria with the g:filetype_euphoria variable, or the
file is determined to be Euphoria based on keywords in the file, then the
filetype will be set as Euphoria. Otherwise, the filetype will default to
diff --git a/runtime/doc/tags b/runtime/doc/tags
index b52e526..78e88f3 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -1162,6 +1162,7 @@
'ts' options.txt /*'ts'*
'tsl' options.txt /*'tsl'*
'tsr' options.txt /*'tsr'*
+'tsrfu' options.txt /*'tsrfu'*
'ttimeout' options.txt /*'ttimeout'*
'ttimeoutlen' options.txt /*'ttimeoutlen'*
'ttm' options.txt /*'ttm'*
@@ -1418,6 +1419,7 @@
+user_commands various.txt /*+user_commands*
+vartabs various.txt /*+vartabs*
+vertsplit various.txt /*+vertsplit*
++vim9script various.txt /*+vim9script*
+viminfo various.txt /*+viminfo*
+virtualedit various.txt /*+virtualedit*
+visual various.txt /*+visual*
@@ -2244,6 +2246,7 @@
:cexpr quickfix.txt /*:cexpr*
:cf quickfix.txt /*:cf*
:cfdo quickfix.txt /*:cfdo*
+:cfi quickfix.txt /*:cfi*
:cfile quickfix.txt /*:cfile*
:cfir quickfix.txt /*:cfir*
:cfirst quickfix.txt /*:cfirst*
@@ -4013,7 +4016,6 @@
E128 eval.txt /*E128*
E129 eval.txt /*E129*
E13 message.txt /*E13*
-E130 eval.txt /*E130*
E131 eval.txt /*E131*
E132 eval.txt /*E132*
E133 eval.txt /*E133*
@@ -4153,6 +4155,7 @@
E258 remote.txt /*E258*
E259 if_cscop.txt /*E259*
E26 rileft.txt /*E26*
+E260 eval.txt /*E260*
E261 if_cscop.txt /*E261*
E262 if_cscop.txt /*E262*
E263 if_pyth.txt /*E263*
@@ -4183,6 +4186,7 @@
E288 mbyte.txt /*E288*
E289 mbyte.txt /*E289*
E29 change.txt /*E29*
+E290 builtin.txt /*E290*
E292 message.txt /*E292*
E293 message.txt /*E293*
E294 message.txt /*E294*
@@ -4190,7 +4194,6 @@
E296 message.txt /*E296*
E297 message.txt /*E297*
E298 message.txt /*E298*
-E299 if_perl.txt /*E299*
E30 change.txt /*E30*
E300 message.txt /*E300*
E301 message.txt /*E301*
@@ -4258,9 +4261,11 @@
E359 term.txt /*E359*
E36 windows.txt /*E36*
E360 various.txt /*E360*
+E362 eval.txt /*E362*
E363 options.txt /*E363*
E364 builtin.txt /*E364*
E365 print.txt /*E365*
+E366 popup.txt /*E366*
E367 autocmd.txt /*E367*
E368 builtin.txt /*E368*
E369 pattern.txt /*E369*
@@ -4352,8 +4357,11 @@
E448 various.txt /*E448*
E449 builtin.txt /*E449*
E45 message.txt /*E45*
+E450 popup.txt /*E450*
+E451 eval.txt /*E451*
E452 eval.txt /*E452*
E453 syntax.txt /*E453*
+E454 eval.txt /*E454*
E455 print.txt /*E455*
E456 print.txt /*E456*
E457 print.txt /*E457*
@@ -4391,8 +4399,10 @@
E486 pattern.txt /*E486*
E487 options.txt /*E487*
E488 message.txt /*E488*
+E489 cmdline.txt /*E489*
E49 message.txt /*E49*
E490 fold.txt /*E490*
+E491 builtin.txt /*E491*
E492 message.txt /*E492*
E493 cmdline.txt /*E493*
E494 editing.txt /*E494*
@@ -4443,6 +4453,7 @@
E535 options.txt /*E535*
E536 options.txt /*E536*
E537 options.txt /*E537*
+E538 builtin.txt /*E538*
E539 options.txt /*E539*
E54 pattern.txt /*E54*
E540 options.txt /*E540*
@@ -4518,6 +4529,7 @@
E609 if_cscop.txt /*E609*
E61 pattern.txt /*E61*
E610 editing.txt /*E610*
+E611 eval.txt /*E611*
E612 sign.txt /*E612*
E613 print.txt /*E613*
E614 editing.txt /*E614*
@@ -7010,6 +7022,7 @@
g:tex_superscripts syntax.txt /*g:tex_superscripts*
g:tex_verbspell syntax.txt /*g:tex_verbspell*
g:var eval.txt /*g:var*
+g:vim_indent_cont indent.txt /*g:vim_indent_cont*
g:vimball_home pi_vimball.txt /*g:vimball_home*
g:vimball_mkdir pi_vimball.txt /*g:vimball_mkdir*
g:vimsyn_embed syntax.txt /*g:vimsyn_embed*
@@ -7937,6 +7950,7 @@
matlab-indent indent.txt /*matlab-indent*
matlab-indenting indent.txt /*matlab-indenting*
max() builtin.txt /*max()*
+maxcol-variable eval.txt /*maxcol-variable*
mbyte-IME mbyte.txt /*mbyte-IME*
mbyte-XIM mbyte.txt /*mbyte-XIM*
mbyte-combining mbyte.txt /*mbyte-combining*
@@ -9870,7 +9884,6 @@
try-finally eval.txt /*try-finally*
try-nested eval.txt /*try-nested*
try-nesting eval.txt /*try-nesting*
-tsrfu' options.txt /*tsrfu'*
tutor usr_01.txt /*tutor*
twice if_cscop.txt /*twice*
two-engines pattern.txt /*two-engines*
@@ -10005,6 +10018,7 @@
v:lang eval.txt /*v:lang*
v:lc_time eval.txt /*v:lc_time*
v:lnum eval.txt /*v:lnum*
+v:maxcol eval.txt /*v:maxcol*
v:mouse_col eval.txt /*v:mouse_col*
v:mouse_lnum eval.txt /*v:mouse_lnum*
v:mouse_win eval.txt /*v:mouse_win*
diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt
index ca28f1f..8e751d1 100644
--- a/runtime/doc/terminal.txt
+++ b/runtime/doc/terminal.txt
@@ -39,6 +39,7 @@
Stepping through code |termdebug-stepping|
Inspecting variables |termdebug-variables|
Other commands |termdebug-commands|
+ Events |termdebug-events|
Prompt mode |termdebug-prompt|
Communication |termdebug-communication|
Customizing |termdebug-customizing|
diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt
index 5b227e3..b18effd 100644
--- a/runtime/doc/todo.txt
+++ b/runtime/doc/todo.txt
@@ -1,4 +1,4 @@
-*todo.txt* For Vim version 8.2. Last change: 2021 Dec 30
+*todo.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -38,15 +38,27 @@
*known-bugs*
-------------------- Known bugs and current work -----------------------
+Autoload import syntax:
+ import autoload "filename"
+ import autoload "filename" as name
+doesn't load the script yet
+ autoload items can be used without the "#dir#file#" prefix, but file.item
+ Add a test_override() item to load the script and compile functions the
+ moment it is encountered, so that types are checked.
+"vim9script autoload" in an autoload script, using "export" will prefix
+ "dir#file#" to the exported item.
+
Once Vim9 is stable:
-- Add the "vim9script" feature, can use has('vim9script')
- Remove TODO in vim9.txt
- Add all the error numbers in a good place in documentation.
+ done until E653
- Use Vim9 for runtime files.
Further Vim9 improvements, possibly after launch:
- Check performance with callgrind and kcachegrind.
-- better implementation for partial and tests for that.
+- Better implementation for partial and tests for that.
+- when using "const" mark the variable type as const with TTFLAG_CONST, so
+ that an error is given at compile time when trying to change it. E.g. for a
+ const list and trying to call add().
- Compile options that are an expression, e.g. "expr:" in 'spellsuggest',
'foldexpr', 'foldtext', 'printexpr', 'diffexpr', 'patchexpr', 'charconvert',
'balloonexpr', 'includeexpr', 'indentexpr', 'formatexpr'.
diff --git a/runtime/doc/usr_06.txt b/runtime/doc/usr_06.txt
index aefe45b..5e52209 100644
--- a/runtime/doc/usr_06.txt
+++ b/runtime/doc/usr_06.txt
@@ -189,7 +189,7 @@
colors in |v:colornames| like so: >
let v:colornames['mine_red'] = '#aa0000'
-<
+
If you are authoring a color scheme for others to use, it is important
to define these colors only when they do not exist: >
@@ -197,7 +197,7 @@
This allows users of the color scheme to override the precise definition of
that color prior to loading your color scheme. For example, in a |.vimrc|
-file:
+file: >
runtime colors/lists/css_colors.vim
let v:colornames['your_red'] = v:colornames['css_red']
diff --git a/runtime/doc/usr_40.txt b/runtime/doc/usr_40.txt
index 21c09b4..9ed777f 100644
--- a/runtime/doc/usr_40.txt
+++ b/runtime/doc/usr_40.txt
@@ -1,4 +1,4 @@
-*usr_40.txt* For Vim version 8.2. Last change: 2020 Sep 02
+*usr_40.txt* For Vim version 8.2. Last change: 2022 Jan 03
VIM USER MANUAL - by Bram Moolenaar
@@ -20,7 +20,7 @@
==============================================================================
*40.1* Key mapping
-A simple mapping was explained in section |05.3|. The principle is that one
+A simple mapping was explained in section |05.4|. The principle is that one
sequence of key strokes is translated into another sequence of key strokes.
This is a simple, yet powerful mechanism.
The simplest form is that one key is mapped to a sequence of keys. Since
diff --git a/runtime/doc/usr_41.txt b/runtime/doc/usr_41.txt
index a9abe59..1ef4f26 100644
--- a/runtime/doc/usr_41.txt
+++ b/runtime/doc/usr_41.txt
@@ -1,4 +1,4 @@
-*usr_41.txt* For Vim version 8.2. Last change: 2021 Dec 30
+*usr_41.txt* For Vim version 8.2. Last change: 2022 Jan 01
VIM USER MANUAL - by Bram Moolenaar
@@ -277,7 +277,7 @@
var name = "Peter"
echo name
-< peter ~
+< Peter ~
Every variable has a type. Very often, as in this example, the type is
defined by assigning a value. This is called type inference. If you do not
@@ -538,16 +538,16 @@
Example: >
+ var counter = 1
while counter < 40
- do_something()
- if skip_flag
+ if skip_number(counter)
continue
endif
- if finished_flag
+ if last_number(counter)
break
endif
sleep 50m
- --counter
+ ++counter
endwhile
The `sleep` command makes Vim take a nap. The "50m" specifies fifty
diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt
index da44546..a3feeb0 100644
--- a/runtime/doc/various.txt
+++ b/runtime/doc/various.txt
@@ -1,4 +1,4 @@
-*various.txt* For Vim version 8.2. Last change: 2021 Dec 20
+*various.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -244,10 +244,10 @@
compiler will have set stdin to a non-interactive
mode.
- *:!cmd* *:!* *E34*
+ *:!cmd* *:!*
:!{cmd} Execute {cmd} with the shell. See also the 'shell'
and 'shelltype' option.
-
+ *E34*
Any '!' in {cmd} is replaced with the previous
external command (see also 'cpoptions'). But not when
there is a backslash before the '!', then that
diff --git a/runtime/doc/vim9.txt b/runtime/doc/vim9.txt
index 5d3e5b1..0af6dff 100644
--- a/runtime/doc/vim9.txt
+++ b/runtime/doc/vim9.txt
@@ -1,4 +1,4 @@
-*vim9.txt* For Vim version 8.2. Last change: 2021 Dec 27
+*vim9.txt* For Vim version 8.2. Last change: 2022 Jan 07
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -120,7 +120,7 @@
In Vi # is a command to list text with numbers. In Vim9 script you can use
`:number` for that. >
- 101 number
+ :101 number
To improve readability there must be a space between a command and the #
that starts a comment: >
@@ -1358,8 +1358,14 @@
*vim9script* *vim9-export* *vim9-import*
A Vim9 script can be written to be imported. This means that everything in
-the script is local, unless exported. Those exported items, and only those
-items, can then be imported in another script.
+the script is local, except for items that are exported. Those exported
+items, and only those items, can then be imported in another script.
+
+This mechanism exists for writing a script that can be sourced (imported) by
+other scripts, while making sure these other scripts only have access to what
+you want them to. This also avoids using the global namespace, which has a
+risc of name collisions. For example when you have two plugins with similar
+functionality.
You can cheat by using the global namespace explicitly. We will assume here
that you don't do that.
@@ -1438,21 +1444,23 @@
This makes each item available as "myscript.item".
In case the name is long or ambiguous, another name can be specified: >
- import "thatscript.vim" as That
+ import "thatscript.vim" as that
-Then you can use "That.EXPORTED_CONST", "That.someValue", etc. You are free
-to choose the name "That". Use something that will be recognized as referring
-to the imported script. Avoid command names, because the name will shadow
-them.
+Then you can use "that.EXPORTED_CONST", "that.someValue", etc. You are free
+to choose the name "that". Use something that will be recognized as referring
+to the imported script. Avoid command names and builtin function names,
+because the name will shadow them.
-In case the dot in the name is unwanted, a local reference can be made: >
- var ThatFunc = That.LongFuncName
+In case the dot in the name is undesired, a local reference can be made for a
+function: >
+ var LongFunc = that.LongFuncName
This also works for constants: >
- cost MAXLEN = That.MAX_LEN_OF_NAME
+ const MAXLEN = that.MAX_LEN_OF_NAME
-This does not work for variables, you could use a setter function and make a
-local reference for it.
+This does not work for variables, since the value would be copied once and
+when changing the variable the copy will change, not the original variable.
+You will need to use the full name, with the dot.
`:import` can also be used in legacy Vim script. The imported items still
become script-local, even when the "s:" prefix is not given.
@@ -1471,12 +1479,21 @@
longer and unique, to avoid loading the wrong file.
Note that "after/import" is not used.
+If the name does not end in ".vim" then the use of "as name" is required.
+
Once a vim9 script file has been imported, the result is cached and used the
next time the same script is imported. It will not be read again.
It is not allowed to import the same script twice, also when using two
different "as" names.
- *:import-cycle*
+
+When using the imported name the dot and the item name must be in the same
+line, there can be no line break: >
+ echo that.
+ name # Error!
+ echo that
+ .name # Error!
+< *:import-cycle*
The `import` commands are executed when encountered. If that script (directly
or indirectly) imports the current script, then items defined after the
`import` won't be processed yet. Therefore cyclic imports can exist, but may
diff --git a/runtime/doc/windows.txt b/runtime/doc/windows.txt
index 2f60835..79d00a7 100644
--- a/runtime/doc/windows.txt
+++ b/runtime/doc/windows.txt
@@ -1,4 +1,4 @@
-*windows.txt* For Vim version 8.2. Last change: 2021 Nov 29
+*windows.txt* For Vim version 8.2. Last change: 2022 Jan 08
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -146,7 +146,7 @@
the filler characters.
==============================================================================
-3. Opening and closing a window *opening-window* *E36*
+3. Opening and closing a window *opening-window*
CTRL-W s *CTRL-W_s*
CTRL-W S *CTRL-W_S*
@@ -246,6 +246,10 @@
Note that the 'splitbelow' and 'splitright' options influence where a new
window will appear.
+ *E36*
+Creating a window will fail if there is not enough room. Every window needs
+at least one screen line and column, sometimes more. Options 'winminheight'
+and 'winminwidth' are relevant.
*:vert* *:vertical*
:vert[ical] {cmd}