vim-patch:8cc5b559f700 (#19066)

Update runtime files
8cc5b559f7

runtime/doc/options.txt

@@ -2475,8 +2475,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 <	This is similar to the default, except that these characters will also
 	be used when there is highlighting.
 
-	For "stl" and "stlnc" single-byte and multibyte characters are
+	For the "stl", "stlnc", "foldopen", "foldclose" and "foldsep" items
-	supported.  But double-width characters are not supported.
+	single-byte and multibyte characters are supported.  But double-width
+	characters are not supported.
 
 	The highlighting used for these items:
 	  item		highlight group ~
@@ -3667,6 +3668,9 @@ A jump table for the options with a short description can be found at |Q_op|.
 	executing macros, registers and other commands that have not been
 	typed.  Also, updating the window title is postponed.  To force an
 	update use |:redraw|.
+	This may occasionally cause display errors.  It is only meant to be set
+	temporarily when performing an operation where redrawing may cause
+	flickering or cause a slow down.
 
 			*'linebreak'* *'lbr'* *'nolinebreak'* *'nolbr'*
 'linebreak' 'lbr'	boolean	(default off)

runtime/doc/usr_40.txt

@@ -463,6 +463,17 @@ separated) that trigger the command.
 The optional [++nested] flag allows for nesting of autocommands (see below),
 and finally, {command} is the command to be executed.
 
+When adding an autocommand the already existing ones remain.  To avoid adding
+the autocommand several times you should use this form: >
+
+	:augroup updateDate
+	:  autocmd!
+	:  autocmd BufWritePre *  call DateInsert()
+	:augroup END
+
+This will delete any previously defined autocommand with `:autocmd!` before
+defining the new one.  Groups are explained later.
+
 
 EVENTS
 

runtime/doc/usr_41.txt

@@ -1636,27 +1636,29 @@ manual: |exception-handling|.
 Here is a summary of items that apply to Vim scripts.  They are also mentioned
 elsewhere, but form a nice checklist.
 
-The end-of-line character depends on the system.  For Unix a single <NL>
+The end-of-line character depends on the system.  For Vim scripts it is
-character is used.  For Windows <CR><NL> is used.  This is important when
+recommended to always use the Unix fileformat.  Lines are then separated with
-using mappings that end in a <CR>.  See |:source_crnl|.
+the Newline character.  This also works on any other system.  That way you can
+copy your Vim scripts from MS-Windows to Unix and they still work.  See
+|:source_crnl|.  To be sure it is set right, do this before writing the file:
+ >
+	:setlocal fileformat=unix
+
+When using "dos" fileformat, lines are separated with CR-NL, two characters.
+The CR character causes various problems, better avoid this.
 
 
 WHITE SPACE
 
-Blank lines are allowed and ignored.
+Blank lines are allowed in a script and ignored.
 
-Leading whitespace characters (blanks and TABs) are always ignored.  The
+Leading whitespace characters (blanks and TABs) are ignored, except when using
-whitespaces between parameters (e.g. between the "set" and the "cpoptions" in
+|:let-heredoc| without "trim".
-the example below) are reduced to one blank character and plays the role of a
-separator, the whitespaces after the last (visible) character may or may not
-be ignored depending on the situation, see below.
 
-For a ":set" command involving the "=" (equal) sign, such as in: >
+Trailing whitespace is often ignored, but not always.  One command that
-
+includes it is `map`.  You have to watch out for that, it can cause hard to
-	:set cpoptions    =aABceFst
+understand mistakes.  A generic solution is to never use trailing white space,
-
+unless you really need it.
-the whitespace immediately before the "=" sign is ignored.  But there can be
-no whitespace after the "=" sign!
 
 To include a whitespace character in the value of an option, it must be
 escaped by a "\" (backslash)  as in the following example: >

runtime/pack/dist/opt/termdebug/plugin/termdebug.vim

@@ -2,7 +2,7 @@
 "
 " Author: Bram Moolenaar
 " Copyright: Vim license applies, see ":help license"
-" Last Change: 2022 May 23
+" Last Change: 2022 Jun 22
 "
 " WORK IN PROGRESS - The basics works stable, more to come
 " Note: In general you need at least GDB 7.12 because this provides the
@@ -1406,7 +1406,7 @@ func s:HandleCursor(msg)
       if expand('%:p') != fnamemodify(fname, ':p')
         echomsg 'different fname: "' .. expand('%:p') .. '" vs "' .. fnamemodify(fname, ':p') .. '"'
         augroup Termdebug
-          " Always open a file read-only instead of showing the ATTENTION
+          " Always open a file read-only instead of showing the ATTENTION
           " prompt, since it is unlikely we want to edit the file.
           " The file may be changed but not saved, warn for that.
           au SwapExists * echohl WarningMsg

runtime/syntax/doxygen.vim

@@ -498,12 +498,16 @@ endif
 
     syn match doxygenLeadingWhite +\(^\s*\*\)\@<=\s*+ contained
 
-    " This is still a proposal, but won't do any harm.
+    " This is still a proposal, but it is probably fine.  However, it doesn't
+    " work when 'syntax' is set in a modeline, catch the security error.
+    try
       aug doxygengroup
         au!
         au Syntax UserColor_reset nested call s:Doxygen_Hilights_Base()
         au Syntax UserColor_{on,reset,enable} nested call s:Doxygen_Hilights()
       aug END
+    catch /E12:/
+    endtry
 
 
     SynLink doxygenBody                   Comment