Skip to content

Commit

Permalink
Update runtime files
Browse files Browse the repository at this point in the history
  • Loading branch information
brammool committed Nov 23, 2022
1 parent 43300f6 commit b59ae59
Show file tree
Hide file tree
Showing 31 changed files with 3,818 additions and 90 deletions.
11 changes: 6 additions & 5 deletions runtime/doc/autocmd.txt
@@ -1,4 +1,4 @@
*autocmd.txt* For Vim version 9.0. Last change: 2022 May 24
*autocmd.txt* For Vim version 9.0. Last change: 2022 Nov 22


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -1058,8 +1058,8 @@ QuickFixCmdPre Before a quickfix command is run (|:make|,
QuickFixCmdPost Like QuickFixCmdPre, but after a quickfix
command is run, before jumping to the first
location. For |:cfile| and |:lfile| commands
it is run after error file is read and before
moving to the first error.
it is run after the error file is read and
before moving to the first error.
See |QuickFixCmdPost-example|.
*QuitPre*
QuitPre When using `:quit`, `:wq` or `:qall`, before
Expand Down Expand Up @@ -1342,8 +1342,9 @@ VimSuspend When the Vim instance is suspended. Only when
CTRL-Z was typed inside Vim, or when the SIGTSTP
signal was sent to Vim, but not for SIGSTOP.
*WinClosed*
WinClosed After closing a window. The pattern is
matched against the |window-ID|. Both
WinClosed When closing a window, just before it is
removed from the window layout. The pattern
is matched against the |window-ID|. Both
<amatch> and <afile> are set to the
|window-ID|. Non-recursive (event cannot
trigger itself).
Expand Down
47 changes: 30 additions & 17 deletions runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
*builtin.txt* For Vim version 9.0. Last change: 2022 Nov 14
*builtin.txt* For Vim version 9.0. Last change: 2022 Nov 21


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -5572,6 +5572,10 @@ map({expr1}, {expr2}) *map()*
If {expr2} is a |Funcref| it is called with two arguments:
1. The key or the index of the current item.
2. the value of the current item.
With a legacy script lambda you don't get an error if it only
accepts one argument, but with a Vim9 lambda you get "E1106:
One argument too many", the number of arguments must match.

The function must return the new value of the item. Example
that changes each value by "key-value": >
func KeyValue(key, val)
Expand Down Expand Up @@ -7938,29 +7942,38 @@ setbufvar({buf}, {varname}, {val}) *setbufvar()*
setcellwidths({list}) *setcellwidths()*
Specify overrides for cell widths of character ranges. This
tells Vim how wide characters are, counted in screen cells.
This overrides 'ambiwidth'. Example: >
setcellwidths([[0xad, 0xad, 1],
\ [0x2194, 0x2199, 2]])
< *E1109* *E1110* *E1111* *E1112* *E1113* *E1114*
The {list} argument is a list of lists with each three
numbers. These three numbers are [low, high, width]. "low"
and "high" can be the same, in which case this refers to one
character. Otherwise it is the range of characters from "low"
to "high" (inclusive). "width" is either 1 or 2, indicating
the character width in screen cells.
An error is given if the argument is invalid, also when a
range overlaps with another.
tells Vim how wide characters are when displayed in the
terminal, counted in screen cells. The values override
'ambiwidth'. Example: >
call setcellwidths([
\ [0x111, 0x111, 1],
\ [0x2194, 0x2199, 2],
\ ])
< The {list} argument is a List of Lists with each three
numbers: [{low}, {high}, {width}]. *E1109* *E1110*
{low} and {high} can be the same, in which case this refers to
one character. Otherwise it is the range of characters from
{low} to {high} (inclusive). *E1111* *E1114*
Only characters with value 0x100 and higher can be used.

{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*

If the new value causes 'fillchars' or 'listchars' to become
invalid it is rejected and an error is given.

To clear the overrides pass an empty list: >
To clear the overrides pass an empty {list}: >
setcellwidths([]);
< You can use the script $VIMRUNTIME/tools/emoji_list.vim to see
the effect for known emoji characters.
the effect for known emoji characters. Move the cursor
through the text to check if the cell widths of your terminal
match with what Vim knows about each emoji. If it doesn't
look right you need to adjust the {list} argument.


setcharpos({expr}, {list}) *setcharpos()*
Same as |setpos()| but uses the specified column number as the
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/change.txt
@@ -1,4 +1,4 @@
*change.txt* For Vim version 9.0. Last change: 2022 Sep 13
*change.txt* For Vim version 9.0. Last change: 2022 Nov 20


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down
4 changes: 2 additions & 2 deletions runtime/doc/digraph.txt
@@ -1,4 +1,4 @@
*digraph.txt* For Vim version 9.0. Last change: 2021 Jul 19
*digraph.txt* For Vim version 9.0. Last change: 2022 Nov 22


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -162,7 +162,7 @@ These are the RFC1345 digraphs for the one-byte characters. See the output of
":digraphs" for the others.

EURO

*euro* *euro-digraph*
Exception: RFC1345 doesn't specify the euro sign. In Vim the digraph =e was
added for this. Note the difference between latin1, where the digraph Cu is
used for the currency sign, and latin9 (iso-8859-15), where the digraph =e is
Expand Down
6 changes: 3 additions & 3 deletions runtime/doc/eval.txt
@@ -1,4 +1,4 @@
*eval.txt* For Vim version 9.0. Last change: 2022 Nov 13
*eval.txt* For Vim version 9.0. Last change: 2022 Nov 22


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -1548,7 +1548,7 @@ to be doubled. These two commands are equivalent: >
if a =~ '\s*'
interpolated-string *$quote* *interp-string*
interpolated-string *$quote* *interpolated-string*
--------------------
$"string" interpolated string constant *expr-$quote*
$'string' interpolated literal string constant *expr-$'*
Expand Down Expand Up @@ -2859,7 +2859,7 @@ text...
does not need to be doubled.
If "eval" is specified, then any Vim expression in the
form {expr} is evaluated and the result replaces the
expression, like with |interp-string|.
expression, like with |interpolated-string|.
Example where $HOME is expanded: >
let lines =<< trim eval END
some text
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/ft_context.txt
Expand Up @@ -79,7 +79,7 @@ The last command will create the following syntax files:
- `context-data-context.vim`;
- `context-data-interfaces.vim`;
- `context-data-metafun.vim`;
- `context-data-tex.vim`.
- `context-data-tex.vim`.

The same command can be used to update those syntax files.

Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/insert.txt
Expand Up @@ -892,7 +892,7 @@ Groß): >
endfor
return res
endfunc
if exists('+thesaurusfunc')
set thesaurusfunc=Thesaur
endif
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/intro.txt
@@ -1,4 +1,4 @@
*intro.txt* For Vim version 9.0. Last change: 2022 Oct 12
*intro.txt* For Vim version 9.0. Last change: 2022 Nov 20


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down
4 changes: 2 additions & 2 deletions runtime/doc/map.txt
@@ -1,4 +1,4 @@
*map.txt* For Vim version 9.0. Last change: 2022 Nov 14
*map.txt* For Vim version 9.0. Last change: 2022 Nov 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -1853,7 +1853,7 @@ When executed as: >
This will invoke: >
:call Myfunc("arg1","arg2")
< *q-args-example*
< *q-args-example*
A more substantial example: >
:function Allargs(command)
: let i = 0
Expand Down
14 changes: 9 additions & 5 deletions runtime/doc/options.txt
@@ -1,4 +1,4 @@
*options.txt* For Vim version 9.0. Last change: 2022 Nov 12
*options.txt* For Vim version 9.0. Last change: 2022 Nov 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -4548,17 +4548,21 @@ A jump table for the options with a short description can be found at |Q_op|.
|+find_in_path| or |+eval| features}
Expression to be used to transform the string found with the 'include'
option to a file name. Mostly useful to change "." to "/" for Java: >
:set includeexpr=substitute(v:fname,'\\.','/','g')
:setlocal includeexpr=substitute(v:fname,'\\.','/','g')
< The "v:fname" variable will be set to the file name that was detected.

