summaryrefslogtreecommitdiffstats
path: root/runtime/doc
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2021-12-05 21:54:04 +0000
committerBram Moolenaar <Bram@vim.org>2021-12-05 21:54:04 +0000
commit4700398e384f38f752b432e187462f404b96847d (patch)
tree581e9d76947deae9644e1a241e0aa12df0783aff /runtime/doc
parent12f3c1b77fb39dc338304d5484cdbc99da27389a (diff)
Update runtime files
Diffstat (limited to 'runtime/doc')
-rw-r--r--runtime/doc/channel.txt9
-rw-r--r--runtime/doc/cmdline.txt8
-rw-r--r--runtime/doc/filetype.txt8
-rw-r--r--runtime/doc/motion.txt6
-rw-r--r--runtime/doc/options.txt13
-rw-r--r--runtime/doc/popup.txt2
-rw-r--r--runtime/doc/quickfix.txt8
-rw-r--r--runtime/doc/sign.txt10
-rw-r--r--runtime/doc/syntax.txt8
-rw-r--r--runtime/doc/tags6
-rw-r--r--runtime/doc/term.txt18
-rw-r--r--runtime/doc/todo.txt16
-rw-r--r--runtime/doc/various.txt12
-rw-r--r--runtime/doc/vim9.txt17
-rw-r--r--runtime/doc/windows.txt4
-rw-r--r--runtime/doc/xxd-fr.12
-rw-r--r--runtime/doc/xxd-fr.UTF-8.12
17 files changed, 91 insertions, 58 deletions
diff --git a/runtime/doc/channel.txt b/runtime/doc/channel.txt
index 39cb43c004..6124a89458 100644
--- a/runtime/doc/channel.txt
+++ b/runtime/doc/channel.txt
@@ -1,4 +1,4 @@
-*channel.txt* For Vim version 8.2. Last change: 2020 Oct 17
+*channel.txt* For Vim version 8.2. Last change: 2021 Nov 28
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -101,7 +101,7 @@ Instead of giving a callback with every send call, it can also be specified
when opening the channel: >
call ch_close(channel)
let channel = ch_open('localhost:8765', {'callback': "MyHandler"})
- call ch_sendexpr(channel, 'hello!')
+ call ch_sendexpr(channel, 'hello channel!')
When trying out channels it's useful to see what is going on. You can tell
Vim to write lines in log file: >
@@ -132,8 +132,9 @@ When using an IPv6 address, enclose it within square brackets. E.g.,
"raw" - Use raw messages
*channel-callback* *E921*
"callback" A function that is called when a message is received that is
- not handled otherwise. It gets two arguments: the channel
- and the received message. Example: >
+ not handled otherwise (e.g. a JSON message with ID zero). It
+ gets two arguments: the channel and the received message.
+ Example: >
func Handle(channel, msg)
echo 'Received: ' . a:msg
endfunc
diff --git a/runtime/doc/cmdline.txt b/runtime/doc/cmdline.txt
index eca741f753..1dc3ebe5d4 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 Nov 22
+*cmdline.txt* For Vim version 8.2. Last change: 2021 Dec 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -919,9 +919,11 @@ Note: these are typed literally, they are not special keys!
*:<amatch>* *<amatch>*
<amatch> When executing autocommands, is replaced with the match for
which this autocommand was executed. *E497*
- It differs from <afile> only when the file name isn't used
- to match with (for FileType, Syntax and SpellFileMissing
+ It differs from <afile> when the file name isn't used to
+ match with (for FileType, Syntax and SpellFileMissing
events).
+ When the match is with a file name, it is expanded to the
+ full path.
*:<sfile>* *<sfile>*
<sfile> When executing a ":source" command, is replaced with the
file name of the sourced file. *E498*
diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt
index 8cb2e118ad..d832e9b113 100644
--- a/runtime/doc/filetype.txt
+++ b/runtime/doc/filetype.txt
@@ -539,14 +539,6 @@ Options:
For further discussion of fortran_have_tabs and the method used for the
detection of source format see |ft-fortran-syntax|.
-GPROF *ft-gprof-plugin*
-
-The gprof filetype plugin defines a mapping <C-]> to jump from a function
-entry in the gprof flat profile or from a function entry in the call graph
-to the details of that function in the call graph.
-
-The mapping can be disabled with: >
- let g:no_gprof_maps = 1
GIT COMMIT *ft-gitcommit-plugin*
diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt
index b50bd65c5e..6e243fda94 100644
--- a/runtime/doc/motion.txt
+++ b/runtime/doc/motion.txt
@@ -1,4 +1,4 @@
-*motion.txt* For Vim version 8.2. Last change: 2021 Jun 13
+*motion.txt* For Vim version 8.2. Last change: 2021 Dec 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -386,6 +386,8 @@ w [count] words forward. |exclusive| motion.
<C-Right> or *<C-Right>* *W*
W [count] WORDS forward. |exclusive| motion.
+ If <C-Right> does not work, check out
+ |arrow_modifiers|.
*e*
e Forward to the end of word [count] |inclusive|.
@@ -400,6 +402,8 @@ b [count] words backward. |exclusive| motion.
<C-Left> or *<C-Left>* *B*
B [count] WORDS backward. |exclusive| motion.
+ If <C-Left> does not work, check out
+ |arrow_modifiers|.
*ge*
ge Backward to the end of word [count] |inclusive|.
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 73c92122f9..ee03570ba8 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 Nov 24
+*options.txt* For Vim version 8.2. Last change: 2021 Dec 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -35,6 +35,8 @@ achieve special effects. These options come in three forms:
internally and can't be changed. Changing the terminal
codes in the GUI is not useful either...
+:se[t]! termcap Idem, but don't use multiple columns.
+
*E518* *E519*
:se[t] {option}? Show value of {option}.
@@ -869,9 +871,12 @@ A jump table for the options with a short description can be found at |Q_op|.
'autowrite' 'aw' boolean (default off)
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 to another file.
+ `: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
+ to another file.
+ A buffer is not written if it becomes hidden, e.g. when 'bufhidden' is
+ 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
diff --git a/runtime/doc/popup.txt b/runtime/doc/popup.txt
index 904abe73b1..b4d770245f 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 Aug 15
+*popup.txt* For Vim version 8.2. Last change: 2021 Nov 29
VIM REFERENCE MANUAL by Bram Moolenaar
diff --git a/runtime/doc/quickfix.txt b/runtime/doc/quickfix.txt
index 9ebefa956d..47ead217f9 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 May 22
+*quickfix.txt* For Vim version 8.2. Last change: 2021 Dec 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -856,9 +856,9 @@ lists. They set one of the existing error lists as the current one.
*:chistory* *:chi*
:[count]chi[story] Show the list of error lists. The current list is
marked with ">". The output looks like:
- error list 1 of 3; 43 errors ~
- > error list 2 of 3; 0 errors ~
- error list 3 of 3; 15 errors ~
+ error list 1 of 3; 43 errors :make ~
+ > error list 2 of 3; 0 errors :helpgrep tag ~
+ error list 3 of 3; 15 errors :grep ex_help *.c ~
When [count] is given, then the count'th quickfix
list is made the current list. Example: >
diff --git a/runtime/doc/sign.txt b/runtime/doc/sign.txt
index 489f3d8b52..7976cecca8 100644
--- a/runtime/doc/sign.txt
+++ b/runtime/doc/sign.txt
@@ -1,4 +1,4 @@
-*sign.txt* For Vim version 8.2. Last change: 2021 Mar 07
+*sign.txt* For Vim version 8.2. Last change: 2021 Dec 05
VIM REFERENCE MANUAL by Gordon Prieur
@@ -441,14 +441,16 @@ sign_getdefined([{name}]) *sign_getdefined()*
following entries:
icon full path to the bitmap file of the sign
linehl highlight group used for the whole line the
- sign is placed in.
+ sign is placed in; not present if not set
name name of the sign
text text that is displayed when there is no icon
or the GUI is not being used.
- texthl highlight group used for the text item
+ texthl highlight group used for the text item; not
+ present if not set
culhl highlight group used for the text item when
the cursor is on the same line as the sign and
- 'cursorline' is enabled.
+ 'cursorline' is enabled; not present if not
+ set
Returns an empty List if there are no signs and when {name} is
not found.
diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index 3bc5cf4b0a..0101b51b64 100644
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -3196,6 +3196,14 @@ buffer by buffer basis.
For more detailed instructions see |ft_sql.txt|.
+SQUIRREL *squirrel.vim* *ft-squirrel-syntax*
+
+Squirrel is a high level imperative, object-oriented programming language,
+designed to be a light-weight scripting language that fits in the size, memory
+bandwidth, and real-time requirements of applications like video games. Files
+with the following extensions are recognized as squirrel files: .nut.
+
+
TCSH *tcsh.vim* *ft-tcsh-syntax*
This covers the shell named "tcsh". It is a superset of csh. See |csh.vim|
diff --git a/runtime/doc/tags b/runtime/doc/tags
index 768b98c6e4..f694ba2bc5 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -3951,7 +3951,6 @@ E107 eval.txt /*E107*
E108 eval.txt /*E108*
E109 eval.txt /*E109*
E1091 vim9.txt /*E1091*
-E1092 vim9.txt /*E1092*
E1094 vim9.txt /*E1094*
E11 cmdline.txt /*E11*
E110 eval.txt /*E110*
@@ -5463,6 +5462,7 @@ arglistid() eval.txt /*arglistid()*
argument-list editing.txt /*argument-list*
argv() eval.txt /*argv()*
argv-variable eval.txt /*argv-variable*
+arrow_modifiers term.txt /*arrow_modifiers*
as motion.txt /*as*
asin() eval.txt /*asin()*
asm.vim syntax.txt /*asm.vim*
@@ -6562,6 +6562,7 @@ format-bullet-list tips.txt /*format-bullet-list*
format-comments change.txt /*format-comments*
format-formatexpr change.txt /*format-formatexpr*
formatting change.txt /*formatting*
+forth.vim syntax.txt /*forth.vim*
fortran.vim syntax.txt /*fortran.vim*
friendship intro.txt /*friendship*
frombook usr_01.txt /*frombook*
@@ -6615,6 +6616,7 @@ ft-erlang-syntax syntax.txt /*ft-erlang-syntax*
ft-euphoria-syntax syntax.txt /*ft-euphoria-syntax*
ft-flexwiki-syntax syntax.txt /*ft-flexwiki-syntax*
ft-form-syntax syntax.txt /*ft-form-syntax*
+ft-forth-syntax syntax.txt /*ft-forth-syntax*
ft-fortran-indent indent.txt /*ft-fortran-indent*
ft-fortran-plugin filetype.txt /*ft-fortran-plugin*
ft-fortran-syntax syntax.txt /*ft-fortran-syntax*
@@ -6706,6 +6708,7 @@ ft-sql-omni insert.txt /*ft-sql-omni*
ft-sql-syntax syntax.txt /*ft-sql-syntax*
ft-sqlanywhere-syntax syntax.txt /*ft-sqlanywhere-syntax*
ft-sqlinformix-syntax syntax.txt /*ft-sqlinformix-syntax*
+ft-squirrel-syntax syntax.txt /*ft-squirrel-syntax*
ft-syntax-omni insert.txt /*ft-syntax-omni*
ft-tcsh-syntax syntax.txt /*ft-tcsh-syntax*
ft-termcap-syntax syntax.txt /*ft-termcap-syntax*
@@ -9242,6 +9245,7 @@ sqlj ft_sql.txt /*sqlj*
sqlserver ft_sql.txt /*sqlserver*
sqlsettype ft_sql.txt /*sqlsettype*
sqrt() eval.txt /*sqrt()*
+squirrel.vim syntax.txt /*squirrel.vim*
srand() eval.txt /*srand()*
sscanf eval.txt /*sscanf*
standard-plugin usr_05.txt /*standard-plugin*
diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt
index d6f31d379c..3333a3ab6f 100644
--- a/runtime/doc/term.txt
+++ b/runtime/doc/term.txt
@@ -1,4 +1,4 @@
-*term.txt* For Vim version 8.2. Last change: 2021 Aug 29
+*term.txt* For Vim version 8.2. Last change: 2021 Dec 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -151,7 +151,7 @@ terminal that tmux is running in): >
let &t_fe = "\<Esc>[?1004h"
let &t_fd = "\<Esc>[?1004l"
- " Enable modified arrow keys, see :help xterm-modifier-keys
+ " Enable modified arrow keys, see :help arrow_modifiers
execute "silent! set <xUp>=\<Esc>[@;*A"
execute "silent! set <xDown>=\<Esc>[@;*B"
execute "silent! set <xRight>=\<Esc>[@;*C"
@@ -252,7 +252,19 @@ another code. That is to avoid that the codes obtained from xterm directly
Another special value is a termcap entry ending in "@;*X". This is for cursor
keys, which either use "CSI X" or "CSI 1 ; modifier X". Thus the "@"
stands for either "1" if a modifier follows, or nothing.
- *xterm-scroll-region*
+ *arrow_modifiers*
+Several terminal emulators (alacritty, gnome, konsole, etc.) send special
+codes for keys with modifiers, but these do not have an entry in the
+termcap/terminfo database. You can make them work by adding a few lines in
+your vimrc. For example, to make the Control modifier work with arrow keys
+for the gnome terminal: >
+ if &term =~ 'gnome'
+ execute "set <xUp>=\<Esc>[@;*A"
+ execute "set <xDown>=\<Esc>[@;*B"
+ execute "set <xRight>=\<Esc>[@;*C"
+ execute "set <xLeft>=\<Esc>[@;*D"
+ endif
+< *xterm-scroll-region*
The default termcap entry for xterm on Sun and other platforms does not
contain the entry for scroll regions. Add ":cs=\E[%i%d;%dr:" to the xterm
entry in /etc/termcap and everything should work.
diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt
index 4793abd832..1772aa1e92 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 Nov 26
+*todo.txt* For Vim version 8.2. Last change: 2021 Dec 05
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -38,13 +38,7 @@ browser use: https://github.com/vim/vim/issues/1234
*known-bugs*
-------------------- Known bugs and current work -----------------------
-refactor ex_let_one() to subfunctions.
-
Vim9 - Make everything work:
-- "filter #pat# ls" should work, #pat# is not a comment
- vim9script
- edit foobar
- filter #foobar# ls
- Check TODO items in vim9compile.c and vim9execute.c
- use CheckLegacyAndVim9Success(lines) in many more places
- For builtin functions using tv_get_string*() use check_for_string() to be
@@ -263,6 +257,10 @@ test_arglist func Test_all_not_allowed_from_cmdwin() hangs on MS-Windows.
Mapping with partial match not executed properly in GTK. (Ingo Karkat, #7082)
+Information for a specific terminal (e.g. gnome, tmux, konsole, alacritty) is
+spread out. Make a section with copy/paste examples of script and pointers to
+more information.
+
Problem that a previous silent ":throw" causes a following try/catch not to
work. (ZyX, 2013 Sep 28) With examples: (Malcolm Rowe, 2015 Dec 24)
Also see #8487 for an example.
@@ -1470,10 +1468,6 @@ When the CursorMovedI event triggers, and CTRL-X was typed, a script cannot
restore the mode properly. (Andrew Stewart, 2016 Apr 20)
Do not trigger the event?
-Patch to fix display of listchars on the cursorline. (Nayuri Aohime, 2013)
-Update suggested by Yasuhiro Matsumoto, 2014 Nov 25:
-https://gist.github.com/presuku/d3d6b230b9b6dcfc0477
-
Patch to make the behavior of "w" more straightforward, but not Vi compatible.
With a 'cpo' flag. (Christian Brabandt, 2016 Feb 8)
diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt
index 290eb4f1cf..3f750cd874 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 Sep 06
+*various.txt* For Vim version 8.2. Last change: 2021 Nov 30
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -369,7 +369,7 @@ N *+digraphs* |digraphs| *E196*
*+dnd* Support for DnD into the "~ register |quote_~|.
B *+emacs_tags* |emacs-tags| files
N *+eval* expression evaluation |eval.txt|
-N *+ex_extra* always on now, used to be for Vim's extra Ex commands
+T *+ex_extra* always on now, used to be for Vim's extra Ex commands
N *+extra_search* |'hlsearch'| and |'incsearch'| options.
- *+farsi* Removed: |farsi| language
N *+file_in_path* |gf|, |CTRL-W_f| and |<cfile>|
@@ -423,7 +423,7 @@ N *+multi_lang* non-English language support |multi-lang|
m *+mzscheme* Mzscheme interface |mzscheme|
m *+mzscheme/dyn* Mzscheme interface |mzscheme-dynamic| |/dyn|
m *+netbeans_intg* |netbeans|
- *+num64* 64-bit Number support |Number|
+T *+num64* 64-bit Number support |Number|
Always enabled since 8.2.0271, use v:numbersize to
check the actual size of a Number.
m *+ole* Win32 GUI only: |ole-interface|
@@ -471,15 +471,15 @@ N *+textobjects* |text-objects| selection
N *+textprop* |text-properties|
*+tgetent* non-Unix only: able to use external termcap
N *+timers* the |timer_start()| function
-N *+title* Setting the window 'title' and 'icon'; Always enabled
+T *+title* Setting the window 'title' and 'icon'; Always enabled
N *+toolbar* |gui-toolbar|
T *+user_commands* User-defined commands. |user-commands|
Always enabled since 8.1.1210.
B *+vartabs* Variable-width tabstops. |'vartabstop'|
N *+viminfo* |'viminfo'|
- *+vertsplit* Vertically split windows |:vsplit|; Always enabled
+T *+vertsplit* Vertically split windows |:vsplit|; Always enabled
since 8.0.1118.
-N *+virtualedit* |'virtualedit'| Always enabled since 8.1.826.
+T *+virtualedit* |'virtualedit'| Always enabled since 8.1.826.
T *+visual* Visual mode |Visual-mode| Always enabled since 7.4.200.
T *+visualextra* extra Visual mode commands |blockwise-operators|
T *+vreplace* |gR| and |gr|
diff --git a/runtime/doc/vim9.txt b/runtime/doc/vim9.txt
index 9329aa9c7c..856ec2f118 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 Nov 22
+*vim9.txt* For Vim version 8.2. Last change: 2021 Dec 01
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -234,9 +234,10 @@ the "name#" prefix is sufficient. >
def scriptname#function() # autoload
When using `:function` or `:def` to specify a nested function inside a `:def`
-function, this nested function is local to the code block it is defined in.
-In a `:def` function it is not possible to define a script-local function. It
-is possible to define a global function by using the "g:" prefix.
+function and no namespace was given, this nested function is local to the code
+block it is defined in. In a `:def` function it is not possible to define a
+script-local function. It is possible to define a global function by using
+the "g:" prefix.
When referring to a function and no "s:" or "g:" prefix is used, Vim will
search for the function:
@@ -820,10 +821,16 @@ error. Example: >
For loop ~
-The loop variable must not exist yet: >
+The loop variable must not be declared yet: >
var i = 1
for i in [1, 2, 3] # Error!
+It is possible to use a global variable though: >
+ g:i = 1
+ for g:i in [1, 2, 3]
+ echo g:i
+ endfor
+
Legacy Vim script has some tricks to make a for loop over a list handle
deleting items at the current or previous item. In Vim9 script it just uses
the index, if items are deleted then items in the list will be skipped.
diff --git a/runtime/doc/windows.txt b/runtime/doc/windows.txt
index c288377caa..2f608352db 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 Sep 09
+*windows.txt* For Vim version 8.2. Last change: 2021 Nov 29
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1203,6 +1203,8 @@ list of buffers. |unlisted-buffer|
the current buffer remains being edited. See |:buffer-!| for
[!]. This will also edit a buffer that is not in the buffer
list, without setting the 'buflisted' flag.
+ The notation with single quotes does not work here,
+ `:buf 12'345'` uses 12'345 as a buffer name.
Also see |+cmd|.
:[N]b[uffer][!] [+cmd] {bufname} *{bufname}*
diff --git a/runtime/doc/xxd-fr.1 b/runtime/doc/xxd-fr.1
index a50336e17c..e170df5d77 100644
--- a/runtime/doc/xxd-fr.1
+++ b/runtime/doc/xxd-fr.1
@@ -111,7 +111,7 @@ octets.
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
Produit une conversion continue dans le style Postscript (postscript continuous
-hexdumd style).
+hexdump style).
Également connu sous le nom de « conversion brute » (plain hexdump style).
.TP
.IR \-r " | " \-revert
diff --git a/runtime/doc/xxd-fr.UTF-8.1 b/runtime/doc/xxd-fr.UTF-8.1
index c00eff88c1..47773a1363 100644
--- a/runtime/doc/xxd-fr.UTF-8.1
+++ b/runtime/doc/xxd-fr.UTF-8.1
@@ -111,7 +111,7 @@ octets.
.TP
.IR \-p " | " \-ps " | " \-postscript " | " \-plain
Produit une conversion continue dans le style Postscript (postscript continuous
-hexdumd style).
+hexdump style).
Également connu sous le nom de « conversion brute » (plain hexdump style).
.TP
.IR \-r " | " \-revert