diff options
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/eval.txt | 32 | ||||
| -rw-r--r-- | runtime/doc/index.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/insert.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/options.txt | 15 | ||||
| -rw-r--r-- | runtime/doc/pi_netrw.txt | 84 | ||||
| -rw-r--r-- | runtime/doc/popup.txt | 25 | ||||
| -rw-r--r-- | runtime/doc/syntax.txt | 11 | ||||
| -rw-r--r-- | runtime/doc/tags | 5 | ||||
| -rw-r--r-- | runtime/doc/term.txt | 38 | ||||
| -rw-r--r-- | runtime/doc/terminal.txt | 28 | ||||
| -rw-r--r-- | runtime/doc/testing.txt | 24 | ||||
| -rw-r--r-- | runtime/doc/textprop.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/todo.txt | 6 | ||||
| -rw-r--r-- | runtime/doc/version6.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/vim9.txt | 15 |
15 files changed, 214 insertions, 77 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 93ff4169f..e1e9a1b47 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 Aug 13 +*eval.txt* For Vim version 8.2. Last change: 2021 Aug 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -8529,6 +8529,21 @@ pyxeval({expr}) *pyxeval()* < {only available when compiled with the |+python| or the |+python3| feature} +rand([{expr}]) *rand()* *random* + Return a pseudo-random Number generated with an xoshiro128** + algorithm using seed {expr}. The returned number is 32 bits, + also on 64 bits systems, for consistency. + {expr} can be initialized by |srand()| and will be updated by + rand(). If {expr} is omitted, an internal seed value is used + and updated. + + Examples: > + :echo rand() + :let seed = srand() + :echo rand(seed) + :echo rand(seed) % 16 " random number 0 - 15 +< + *E726* *E727* range({expr} [, {max} [, {stride}]]) *range()* Returns a |List| with Numbers: @@ -8552,21 +8567,6 @@ range({expr} [, {max} [, {stride}]]) *range()* GetExpr()->range() < -rand([{expr}]) *rand()* *random* - Return a pseudo-random Number generated with an xoshiro128** - algorithm using seed {expr}. The returned number is 32 bits, - also on 64 bits systems, for consistency. - {expr} can be initialized by |srand()| and will be updated by - rand(). If {expr} is omitted, an internal seed value is used - and updated. - - Examples: > - :echo rand() - :let seed = srand() - :echo rand(seed) - :echo rand(seed) % 16 " random number 0 - 15 -< - readblob({fname}) *readblob()* Read file {fname} in binary mode and return a |Blob|. When the file can't be opened an error message is given and diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index 6fdfb854f..683afe45d 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -1,4 +1,4 @@ -*index.txt* For Vim version 8.2. Last change: 2021 Jun 19 +*index.txt* For Vim version 8.2. Last change: 2021 Aug 27 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 7f836e87a..1caf08437 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -1,4 +1,4 @@ -*insert.txt* For Vim version 8.2. Last change: 2021 Jul 31 +*insert.txt* For Vim version 8.2. Last change: 2021 Aug 27 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index a181ecb0d..26b6683fe 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 Jul 22 +*options.txt* For Vim version 8.2. Last change: 2021 Aug 28 VIM REFERENCE MANUAL by Bram Moolenaar @@ -195,11 +195,18 @@ include the "|" in the option value, use "\|" instead. This example sets the This sets the 'titlestring' option to "hi" and 'iconstring' to "there": > :set titlestring=hi|set iconstring=there -Similarly, the double quote character starts a comment. To include the '"' in -the option value, use '\"' instead. This example sets the 'titlestring' -option to 'hi "there"': > +Similarly, in legacy script the double quote character starts a comment. To +include the '"' in the option value, use '\"' instead. This example sets the +'titlestring' option to 'hi "there"': > :set titlestring=hi\ \"there\" +In |Vim9| script it's simpler, comments start with a '#' character, and only +when preceded by white space. A backslash is needed less often: > + vim9script + set titlestring=hi\ "there" + set titlestring=hi#there# + set titlestring=hi\ \#there# + For Win32 backslashes in file names are mostly not removed. More precise: For options that expect a file name (those where environment variables are expanded) a backslash before a normal file name character is not removed. But diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt index 421b12f60..c90e0bccc 100644 --- a/runtime/doc/pi_netrw.txt +++ b/runtime/doc/pi_netrw.txt @@ -1,4 +1,4 @@ -*pi_netrw.txt* For Vim version 8.2. Last change: 2020 Sep 19 +*pi_netrw.txt* For Vim version 8.2. Last change: 2021 Aug 16 ------------------------------------------------ NETRW REFERENCE MANUAL by Charles E. Campbell @@ -54,6 +54,7 @@ Copyright: Copyright (C) 2017 Charles E Campbell *netrw-copyright* Browsing With A Horizontally Split Window...........|netrw-o| Browsing With A New Tab.............................|netrw-t| Browsing With A Vertically Split Window.............|netrw-v| + Change File Permission..............................|netrw-gp| Change Listing Style.(thin wide long tree)..........|netrw-i| Changing To A Bookmarked Directory..................|netrw-gb| Changing To A Predecessor Directory.................|netrw-u| @@ -1095,6 +1096,7 @@ QUICK REFERENCE: MAPS *netrw-browse-maps* {{{2 gf Force treatment as file |netrw-gf| gh Quick hide/unhide of dot-files |netrw-gh| gn Make top of tree the directory below the cursor |netrw-gn| + gp Change local-only file permissions |netrw-gp| i Cycle between thin, long, wide, and tree listings |netrw-i| I Toggle the displaying of the banner |netrw-I| mb Bookmark current directory |netrw-mb| @@ -1510,6 +1512,8 @@ Netrw determines which special handler by the following method: If g:netrw_browsex_viewer == '-', then netrwFileHandlers#Invoke() will be used instead (see |netrw_filehandler|). + If the viewer you wish to use does not support handling of a remote URL + directory, set |g:netrw_browsex_support_remote| to 0. * for Windows 32 or 64, the URL and FileProtocolHandler dlls are used. * for Gnome (with gnome-open): gnome-open is used. * for KDE (with kfmclient) : kfmclient is used @@ -2104,8 +2108,8 @@ the two directories the same, use the "cd" map (type cd). That map will set Vim's notion of the current directory to netrw's current browsing directory. -|netrw-cd|: This map's name was changed from "c" to cd (see |netrw-cd|). - This change was done to allow for |netrw-cb| and |netrw-cB| maps. +|netrw-cd| : This map's name was changed from "c" to cd (see |netrw-cd|). + This change was done to allow for |netrw-cb| and |netrw-cB| maps. Associated setting variable: |g:netrw_keepdir| @@ -2607,13 +2611,29 @@ your browsing preferences. (see also: |netrw-settings|) a script/function to handle the given extension. (see |netrw_filehandler|). + *g:netrw_browsex_support_remote* + specify if the specified viewer supports a + remote URL. (see |netrw-handler|). + *g:netrw_chgperm* Unix/Linux: "chmod PERM FILENAME" Windows: "cacls FILENAME /e /p PERM" Used to change access permission for a file. + *g:netrw_clipboard* =1 + By default, netrw will attempt to insure that + the clipboard's values will remain unchanged. + However, some users report that they have + speed problems with this; consequently, this + option, when set to zero, lets such users + prevent netrw from saving and restoring the + clipboard (the latter is done only as needed). + That means that if the clipboard is changed + (inadvertently) by normal netrw operation that + it will not be restored to its prior state. + *g:netrw_compress* ="gzip" - Will compress marked files with this - command + Will compress marked files with this + command *g:Netrw_corehandler* Allows one to specify something additional to do when handling <core> files via netrw's @@ -2639,12 +2659,23 @@ your browsing preferences. (see also: |netrw-settings|) =2 cul u-cuc cul u-cuc =3 cul u-cuc cul cuc =4 cul cuc cul cuc + =5 U-cul U-cuc U-cul U-cuc + =6 U-cul U-cuc cul U-cuc + =7 cul U-cuc cul U-cuc + =8 cul U-cuc cul cuc Where - u-cul : user's |'cursorline'| setting used - u-cuc : user's |'cursorcolumn'| setting used - cul : |'cursorline'| locally set - cuc : |'cursorcolumn'| locally set + u-cul : user's |'cursorline'| initial setting used + u-cuc : user's |'cursorcolumn'| initial setting used + U-cul : user's |'cursorline'| current setting used + U-cuc : user's |'cursorcolumn'| current setting used + cul : |'cursorline'| will be locally set + cuc : |'cursorcolumn'| will be locally set + + The "initial setting" means the values of + the |'cuc'| and |'cul'| settings in effect when + netrw last saw |g:netrw_cursor| >= 5 or when + netrw was initially run. *g:netrw_decompress* = { ".gz" : "gunzip" , ".bz2" : "bunzip2" , @@ -2654,7 +2685,7 @@ your browsing preferences. (see also: |netrw-settings|) decompression programs. *g:netrw_dirhistmax* =10: controls maximum quantity of past - history. May be zero to supppress + history. May be zero to suppress history. (related: |netrw-qb| |netrw-u| |netrw-U|) @@ -3142,6 +3173,9 @@ To open a new file in netrw's current directory, press "%". This map will query the user for a new filename; an empty file by that name will be placed in the netrw's current directory (ie. b:netrw_curdir). +If Lexplore (|netrw-:Lexplore|) is in use, the new file will be generated +in the |g:netrw_chgwin| window. + Related topics: |netrw-d| @@ -3809,7 +3843,7 @@ netrw: Decho.vim is provided as a "vimball"; see |vimball-intro|. You should edit the Decho.vba.gz file and source it in: > - vim Decho.vba.gz + vim Decho.vba.gz :so % :q < @@ -3877,6 +3911,32 @@ netrw: ============================================================================== 12. History *netrw-history* {{{1 + v171: Oct 09, 2020 * included code in s:NetrwOptionsSafe() + to allow |'bh'| to be set to delete when + rather than hide when g:netrw_fastbrowse + was zero. + * Installed |g:netrw_clipboard| setting + * Installed option bypass for |'guioptions'| + a/A settings + * Changed popup_beval() to |popup_atcursor|() + in netrw#ErrorMsg (lacygoill). Apparently + popup_beval doesn't reliably close the + popup when the mouse is moved. + * VimEnter() now using win_execute to examine + buffers for an attempt to open a directory. + Avoids issues with popups/terminal from + command line. (lacygoill) + Jun 28, 2021 * (zeertzjq) provided a patch for use of + xmap,xno instead of vmap,vno in + netrwPlugin.vim. Avoids entanglement with + select mode. + Jul 14, 2021 * Fixed problem addressed by tst976; opening + a file using tree mode, going up a + directory, and opening a file there was + opening the file in the wrong directory. + Jul 28, 2021 * (Ingo Karkat) provided a patch fixing an + E488 error with netrwPlugin.vim + (occurred for vim versions < 8.02) v170: Mar 11, 2020 * (reported by Reiner Herrmann) netrw+tree would not hide with the ^\..* pattern correctly. @@ -3893,7 +3953,7 @@ netrw: Jun 07, 2020 * (reported by Jo Totland) repeatedly invoking :Lexplore and quitting it left unused hidden buffers. Netrw will now set netrw - buffers created by :Lexplore to |bh|=wipe. + buffers created by :Lexplore to |'bh'|=wipe. v169: Dec 20, 2019 * (reported by amkarthik) that netrw's x (|netrw-x|) would throw an error when attempting to open a local directory. diff --git a/runtime/doc/popup.txt b/runtime/doc/popup.txt index c582d4c37..af7dc7098 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 03 +*popup.txt* For Vim version 8.2. Last change: 2021 Aug 15 VIM REFERENCE MANUAL by Bram Moolenaar @@ -260,6 +260,7 @@ popup_close({id} [, {result}]) *popup_close()* Can also be used as a |method|: > GetPopup()->popup_close() + popup_create({what}, {options}) *popup_create()* Open a popup window showing {what}, which is either: - a buffer number @@ -284,6 +285,7 @@ popup_create({what}, {options}) *popup_create()* Can also be used as a |method|: > GetText()->popup_create({}) + popup_dialog({what}, {options}) *popup_dialog()* Just like |popup_create()| but with these default options: > call popup_create({what}, #{ @@ -307,6 +309,7 @@ popup_dialog({what}, {options}) *popup_dialog()* Can also be used as a |method|: > GetText()->popup_dialog({}) + popup_filter_menu({id}, {key}) *popup_filter_menu()* Filter that can be used for a popup. These keys can be used: j <Down> <C-N> select item below @@ -386,6 +389,7 @@ popup_getoptions({id}) *popup_getoptions()* Can also be used as a |method|: > GetPopup()->popup_getoptions() + popup_getpos({id}) *popup_getpos()* Return the position and size of popup {id}. Returns a Dict with these entries: @@ -414,6 +418,7 @@ popup_getpos({id}) *popup_getpos()* Can also be used as a |method|: > GetPopup()->popup_getpos() + popup_hide({id}) *popup_hide()* If {id} is a displayed popup, hide it now. If the popup has a filter it will not be invoked for so long as the popup is @@ -425,6 +430,7 @@ popup_hide({id}) *popup_hide()* Can also be used as a |method|: > GetPopup()->popup_hide() + popup_list() *popup_list()* Return a List with the |window-ID| of all existing popups. @@ -468,6 +474,7 @@ popup_menu({what}, {options}) *popup_menu()* < Can also be used as a |method|: > GetChoices()->popup_menu({}) + popup_move({id}, {options}) *popup_move()* Move popup {id} to the position specified with {options}. {options} may contain the items from |popup_create()| that @@ -486,6 +493,7 @@ popup_move({id}, {options}) *popup_move()* Can also be used as a |method|: > GetPopup()->popup_move(options) + popup_notification({what}, {options}) *popup_notification()* Show the {what} for 3 seconds at the top of the Vim window. This works like: > @@ -515,12 +523,6 @@ popup_notification({what}, {options}) *popup_notification()* Can also be used as a |method|: > GetText()->popup_notification({}) -popup_show({id}) *popup_show()* - If {id} is a hidden popup, show it now. - For {id} see `popup_hide()`. - If {id} is the info popup it will be positioned next to the - current popup menu item. - popup_setoptions({id}, {options}) *popup_setoptions()* Override options in popup {id} with entries in {options}. @@ -557,6 +559,7 @@ popup_setoptions({id}, {options}) *popup_setoptions()* Can also be used as a |method|: > GetPopup()->popup_setoptions(options) + popup_settext({id}, {text}) *popup_settext()* Set the text of the buffer in popup win {id}. {text} is the same as supplied to |popup_create()|, except that a buffer @@ -567,6 +570,14 @@ popup_settext({id}, {text}) *popup_settext()* Can also be used as a |method|: > GetPopup()->popup_settext('hello') + +popup_show({id}) *popup_show()* + If {id} is a hidden popup, show it now. + For {id} see `popup_hide()`. + If {id} is the info popup it will be positioned next to the + current popup menu item. + + ============================================================================== 3. Usage *popup-usage* diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt index e781f99bc..1ade9e99d 100644 --- a/runtime/doc/syntax.txt +++ b/runtime/doc/syntax.txt @@ -1,4 +1,4 @@ -*syntax.txt* For Vim version 8.2. Last change: 2021 Jul 02 +*syntax.txt* For Vim version 8.2. Last change: 2021 Aug 16 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1132,11 +1132,13 @@ The ColdFusion syntax file is based on the HTML syntax file. CPP *cpp.vim* *ft-cpp-syntax* -Most of things are same as |ft-c-syntax|. +Most things are the same as |ft-c-syntax|. Variable Highlight ~ cpp_no_cpp11 don't highlight C++11 standard items cpp_no_cpp14 don't highlight C++14 standard items +cpp_no_cpp17 don't highlight C++17 standard items +cpp_no_cpp20 don't highlight C++20 standard items CSH *csh.vim* *ft-csh-syntax* @@ -5201,9 +5203,8 @@ LineNrAbove Line number for when the 'relativenumber' LineNrBelow Line number for when the 'relativenumber' option is set, below the cursor line. *hl-CursorLineNr* -CursorLineNr Like LineNr when 'cursorline' is set and 'cursorlineopt' is - set to "number" or "both", or 'relativenumber' is set, for - the cursor line. +CursorLineNr Like LineNr when 'cursorline' is set and 'cursorlineopt' + contains "number" or is "both", for the cursor line. *hl-MatchParen* MatchParen The character under the cursor or just before it, if it is a paired bracket, and its match. |pi_paren.txt| diff --git a/runtime/doc/tags b/runtime/doc/tags index 3682a404b..aa7475f8f 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -6834,10 +6834,12 @@ g:netrw_altv pi_netrw.txt /*g:netrw_altv* g:netrw_banner pi_netrw.txt /*g:netrw_banner* g:netrw_bannerbackslash pi_netrw.txt /*g:netrw_bannerbackslash* g:netrw_browse_split pi_netrw.txt /*g:netrw_browse_split* +g:netrw_browsex_support_remote pi_netrw.txt /*g:netrw_browsex_support_remote* g:netrw_browsex_viewer pi_netrw.txt /*g:netrw_browsex_viewer* g:netrw_bufsettings pi_netrw.txt /*g:netrw_bufsettings* g:netrw_chgperm pi_netrw.txt /*g:netrw_chgperm* g:netrw_chgwin pi_netrw.txt /*g:netrw_chgwin* +g:netrw_clipboard pi_netrw.txt /*g:netrw_clipboard* g:netrw_compress pi_netrw.txt /*g:netrw_compress* g:netrw_ctags pi_netrw.txt /*g:netrw_ctags* g:netrw_cursor pi_netrw.txt /*g:netrw_cursor* @@ -8625,6 +8627,7 @@ prompt_setprompt() eval.txt /*prompt_setprompt()* promptbuffer-functions usr_41.txt /*promptbuffer-functions* pronounce intro.txt /*pronounce* prop_add() textprop.txt /*prop_add()* +prop_add_list() textprop.txt /*prop_add_list()* prop_clear() textprop.txt /*prop_clear()* prop_find() textprop.txt /*prop_find()* prop_list() textprop.txt /*prop_list()* @@ -9788,6 +9791,7 @@ timestamps editing.txt /*timestamps* tips tips.txt /*tips* tips.txt tips.txt /*tips.txt* tmux syntax.txt /*tmux* +tmux-integration term.txt /*tmux-integration* todo todo.txt /*todo* todo.txt todo.txt /*todo.txt* toggle options.txt /*toggle* @@ -10215,6 +10219,7 @@ vim9-lambda vim9.txt /*vim9-lambda* vim9-lambda-arguments vim9.txt /*vim9-lambda-arguments* vim9-mix vim9.txt /*vim9-mix* vim9-namespace vim9.txt /*vim9-namespace* +vim9-no-dict-function vim9.txt /*vim9-no-dict-function* vim9-rationale vim9.txt /*vim9-rationale* vim9-reload vim9.txt /*vim9-reload* vim9-scopes vim9.txt /*vim9-scopes* diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt index 811d50752..d6f31d379 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 Jan 14 +*term.txt* For Vim version 8.2. Last change: 2021 Aug 29 VIM REFERENCE MANUAL by Bram Moolenaar @@ -127,6 +127,37 @@ automatically, you can try using something like this: > exec "set t_PE=\e[201~" endif < + *tmux-integration* +If you experience issues when running Vim inside tmux, here are a few hints. +You can comment-out parts if something doesn't work (it may depend on the +terminal that tmux is running in): > + + if !has('gui_running') && &term =~ '^\%(screen\|tmux\)' + " Better mouse support, see :help 'ttymouse' + set ttymouse=sgr + + " Enable true colors, see :help xterm-true-color + let &termguicolors = v:true + let &t_8f = "\<Esc>[38;2;%lu;%lu;%lum" + let &t_8b = "\<Esc>[48;2;%lu;%lu;%lum" + + " Enable bracketed paste mode, see :help xterm-bracketed-paste + let &t_BE = "\<Esc>[?2004h" + let &t_BD = "\<Esc>[?2004l" + let &t_PS = "\<Esc>[200~" + let &t_PE = "\<Esc>[201~" + + " Enable focus event tracking, see :help xterm-focus-event + let &t_fe = "\<Esc>[?1004h" + let &t_fd = "\<Esc>[?1004l" + + " Enable modified arrow keys, see :help xterm-modifier-keys + execute "silent! set <xUp>=\<Esc>[@;*A" + execute "silent! set <xDown>=\<Esc>[@;*B" + execute "silent! set <xRight>=\<Esc>[@;*C" + execute "silent! set <xLeft>=\<Esc>[@;*D" + endif +< *cs7-problem* Note: If the terminal settings are changed after running Vim, you might have an illegal combination of settings. This has been reported on Solaris 2.5 @@ -559,6 +590,11 @@ Focus event tracking is disabled by a 't_fd' sequence when exiting "raw" mode. If you would like to disable this feature, add the following to your .vimrc: `set t_fd=` `set t_fe=` +If your terminal does support this but Vim does not recognize the terminal, +you may have to set the options yourself: > + let &t_fe = "\<Esc>[?1004h" + let &t_fd = "\<Esc>[?1004l" +If this causes garbage to show when Vim starts up then it doesn't work. *termcap-colors* Note about colors: The 't_Co' option tells Vim the number of colors available. diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt index 15e93573f..2f2556a50 100644 --- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 8.2. Last change: 2021 Aug 10 +*terminal.txt* For Vim version 8.2. Last change: 2021 Aug 15 VIM REFERENCE MANUAL by Bram Moolenaar @@ -752,18 +752,6 @@ term_sendkeys({buf}, {keys}) *term_sendkeys()* GetBufnr()->term_sendkeys(keys) -term_setapi({buf}, {expr}) *term_setapi()* - Set the function name prefix to be used for the |terminal-api| - function in terminal {buf}. For example: > - :call term_setapi(buf, "Myapi_") - :call term_setapi(buf, "") -< - The default is "Tapi_". When {expr} is an empty string then - no |terminal-api| function can be used for {buf}. - - When used as a method the base is used for {buf}: > - GetBufnr()->term_setapi({expr}) - term_setansicolors({buf}, {colors}) *term_setansicolors()* Set the ANSI color palette used by terminal {buf}. {colors} must be a List of 16 valid color names or hexadecimal @@ -799,6 +787,20 @@ term_setansicolors({buf}, {colors}) *term_setansicolors()* < {only available with GUI enabled and/or the |+termguicolors| feature} + +term_setapi({buf}, {expr}) *term_setapi()* + Set the function name prefix to be used for the |terminal-api| + function in terminal {buf}. For example: > + :call term_setapi(buf, "Myapi_") + :call term_setapi(buf, "") +< + The default is "Tapi_". When {expr} is an empty string then + no |terminal-api| function can be used for {buf}. + + When used as a method the base is used for {buf}: > + GetBufnr()->term_setapi({expr}) + + term_setkill({buf}, {how}) *term_setkill()* When exiting Vim or trying to close the terminal window in another way, {how} defines whether the job in the terminal can diff --git a/runtime/doc/testing.txt b/runtime/doc/testing.txt index 18f6b19d8..5094d51fd 100644 --- a/runtime/doc/testing.txt +++ b/runtime/doc/testing.txt @@ -1,4 +1,4 @@ -*testing.txt* For Vim version 8.2. Last change: 2021 Jul 07 +*testing.txt* For Vim version 8.2. Last change: 2021 Aug 15 VIM REFERENCE MANUAL by Bram Moolenaar @@ -46,6 +46,7 @@ test_alloc_fail({id}, {countdown}, {repeat}) *test_alloc_fail()* Can also be used as a |method|: > GetAllocId()->test_alloc_fail() + test_autochdir() *test_autochdir()* Set a flag to enable the effect of 'autochdir' before Vim startup has finished. @@ -59,6 +60,7 @@ test_feedinput({string}) *test_feedinput()* Can also be used as a |method|: > GetText()->test_feedinput() + test_garbagecollect_now() *test_garbagecollect_now()* Like garbagecollect(), but executed right away. This must only be called directly to avoid any structure to exist @@ -132,6 +134,7 @@ test_ignore_error({expr}) *test_ignore_error()* Can also be used as a |method|: > GetErrorText()->test_ignore_error() + test_null_blob() *test_null_blob()* Return a |Blob| that is null. Only useful for testing. @@ -166,13 +169,6 @@ test_null_string() *test_null_string()* Return a |String| that is null. Only useful for testing. -test_unknown() *test_unknown()* - Return a value with unknown type. Only useful for testing. - -test_void() *test_void()* - Return a value with void type. Only useful for testing. - - test_option_not_set({name}) *test_option_not_set()* Reset the flag that indicates option {name} was set. Thus it looks like it still has the default value. Use like this: > @@ -224,6 +220,7 @@ test_override({name}, {val}) *test_override()* < Can also be used as a |method|: > GetOverrideVal()-> test_override('starting') + test_refcount({expr}) *test_refcount()* Return the reference count of {expr}. When {expr} is of a type that does not have a reference count, returns -1. Only @@ -253,6 +250,7 @@ test_scrollbar({which}, {value}, {dragging}) *test_scrollbar()* Can also be used as a |method|: > GetValue()->test_scrollbar('right', 0) + test_setmouse({row}, {col}) *test_setmouse()* Set the mouse position to be used for the next mouse action. {row} and {col} are one based. @@ -260,6 +258,7 @@ test_setmouse({row}, {col}) *test_setmouse()* call test_setmouse(4, 20) call feedkeys("\<LeftMouse>", "xt") + test_settime({expr}) *test_settime()* Set the time Vim uses internally. Currently only used for timestamps in the history, as they are used in viminfo, and @@ -272,10 +271,19 @@ test_settime({expr}) *test_settime()* Can also be used as a |method|: > GetTime()->test_settime() + test_srand_seed([seed]) *test_srand_seed()* When [seed] is given this sets the seed value used by `srand()`. When omitted the test seed is removed. + +test_unknown() *test_unknown()* + Return a value with unknown type. Only useful for testing. + + +test_void() *test_void()* + Return a value with void type. Only useful for testing. + ============================================================================== 3. Assert functions *assert-functions-details* diff --git a/runtime/doc/textprop.txt b/runtime/doc/textprop.txt index c742293db..ac0d3108e 100644 --- a/runtime/doc/textprop.txt +++ b/runtime/doc/textprop.txt @@ -1,4 +1,4 @@ -*textprop.txt* For Vim version 8.2. Last change: 2021 May 26 +*textprop.txt* For Vim version 8.2. Last change: 2021 Aug 16 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt index e1e530bec..b7972c071 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 Aug 14 +*todo.txt* For Vim version 8.2. Last change: 2021 Aug 25 VIM REFERENCE MANUAL by Bram Moolenaar @@ -44,6 +44,7 @@ Vim9 - Make everything work: - For builtin functions using tv_get_string*() use check_for_string() to be more strict about the argument type (not a bool). done: balloon_() +- Disallow using numbered function with "g:123" in Vim9 script? #8760 - Check many more builtin function arguments at compile time. map() could check that the return type of the function argument matches the type of the list or dict member. (#8092) @@ -75,6 +76,7 @@ Further Vim9 improvements, possibly after launch: evaluation. Use the location where the option was set for deciding whether it's to be evaluated in Vim9 script context. +- Handle command that is only a range more efficient than calling ISN_EXEC - implement :type, "import type" - implement enum, "import enum". - implement class and interface: See |vim9-classes| @@ -241,6 +243,8 @@ Memory leak in test_alot with pyeval() (allocating partial) Memory leak in test_alot with expand() Memory leaks in test_channel? (or is it because of fork()) +Idea: when typing ":e /some/dir/" and "dir" does not exist, highlight in red. + ":set &shellpipe" and ":set &shellredir" should use the logic from initialization to figure out the default value from 'shell'. Add a test for this. diff --git a/runtime/doc/version6.txt b/runtime/doc/version6.txt index 27e4d66c2..43775bdf6 100644 --- a/runtime/doc/version6.txt +++ b/runtime/doc/version6.txt @@ -12232,7 +12232,7 @@ Files: Makefile, src/gvim.exe.mnf, src/vim.rc Patch 6.2.348 Problem: Win32: "vim c:\dir\(test)" doesn't work, because the 'isfname' - default value doesn't contain parenthesis. + default value doesn't contain parentheses. Solution: Temporarily add '(' and ')' to 'isfname' when expanding file name arguments. Files: src/main.c diff --git a/runtime/doc/vim9.txt b/runtime/doc/vim9.txt index 1628e9cb8..346189b05 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 Aug 11 +*vim9.txt* For Vim version 8.2. Last change: 2021 Aug 23 VIM REFERENCE MANUAL by Bram Moolenaar @@ -106,6 +106,9 @@ script and `:def` functions; details are below: or curly-braces names. - A range before a command must be prefixed with a colon: > :%s/this/that +- Executing a register with "@r" does not work, you can prepend a colon or use + `:exe`: > + :exe @a - Unless mentioned specifically, the highest |scriptversion| is used. @@ -154,7 +157,7 @@ Compilation is done when any of these is encountered: function was defined - `:disassemble` is used for the function. - a function that is compiled calls the function or uses it as a function - reference + reference (so that the argument and return types can be checked) *E1091* If compilation fails it is not tried again on the next call, instead this error is given: "E1091: Function is not compiled: {name}". @@ -168,7 +171,7 @@ created yet. In this case you can call `execute()` to invoke it at runtime. > "closure". A `:def` function always aborts on an error (unless `:silent!` was used for the command or inside a `:try` block), does not get a range passed cannot be a "dict" function, and can always be a closure. - + *vim9-no-dict-function* Later classes will be added, which replaces the "dict function" mechanism. For now you will need to pass the dictionary explicitly: > def DictFunc(d: dict<any>, arg: string) @@ -477,7 +480,7 @@ use the command instead: > If the expression starts with "!" this is interpreted as a shell command, not negation of a condition. Thus this is a shell command: > !shellCommand->something -Put the expression in parenthesis to use the "!" for negation: > +Put the expression in parentheses to use the "!" for negation: > (!expression)->Method() Note that while variables need to be defined before they can be used, @@ -741,8 +744,8 @@ White space is not allowed: arg # OK ) -White space space is not allowed in a `:set` command between the option name -and a following "&", "!", "<", "=", "+=", "-=" or "^=". +White space is not allowed in a `:set` command between the option name and a +following "&", "!", "<", "=", "+=", "-=" or "^=". No curly braces expansion ~ |