runtime(doc): make examples verbatim to prevent conceal/tag parsing
Commit:
https://github.com/vim/vim/commit/2090405de5bb66facc29c745596750bdebbd64c2
Author: Yochem van Rosmalen <g...@yochem.nl>
Date: Tue Jun 3 20:54:33 2025 +0200
runtime(doc): make examples verbatim to prevent conceal/tag parsing
closes: https://github.com/vim/vim/issues/17437
Signed-off-by: Yochem van Rosmalen <g...@yochem.nl>
Signed-off-by: Christian Brabandt <c...@256bit.org>
diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt
index a88aad1a7..faef9ec62 100644
--- a/runtime/doc/editing.txt
+++ b/runtime/doc/editing.txt
@@ -1,4 +1,4 @@
-*editing.txt* For Vim version 9.1. Last change: 2025 Apr 03
+*editing.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1342,9 +1342,15 @@ b:browsefilter variable. You would most likely set
b:browsefilter in a
filetype plugin, so that the browse dialog would contain entries related to
the type of file you are currently editing. Disadvantage: This makes it
difficult to start editing a file of a different type. To overcome this, you
-may want to add "All Files (*.*) *
" as the final filter on Windows or "All
-Files (*) *
" on other platforms, so that the user can still access any
-desired file.
+may want to add >
+
+ All Files (*.*) *
+<
+as the final filter on Windows or >
+
+ All Files (*) *
"
+<
+on other platforms, so that the user can still access any desired file.
To avoid setting browsefilter when Vim does not actually support it, you can
use has("browsefilter"): >
diff --git a/runtime/doc/helphelp.txt b/runtime/doc/helphelp.txt
index 4af6efd2d..c49a4d50b 100644
--- a/runtime/doc/helphelp.txt
+++ b/runtime/doc/helphelp.txt
@@ -1,4 +1,4 @@
-*helphelp.txt* For Vim version 9.1. Last change: 2025 May 31
+*helphelp.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -412,7 +412,7 @@ in such a modeline, that can have undesired consequences.
TAGS
-To define a help tag, place the name between asterisks (*tag-name*). The
+To define a help tag, place the name between asterisks ("*tag-name*"). The
tag-name should be different from all the Vim help tag names and ideally
should begin with the name of the Vim plugin. The tag name is usually right
aligned on a line.
diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index a23b892e5..44fed277f 100644
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -1,4 +1,4 @@
-*syntax.txt* For Vim version 9.1. Last change: 2025 Jun 01
+*syntax.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -3102,7 +3102,7 @@ PRINTCAP + TERMCAP *ft-ptcap-syntax*
*ft-termcap-syntax*
This syntax file applies to the printcap and termcap databases.
In order for Vim to recognize printcap/termcap files that do not match
-the patterns *printcap*, or *termcap*, you must put additional patterns
+the patterns "*printcap*", or "*termcap*", you must put additional patterns
appropriate to your system in your |myfiletypefile| file. For these
patterns, you must set the variable "b:ptcap_type" to either "print" or
"term", and then the 'filetype' option to ptcap.
diff --git a/runtime/doc/usr_02.txt b/runtime/doc/usr_02.txt
index e52853a82..af1cd619b 100644
--- a/runtime/doc/usr_02.txt
+++ b/runtime/doc/usr_02.txt
@@ -1,4 +1,4 @@
-*usr_02.txt* For Vim version 9.1. Last change: 2025 Feb 01
+*usr_02.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM USER MANUAL - by Bram Moolenaar
@@ -438,9 +438,9 @@ of the tag given by the word under the cursor.)
After a few jumps, you might want to go back. CTRL-T (pop tag) takes you
back to the preceding position. CTRL-O (jump to older position) also works
nicely here.
- At the top of the help screen, there is the notation *help.txt*. This name
-between "*" characters is used by the help system to define a tag (hyperlink
-destination).
+ At the top of the help screen, there is the notation "*help.txt*". This
+name between "*" characters is used by the help system to define a tag
+(hyperlink destination).
See |29.1| for details about using tags.
To get help on a given subject, use the following command: >
diff --git a/runtime/doc/usr_11.txt b/runtime/doc/usr_11.txt
index 9ba6f4420..19851b530 100644
--- a/runtime/doc/usr_11.txt
+++ b/runtime/doc/usr_11.txt
@@ -1,4 +1,4 @@
-*usr_11.txt* For Vim version 9.1. Last change: 2020 Oct 25
+*usr_11.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM USER MANUAL - by Bram Moolenaar
@@ -127,7 +127,7 @@ Example: >
vim -r .help.txt.swo
This is also handy when the swap file is in another directory than expected.
-Vim recognizes files with the pattern *.s[uvw][a-z] as swap files.
+Vim recognizes files with the pattern "*.s[uvw][a-z]" as swap files.
If this still does not work, see what file names Vim reports and rename the
files accordingly. Check the 'directory' option to see where Vim may have
diff --git a/runtime/doc/usr_22.txt b/runtime/doc/usr_22.txt
index 0220893a7..c6bc5d233 100644
--- a/runtime/doc/usr_22.txt
+++ b/runtime/doc/usr_22.txt
@@ -1,4 +1,4 @@
-*usr_22.txt* For Vim version 9.1. Last change: 2024 Oct 05
+*usr_22.txt* For Vim version 9.1. Last change: 2025 Jun 03
VIM USER MANUAL - by Bram Moolenaar
@@ -27,23 +27,23 @@ Vim has a plugin that makes it possible to edit a
directory. Try this: >
:edit .
Through the magic of autocommands and Vim scripts, the window will be filled
-with the contents of the directory. It looks like this:
-
-" ============================================================================
~
-" Netrw Directory Listing (netrw v109) ~
-" Sorted by name ~
-" Sort sequence: [\/]$,\.h$,\.c$,\.cpp$,*,\.info$,\.swp$,\.o$\.obj$,\.bak$ ~
-" Quick Help: <F1>:help -:go up dir D:delete R:rename s:sort-by x:exec ~
-" ============================================================================
~
-../ ~
-./ ~
-check/ ~
-Makefile ~
-autocmd.txt ~
-change.txt ~
-eval.txt ~
-filetype.txt ~
-help.txt.info ~
+with the contents of the directory. It looks like this: >
+
+ " ===========================================================================
+ " Netrw Directory Listing (netrw v109)
+ " Sorted by name
+ " Sort sequence: [\/]$,\.h$,\.c$,\.cpp$,*,\.info$,\.swp$,\.o$\.obj$,\.bak$
+ " Quick Help: <F1>:help -:go up dir D:delete R:rename s:sort-by x:exec
+ " ===========================================================================
+ ../
+ ./
+ check/
+ Makefile
+ autocmd.txt
+ change.txt
+ eval.txt
+ filetype.txt
+ help.txt.info
You can see these items:
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to vim_dev+unsubscr...@googlegroups.com.
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1uMWrm-00FcNH-Nd%40256bit.org.
