diff options
66 files changed, 1313 insertions, 508 deletions
diff --git a/runtime/autoload/dist/ft.vim b/runtime/autoload/dist/ft.vim index fd14062356..dc5ef8d2b7 100644 --- a/runtime/autoload/dist/ft.vim +++ b/runtime/autoload/dist/ft.vim @@ -3,7 +3,7 @@ vim9script # Vim functions for file type detection # # Maintainer: Bram Moolenaar <Bram@vim.org> -# Last Change: 2022 Mar 05 +# Last Change: 2022 Apr 06 # These functions are moved here from runtime/filetype.vim to make startup # faster. diff --git a/runtime/doc/autocmd.txt b/runtime/doc/autocmd.txt index beb1f2e3ad..8421f77afe 100644 --- a/runtime/doc/autocmd.txt +++ b/runtime/doc/autocmd.txt @@ -1,4 +1,4 @@ -*autocmd.txt* For Vim version 8.2. Last change: 2022 Mar 27 +*autocmd.txt* For Vim version 8.2. Last change: 2022 Apr 08 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index 08872d04e2..4fb12ff865 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 8.2. Last change: 2022 Mar 26 +*builtin.txt* For Vim version 8.2. Last change: 2022 Apr 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1754,7 +1754,10 @@ deepcopy({expr} [, {noref}]) *deepcopy()* *E698* delete({fname} [, {flags}]) *delete()* Without {flags} or with {flags} empty: Deletes the file by the - name {fname}. This also works when {fname} is a symbolic link. + name {fname}. + + This also works when {fname} is a symbolic link. The symbolic + link itself is deleted, not what it points to. When {flags} is "d": Deletes the directory by the name {fname}. This fails when directory {fname} is not empty. @@ -1764,8 +1767,6 @@ delete({fname} [, {flags}]) *delete()* Note: on MS-Windows it is not possible to delete a directory that is being used. - A symbolic link itself is deleted, not what it points to. - The result is a Number, which is 0/false if the delete operation was successful and -1/true when the deletion failed or partly failed. @@ -2741,7 +2742,7 @@ foreground() Move the Vim window to the foreground. Useful when sent from On Win32 systems this might not work, the OS does not always allow a window to bring itself to the foreground. Use |remote_foreground()| instead. - {only in the Win32, Athena, Motif and GTK GUI versions and the + {only in the Win32, Motif and GTK GUI versions and the Win32 console version} fullcommand({name}) *fullcommand()* @@ -4833,6 +4834,8 @@ json_encode({expr}) *json_encode()* Note that NaN and Infinity are passed on as values. This is missing in the JSON standard, but several implementations do allow it. If not then you will get an error. + If a string contains an illegal character then the replacement + character 0xfffd is used. Can also be used as a |method|: > GetObject()->json_encode() @@ -6023,8 +6026,10 @@ printf({fmt}, {expr1} ...) *printf()* When used as a |method| the base is passed as the second argument: > Compute()->printf("result: %d") +< + You can use `call()` to pass the items as a list. -< Often used items are: + Often used items are: %s string %6S string right-aligned in 6 display cells %6s string right-aligned in 6 bytes @@ -6693,7 +6698,7 @@ remote_foreground({server}) *remote_foreground()* Can also be used as a |method|: > ServerName()->remote_foreground() -< {only in the Win32, Athena, Motif and GTK GUI versions and the +< {only in the Win32, Motif and GTK GUI versions and the Win32 console version} @@ -10025,7 +10030,7 @@ footer Compiled with GUI footer support. |gui-footer| fork Compiled to use fork()/exec() instead of system(). gettext Compiled with message translation |multi-lang| gui Compiled with GUI enabled. -gui_athena Compiled with Athena GUI. +gui_athena Compiled with Athena GUI (always false). gui_gnome Compiled with Gnome support (gui_gtk is also defined). gui_gtk Compiled with GTK+ GUI (any version). gui_gtk2 Compiled with GTK+ 2 GUI (gui_gtk is also defined). diff --git a/runtime/doc/channel.txt b/runtime/doc/channel.txt index 47cda3ff10..a306abb488 100644 --- a/runtime/doc/channel.txt +++ b/runtime/doc/channel.txt @@ -1,4 +1,4 @@ -*channel.txt* For Vim version 8.2. Last change: 2022 Mar 26 +*channel.txt* For Vim version 8.2. Last change: 2022 Apr 05 VIM REFERENCE MANUAL by Bram Moolenaar @@ -588,7 +588,7 @@ ch_info({handle}) *ch_info()* "sock_io" "socket" "sock_timeout" timeout in msec - Note that "pair" is only present for Unix-domain sockets, for + Note that "path" is only present for Unix-domain sockets, for regular ones "hostname" and "port" are present instead. When opened with job_start(): diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt index 10ea783819..2bba058a78 100644 --- a/runtime/doc/editing.txt +++ b/runtime/doc/editing.txt @@ -1,4 +1,4 @@ -*editing.txt* For Vim version 8.2. Last change: 2022 Feb 16 +*editing.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1235,7 +1235,7 @@ If you want to always use ":confirm", set the 'confirm' option. |:diffsplit|, |:diffpatch|, |:open|, |:pedit|, |:redir|, |:source|, |:update|, |:visual|, |:vsplit|, and |:qall| if 'confirm' is set. - {only in Win32, Athena, Motif, GTK and Mac GUI, in + {only in Win32, Motif, GTK and Mac GUI, in console `browse edit` works if the FileExplorer autocommand group exists} When ":browse" is not possible you get an error diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index 48cef5c09f..fa3e8e944d 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 8.2. Last change: 2022 Mar 05 +*eval.txt* For Vim version 8.2. Last change: 2022 Apr 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -261,7 +261,7 @@ position in the sequence. List creation ~ *E696* *E697* -A List is created with a comma separated list of items in square brackets. +A List is created with a comma-separated list of items in square brackets. Examples: > :let mylist = [1, two, 3, "four"] :let emptylist = [] @@ -514,7 +514,7 @@ ordering. Dictionary creation ~ *E720* *E721* *E722* *E723* -A Dictionary is created with a comma separated list of entries in curly +A Dictionary is created with a comma-separated list of entries in curly braces. Each entry has a key and a value, separated by a colon. Each key can only appear once. Examples: > :let mydict = {1: 'one', 2: 'two', 3: 'three'} diff --git a/runtime/doc/filetype.txt b/runtime/doc/filetype.txt index d52103e0f2..aa8e995eae 100644 --- a/runtime/doc/filetype.txt +++ b/runtime/doc/filetype.txt @@ -1,4 +1,4 @@ -*filetype.txt* For Vim version 8.2. Last change: 2022 Jan 21 +*filetype.txt* For Vim version 8.2. Last change: 2022 Apr 07 VIM REFERENCE MANUAL by Bram Moolenaar @@ -142,6 +142,7 @@ variables can be used to overrule the filetype used for certain extensions: *.asm g:asmsyntax |ft-asm-syntax| *.asp g:filetype_asp |ft-aspvbs-syntax| |ft-aspperl-syntax| *.bas g:filetype_bas |ft-basic-syntax| + *.dat g:filetype_dat *.frm g:filetype_frm |ft-form-syntax| *.fs g:filetype_fs |ft-forth-syntax| *.i g:filetype_i |ft-progress-syntax| @@ -151,10 +152,15 @@ variables can be used to overrule the filetype used for certain extensions: *.pl g:filetype_pl *.pp g:filetype_pp |ft-pascal-syntax| *.prg g:filetype_prg + *.src g:filetype_src *.sh g:bash_is_sh |ft-sh-syntax| *.tex g:tex_flavor |ft-tex-plugin| *.w g:filetype_w |ft-cweb-syntax| +For a few filetypes the global variable is used only when the filetype could +not be detected: + *.r g:filetype_r |ft-rexx-syntax| + *filetype-ignore* To avoid that certain files are being inspected, the g:ft_ignore_pat variable is used. The default value is set like this: > diff --git a/runtime/doc/ft_sql.txt b/runtime/doc/ft_sql.txt index a428f11b8e..dde456aa43 100644 --- a/runtime/doc/ft_sql.txt +++ b/runtime/doc/ft_sql.txt @@ -1,4 +1,4 @@ -*ft_sql.txt* For Vim version 8.2. Last change: 2019 Dec 07 +*ft_sql.txt* For Vim version 8.2. Last change: 2022 Apr 06 by David Fishburn @@ -559,7 +559,7 @@ the SQL completion plugin. > < 1. After typing SELECT press <C-C>t to display a list of tables. 2. Highlight the table you need the column list for. 3. Press <Enter> to choose the table from the list. - 4. Press <C-C>l to request a comma separated list of all columns + 4. Press <C-C>l to request a comma-separated list of all columns for this table. 5. Based on the table name chosen in step 3, the plugin attempts to decide on a reasonable table alias. You are then prompted to @@ -613,7 +613,7 @@ your |vimrc|: > > omni_sql_use_tbl_alias < - Default: a - - This setting is only used when generating a comma separated + - This setting is only used when generating a comma-separated column list. By default the map is <C-C>l. When generating a column list, an alias can be prepended to the beginning of each column, for example: e.emp_id, e.emp_name. This option has three @@ -697,9 +697,9 @@ plugin. > <C-C>c < - Displays a list of columns for a specific table. > <C-C>l -< - Displays a comma separated list of columns for a specific table. > +< - Displays a comma-separated list of columns for a specific table. > <C-C>L -< - Displays a comma separated list of columns for a specific table. +< - Displays a comma-separated list of columns for a specific table. This should only be used when the completion window is active. > <Right> < - Displays a list of columns for the table currently highlighted in diff --git a/runtime/doc/gui.txt b/runtime/doc/gui.txt index df812c9e72..8746ecd76c 100644 --- a/runtime/doc/gui.txt +++ b/runtime/doc/gui.txt @@ -1,4 +1,4 @@ -*gui.txt* For Vim version 8.2. Last change: 2022 Mar 02 +*gui.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/indent.txt b/runtime/doc/indent.txt index 69a03f977d..dfee7f584d 100644 --- a/runtime/doc/indent.txt +++ b/runtime/doc/indent.txt @@ -1,4 +1,4 @@ -*indent.txt* For Vim version 8.2. Last change: 2022 Jan 31 +*indent.txt* For Vim version 8.2. Last change: 2022 Apr 07 VIM REFERENCE MANUAL by Bram Moolenaar diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt index 6ff7d453bf..d8bddce650 100644 --- a/runtime/doc/insert.txt +++ b/runtime/doc/insert.txt @@ -1,4 +1,4 @@ -*insert.txt* For Vim version 8.2. Last change: 2022 Mar 28 +*insert.txt* For Vim version 8.2. Last change: 2022 Apr 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -272,7 +272,7 @@ CTRL-] Trigger abbreviation, without inserting a character. *i_backspacing* The effect of the <BS>, CTRL-W, and CTRL-U depend on the 'backspace' option -(unless 'revins' is set). This is a comma separated list of items: +(unless 'revins' is set). This is a comma-separated list of items: item action ~ indent allow backspacing over autoindent @@ -1196,7 +1196,7 @@ three lines, but 'previewheight' is used when it has a value of 1 or 2. *complete-popup* When "popup" is in 'completeopt' a popup window is used to display the "info". Then the 'completepopup' option specifies the properties of the popup. This -is used when the info popup is created. The option is a comma separated list +is used when the info popup is created. The option is a comma-separated list of values: height maximum height of the popup width maximum width of the popup diff --git a/runtime/doc/intro.txt b/runtime/doc/intro.txt index fd8cc59901..9feb5b73e4 100644 --- a/runtime/doc/intro.txt +++ b/runtime/doc/intro.txt @@ -1,4 +1,4 @@ -*intro.txt* For Vim version 8.2. Last change: 2022 Mar 03 +*intro.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Bram Moolenaar @@ -213,7 +213,7 @@ Vim would never have become what it is now, without the help of these people! Daniel Elstner GTK+ 2 port Eric Fischer Mac port, 'cindent', and other improvements Benji Fisher Answering lots of user questions - Bill Foster Athena GUI port + Bill Foster Athena GUI port (later removed) Google Lets me work on Vim one day a week Loic Grenie xvim (ideas for multi windows version) Sven Guckes Vim promoter and previous WWW page maintainer diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index 1c852d5b2f..6b9eb57968 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1,4 +1,4 @@ -*map.txt* For Vim version 8.2. Last change: 2022 Mar 03 +*map.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Bram Moolenaar @@ -697,6 +697,10 @@ The special key name "<Plug>" can be used for an internal mapping, which is not to be matched with any key sequence. This is useful in plugins |using-<Plug>|. + *<MouseMove>* +The special key name "<MouseMove>" can be used to handle mouse movement. It +needs to be enabled with 'mousemoveevent'. Currently only works in the GUI. + *<Char>* *<Char->* To map a character by its decimal, octal or hexadecimal number the <Char> construct can be used: diff --git a/runtime/doc/mbyte.txt b/runtime/doc/mbyte.txt index 165e931204..74bd24d512 100644 --- a/runtime/doc/mbyte.txt +++ b/runtime/doc/mbyte.txt @@ -1,4 +1,4 @@ -*mbyte.txt* For Vim version 8.2. Last change: 2022 Jan 20 +*mbyte.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Bram Moolenaar et al. @@ -702,7 +702,7 @@ USING RESOURCE FILES Instead of specifying 'guifontset', you can set X11 resources and Vim will pick them up. This is only for people who know how X resource files work. -For Motif and Athena insert these three lines in your $HOME/.Xdefaults file: +For Motif insert these three lines in your $HOME/.Xdefaults file: Vim.font: |base_font_name_list| Vim*fontSet: |base_font_name_list| @@ -1280,7 +1280,7 @@ internally. Vim has comprehensive UTF-8 support. It works well in: - xterm with UTF-8 support enabled -- Athena, Motif and GTK GUI +- Motif and GTK GUI - MS-Windows GUI - several other platforms diff --git a/runtime/doc/motion.txt b/runtime/doc/motion.txt index 37b420c463..7946a133e8 100644 --- a/runtime/doc/motion.txt +++ b/runtime/doc/motion.txt @@ -33,7 +33,8 @@ know what the hjkl keys do. The mnemonic value of hjkl is clear from looking at the keyboard. Think of j as an arrow pointing downwards. The 'virtualedit' option can be set to make it possible to move the cursor to -positions where there is no character or halfway a character. +positions where there is no character or within a multi-column character (like +a tab). ============================================================================== 1. Motions and operators *operator* @@ -445,35 +446,35 @@ between Vi and Vim. 5. Text object motions *object-motions* *(* -( [count] sentences backward. |exclusive| motion. +( [count] |sentence|s backward. |exclusive| motion. *)* -) [count] sentences forward. |exclusive| motion. +) [count] |sentence|s forward. |exclusive| motion. *{* -{ [count] paragraphs backward. |exclusive| motion. +{ [count] |paragraph|s backward. |exclusive| motion. *}* -} [count] paragraphs forward. |exclusive| motion. +} [count] |paragraph|s forward. |exclusive| motion. *]]* -]] [count] sections forward or to the next '{' in the +]] [count] |section|s forward or to the next '{' in the first column. When used after an operator, then also stops below a '}' in the first column. |exclusive| Note that |exclusive-linewise| often applies. *][* -][ [count] sections forward or to the next '}' in the +][ [count] |section|s forward or to the next '}' in the first column. |exclusive| Note that |exclusive-linewise| often applies. *[[* -[[ [count] sections backward or to the previous '{' in +[[ [count] |section|s backward or to the previous '{' in the first column. |exclusive| Note that |exclusive-linewise| often applies. *[]* -[] [count] sections backward or to the previous '}' in +[] [count] |section|s backward or to the previous '}' in the first column. |exclusive| Note that |exclusive-linewise| often applies. diff --git a/runtime/doc/netbeans.txt b/runtime/doc/netbeans.txt index cc545f145b..7f69376914 100644 --- a/runtime/doc/netbeans.txt +++ b/runtime/doc/netbeans.txt @@ -1,4 +1,4 @@ -*netbeans.txt* For Vim version 8.2. Last change: 2020 Nov 02 +*netbeans.txt* For Vim version 8.2. Last change: 2022 Apr 03 VIM REFERENCE MANUAL by Gordon Prieur et al. @@ -124,12 +124,12 @@ In case you do not want the NetBeans interface you can disable it by uncommenting a line with "--disable-netbeans" in the Makefile. Currently the NetBeans interface is supported by Vim running in a terminal and -by gvim when it is run with one of the following GUIs: GTK, GNOME, Windows, -Athena and Motif. +by gvim when it is run with one of the following GUIs: GTK, GNOME, Windows +and Motif. *netbeans-xpm* If Motif support is required the user must supply XPM libraries. -The XPM library is required to show images within Vim with Motif or Athena. +The XPM library is required to show images within Vim with Motif. Without it the toolbar and signs will be disabled. The XPM library is provided by Arnaud Le Hors of the French National Institute diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 8b2021107b..443175a856 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 8.2. Last change: 2022 Mar 29 +*options.txt* For Vim version 8.2. Last change: 2022 Apr 07 VIM REFERENCE MANUAL by Bram Moolenaar @@ -87,7 +87,7 @@ achieve special effects. These options come in three forms: :se[t] {option}+={value} *:set+=* Add the {value} to a number option, or append the {value} to a string option. When the option is a - comma separated list, a comma is added, unless the + comma-separated list, a comma is added, unless the value was empty. If the option is a list of flags, superfluous flags are removed. When adding a flag that was already @@ -97,7 +97,7 @@ achieve special effects. These options come in three forms: :se[t] {option}^={value} *:set^=* Multiply the {value} to a number option, or prepend the {value} to a string option. When the option is a - comma separated list, a comma is added, unless the + comma-separated list, a comma is added, unless the value was empty. Also see |:set-args| above. @@ -1019,7 +1019,7 @@ A jump table for the options with a short description can be found at |Q_op|. 'backupcopy' 'bkc' string (Vi default for Unix: "yes", otherwise: "auto") global or local to buffer |global-local| When writing a file and a backup is made, this option tells how it's - done. This is a comma separated list of words. + done. This is a comma-separated list of words. The main values are: "yes" make a copy of the file and overwrite the original one @@ -1043,10 +1043,10 @@ A jump table for the options with a short description can be found at |Q_op|. file. - When the file is a link the new file will not be a link. - The "auto" value is the middle way: When Vim sees that renaming file - is possible without side effects (the attributes can be passed on and - the file is not a link) that is used. When problems are expected, a - copy will be made. + The "auto" value is the middle way: When Vim sees that renaming the + file is possible without side effects (the attributes can be passed on + and the file is not a link) that is used. When problems are expected, + a copy will be made. The "breaksymlink" and "breakhardlink" values can be used in combination with any of "yes", "no" and "auto". When included, they @@ -1065,13 +1065,13 @@ A jump table for the options with a short description can be found at |Q_op|. When a copy is made, the original file is truncated and then filled with the new text. This means that protection bits, owner and - symbolic links of the original file are unmodified. The backup file + symbolic links of the original file are unmodified. The backup file, however, is a new file, owned by the user who edited the file. The group of the backup is set to the group of the original file. If this fails, the protection bits for the group are made the same as for others. - When the file is renamed this is the other way around: The backup has + When the file is renamed, this is the other way around: The backup has the same attributes of the original file, and the newly written file is owned by the current user. When the file was a (hard/symbolic) link, the new file will not! That's why the "auto" value doesn't @@ -1138,7 +1 |