Note the double backslash: the `:set` command first halves them, then
one remains it the value, where "\." matches a dot literally. For
simple character replacements `tr()` avoids the need for escaping: >
:setlocal includeexpr=tr(v:fname,'.','/')
<
Also used for the |gf| command if an unmodified file name can't be
found. Allows doing "gf" on the name after an 'include' statement.
Also used for |<cfile>|.

If the expression starts with s: or |<SID>|, then it is replaced with
the script ID (|local-function|). Example: >
set includeexpr=s:MyIncludeExpr()
set includeexpr=<SID>SomeIncludeExpr()
setlocal includeexpr=s:MyIncludeExpr()
setlocal includeexpr=<SID>SomeIncludeExpr()
< Otherwise, the expression is evaluated in the context of the script
where the option was set, thus script-local items are available.

Expand Down
6 changes: 3 additions & 3 deletions runtime/doc/os_haiku.txt
Expand Up @@ -95,7 +95,7 @@ The default value for $VIM is set at compile time and can be determined with:

:version

The normal value is /boot/system/data/vim for Haikuports version,
The normal value is /boot/system/data/vim for Haikuports version,
/boot/system/non-packaged/data/vim for manual builds. If you don't like it
you can set the VIM environment variable to override this, or set 'helpfile'
in your .vimrc: >
Expand Down Expand Up @@ -223,11 +223,11 @@ Thank you, all!


