Commit: runtime(vim): Update help syntax file, improve highlighting of included Vim examples

[Christian Brabandt]

runtime(vim): Update help syntax file, improve highlighting of included Vim examples

Commit: https://github.com/vim/vim/commit/1341176e7b800238b30a137c1ea1a31ca2c3d488
Author: Doug Kearns <dougk...@gmail.com>
Date: Sun Jul 13 17:53:26 2025 +0200

runtime(vim): Update help syntax file, improve highlighting of included Vim examples

- Take over as file maintainer.
- Improve highlighting of legacy script examples by using :syn-iskeyword
with the default 'iskeyword' value. Vim9 script examples are not
supported yet.
- Match admonition labels in more contexts.
- Match URLs in more contexts.

fixes #17721
closes: #17731

Signed-off-by: Doug Kearns <dougk...@gmail.com>
Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/.github/MAINTAINERS b/.github/MAINTAINERS
index 6d2481161..6e62bfecd 100644
--- a/.github/MAINTAINERS
+++ b/.github/MAINTAINERS
@@ -510,6 +510,7 @@ runtime/syntax/hare.vim @selenebun
runtime/syntax/haredoc.vim @selenebun
runtime/syntax/haskell.vim @coot
runtime/syntax/hcl.vim @gpanders
+runtime/syntax/help.vim @dkearns
runtime/syntax/help_ru.vim @RestorerZ
runtime/syntax/hgcommit.vim @k-takata
runtime/syntax/hitest.vim @lacygoill
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 6a576d31c..73cb70b96 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -1,4 +1,4 @@
-*eval.txt* For Vim version 9.1. Last change: 2025 Jun 28
+*eval.txt* For Vim version 9.1. Last change: 2025 Jul 13


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -5210,7 +5210,7 @@ The |:Launch| user command uses shell completion for its first argument.

NOTE: escaping of <args> is left to the user

-Examples: >vim
+Examples: >
vim9script

import autoload 'dist/vim9.vim'
diff --git a/runtime/doc/fold.txt b/runtime/doc/fold.txt
index 961fa57c9..ebbb2c09e 100644
--- a/runtime/doc/fold.txt
+++ b/runtime/doc/fold.txt
@@ -1,4 +1,4 @@
-*fold.txt* For Vim version 9.1. Last change: 2025 Jul 09
+*fold.txt* For Vim version 9.1. Last change: 2025 Jul 13


VIM REFERENCE MANUAL by Bram Moolenaar
@@ -164,7 +164,7 @@ level is found.
If this proves difficult, the next best thing could be to cache all fold
levels in a buffer-local variable (b:foldlevels) that is only updated on
|b:changedtick|:
->vim
+>
vim9script
def MyFoldFunc(): number
if b:lasttick == b:changedtick
diff --git a/runtime/doc/usr_25.txt b/runtime/doc/usr_25.txt
index ed92c9535..c33450a67 100644
--- a/runtime/doc/usr_25.txt
+++ b/runtime/doc/usr_25.txt
@@ -1,4 +1,4 @@
-*usr_25.txt* For Vim version 9.1. Last change: 2025 Jun 10
+*usr_25.txt* For Vim version 9.1. Last change: 2025 Jun 13

VIM USER MANUAL - by Bram Moolenaar

@@ -200,7 +200,7 @@ command: >vim

Or put this line in your |vimrc|: >vim

- packadd! justify
+ :packadd! justify

This Vim script file defines a new visual command "_j". To justify a block of
text, highlight the text in Visual mode and then execute "_j".
diff --git a/runtime/syntax/help.vim b/runtime/syntax/help.vim
index ec5739faa..5917e565a 100644
--- a/runtime/syntax/help.vim
+++ b/runtime/syntax/help.vim
@@ -1,7 +1,7 @@
" Vim syntax file
-" Language: Vim help file
-" Maintainer: The Vim Project <https://github.com/vim/vim>
-" Last Change: 2024 Dec 25
+" Language: Vim help file
+" Maintainer: Doug Kearns <dougk...@gmail.com>
+" Last Change: 2025 Jul 12
" Former Maintainer: Bram Moolenaar <Br...@vim.org>

" Quit when a (custom) syntax file was already loaded
@@ -12,6 +12,8 @@ endif
let s:cpo_save = &cpo
set cpo&vim

+syn iskeyword @,48-57,_,192-255
+
if !exists('g:help_example_languages')
let g:help_example_languages = #{ vim: 'vim' }
endif
@@ -78,24 +80,32 @@ if has("conceal")
else
syn match helpIgnore "." contained
endif
-syn keyword helpNote note Note NOTE note: Note: NOTE: Notes Notes:
-syn match helpNote "