14. Bugs & to-do *haiku-bugs*

The port is under development now and far away from the perfect state. For bug
reports, patches and wishes, please use the Vim mailing list or Vim Github
repository.

Mailing list: https://www.vim.org/maillist.php
Vim Github repository: https://github.com/vim/vim

Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/quickref.txt
@@ -1,4 +1,4 @@
*quickref.txt* For Vim version 9.0. Last change: 2022 Oct 28
*quickref.txt* For Vim version 9.0. Last change: 2022 Nov 23


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/syntax.txt
Expand Up @@ -4901,7 +4901,7 @@ is mostly used, because it looks better.
In the next section you can find information about indivisual highlight groups
and how to specify colors for them. Most likely you want to just select a set
of colors by using the `:colorscheme` command, for example: >
colorscheme pablo
<
*:colo* *:colorscheme* *E185*
Expand Down
13 changes: 12 additions & 1 deletion runtime/doc/tags
Expand Up @@ -437,10 +437,12 @@ $quote eval.txt /*$quote*
'key' options.txt /*'key'*
'keymap' options.txt /*'keymap'*
'keymodel' options.txt /*'keymodel'*
'keyprotocol' options.txt /*'keyprotocol'*
'keywordprg' options.txt /*'keywordprg'*
'km' options.txt /*'km'*
'kmp' options.txt /*'kmp'*
'kp' options.txt /*'kp'*
'kpc' options.txt /*'kpc'*
'langmap' options.txt /*'langmap'*
'langmenu' options.txt /*'langmenu'*
'langnoremap' options.txt /*'langnoremap'*
Expand Down Expand Up @@ -4362,6 +4364,7 @@ E1309 map.txt /*E1309*
E131 userfunc.txt /*E131*
E1310 gui.txt /*E1310*
E1311 map.txt /*E1311*
E1312 windows.txt /*E1312*
E132 userfunc.txt /*E132*
E133 userfunc.txt /*E133*
E134 change.txt /*E134*
Expand Down Expand Up @@ -5614,7 +5617,10 @@ WinClosed autocmd.txt /*WinClosed*
WinEnter autocmd.txt /*WinEnter*
WinLeave autocmd.txt /*WinLeave*
WinNew autocmd.txt /*WinNew*
WinResized autocmd.txt /*WinResized*
WinResized-event windows.txt /*WinResized-event*
WinScrolled autocmd.txt /*WinScrolled*
WinScrolled-event windows.txt /*WinScrolled-event*
X change.txt /*X*
X11 options.txt /*X11*
X11-icon gui_x11.txt /*X11-icon*
Expand Down Expand Up @@ -6692,6 +6698,8 @@ escape() builtin.txt /*escape()*
escape-bar version4.txt /*escape-bar*
euphoria3.vim syntax.txt /*euphoria3.vim*
euphoria4.vim syntax.txt /*euphoria4.vim*
euro digraph.txt /*euro*
euro-digraph digraph.txt /*euro-digraph*
eval eval.txt /*eval*
eval() builtin.txt /*eval()*
eval-examples eval.txt /*eval-examples*
Expand Down Expand Up @@ -7487,6 +7495,7 @@ get() builtin.txt /*get()*
get-ms-debuggers debug.txt /*get-ms-debuggers*
getbufinfo() builtin.txt /*getbufinfo()*
getbufline() builtin.txt /*getbufline()*
getbufoneline() builtin.txt /*getbufoneline()*
getbufvar() builtin.txt /*getbufvar()*
getchangelist() builtin.txt /*getchangelist()*
getchar() builtin.txt /*getchar()*
Expand Down Expand Up @@ -8066,7 +8075,7 @@ interfaces-5.2 version5.txt /*interfaces-5.2*
internal-variables eval.txt /*internal-variables*
internal-wordlist spell.txt /*internal-wordlist*
internet intro.txt /*internet*
interp-string eval.txt /*interp-string*
interpolated-string eval.txt /*interpolated-string*
interrupt() builtin.txt /*interrupt()*
intro intro.txt /*intro*
intro.txt intro.txt /*intro.txt*
Expand Down Expand Up @@ -8158,6 +8167,7 @@ keypad-plus intro.txt /*keypad-plus*
keypad-point intro.txt /*keypad-point*
keys() builtin.txt /*keys()*
keytrans() builtin.txt /*keytrans()*
kitty-keyboard-protocol map.txt /*kitty-keyboard-protocol*
known-bugs todo.txt /*known-bugs*
l motion.txt /*l*
l: eval.txt /*l:*
Expand Down Expand Up @@ -10860,6 +10870,7 @@ whitespace pattern.txt /*whitespace*
wildcard editing.txt /*wildcard*
wildcards editing.txt /*wildcards*
wildmenumode() builtin.txt /*wildmenumode()*
win-scrolled-resized windows.txt /*win-scrolled-resized*
win16 os_win32.txt /*win16*
win32 os_win32.txt /*win32*
win32-!start gui_w32.txt /*win32-!start*
Expand Down
5 changes: 3 additions & 2 deletions runtime/doc/textprop.txt
@@ -1,4 +1,4 @@
*textprop.txt* For Vim version 9.0. Last change: 2022 Oct 13
*textprop.txt* For Vim version 9.0. Last change: 2022 Nov 18


VIM REFERENCE MANUAL by Bram Moolenaar
Expand Down Expand Up @@ -147,7 +147,8 @@ prop_add({lnum}, {col}, {props})
above/below the line if {col} is zero; prepend
and/or append spaces for padding with
highlighting; cannot be used with "length",
"end_lnum" and "end_col" |virtual-text|
"end_lnum" and "end_col"
See |virtual-text| for more information.
*E1294*
text_align when "text" is present and {col} is zero;
specifies where to display the text:
Expand Down
2 changes: 1 addition & 1 deletion runtime/doc/tips.txt
Expand Up @@ -539,7 +539,7 @@ the current window, try this custom `:HelpCurwin` command:
>
command -bar -nargs=? -complete=help HelpCurwin execute s:HelpCurwin(<q-args>)
let s:did_open_help = v:false
function s:HelpCurwin(subject) abort
let mods = 'silent noautocmd keepalt'
if !s:did_open_help
Expand Down

0 comments on commit b59ae59

Please sign in to comment.