Update helphelp.{txt,jax}

Author: h-east

doc/helphelp.jax

@@ -1,4 +1,4 @@
-*helphelp.txt*	For Vim バージョン 9.1.  Last change: 2024 Dec 15
+*helphelp.txt*	For Vim バージョン 9.1.  Last change: 2024 Dec 25
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -426,17 +426,37 @@ Ex コマンドのブロックを例示するときは、大なり記号 (>) を
 末に書き、小なり記号 (<) をその後ろのブロックの前の最初の非空白文字として書き
 ます。テキストが 1 列目から始まっている行があると、Ex コマンドのブロックはその
 直前で暗黙的に終了となります。例: >
-    function Example_Func()
-	echo "Example"
-    endfunction
+	function Example_Func()
+	  echo "Example"
+	endfunction
 <
-コード例に Vim 構文ハイライトサポートを追加することができます。これは、大なり
-記号 (>) の後に "vim" を追加することで可能です (">vim")。
+
+ブロックに注釈を追加するには、大なり記号 (>) の後に注釈 (例: "lua") を配置しま
+す。例: >lua
+	print("hello")
+<
+Note: |g:help_example_languages| に "lua" キーがある場合は、lua 構文のハイライ
+トを使用します。
+
+コード例に Vim 構文ハイライトのサポートを追加することができます。
 例: >vim
-    function Example_Func()
-	echo "Example"
-    endfunction
+	function Example_Func()
+	  echo "Example"
+	endfunction
 <
+						*g:help_example_languages*
+ブロック内の構文ハイライトを変更する場合は、以下のように変更できます: >
+	:let g:help_example_languages = #{ vim: 'vim', sh: 'bash' }
+キーは注釈マーカー名を表し、値は 'syntax' 名です。デフォルトでは、ヘルプファイ
+ルは Vim script のハイライトのみをサポートします。
+Note: "g:help_example_languages" を設定するときに "vim" キーを含めないと、Vim
+構文ハイライトは有効になりません。空の値に設定すると、埋め込み言語の構文のハイ
+ライトは無効になります。
+
+さらに note: 含まれている 'syntax' スクリプトがそのような趣旨を考慮していない
+場合、ヘルプファイルに追加の構文言語を含めることは必ずしも完全に機能するとは限
+りません。
+						*help-notation*
 Vim ヘルプファイルでは以下のものがそれぞれハイライトされます:
   - 特殊キーの名前。<PageDown> のような <> 表記で書かれたものと、CTRL-X のよう
     に書かれた制御文字。

en/helphelp.txt

@@ -1,4 +1,4 @@
-*helphelp.txt*	For Vim version 9.1.  Last change: 2024 Dec 15
+*helphelp.txt*	For Vim version 9.1.  Last change: 2024 Dec 25
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -433,17 +433,38 @@ To quote a block of ex-commands verbatim, place a greater than (>) character
 at the end of the line before the block and a less than (<) character as the
 first non-blank on a line following the block.  Any line starting in column 1
 also implicitly stops the block of ex-commands before it.  E.g. >
-    function Example_Func()
-	echo "Example"
-    endfunction
+	function Example_Func()
+	  echo "Example"
+	endfunction
 <
-It's possible to add Vim syntax highlighting support to code examples.  This
-can be done by adding "vim" after the greater than (>) character (">vim").
+
+To add annotation in the block, place the annotation (ex: "lua") after a
+greater than (>) character.  E.g: >lua
+	print("hello")
+<
+Note: uses lua syntax highlighting, if "lua" key is in
+|g:help_example_languages|.
+
+It's possible to add Vim syntax highlighting support to code examples.
 E.g: >vim
-    function Example_Func()
-	echo "Example"
-    endfunction
+	function Example_Func()
+	  echo "Example"
+	endfunction
 <
+						*g:help_example_languages*
+If you want to change the syntax highlighting in the block, you can
+change it like this: >
+	:let g:help_example_languages = #{ vim: 'vim', sh: 'bash' }
+The key represents the annotation marker name, and the value is the 'syntax'
+name.  By default, help files support only Vim script highlighting.
+Note: When setting "g:help_example_languages", if you do not include "vim"
+key, the Vim syntax highlighting will not be enabled. If you set it to an
+empty value, syntax highlighting for embedded languages will be disabled.
+
+Further note: including additional syntax languages into help files may not
+always work perfectly, if the included 'syntax' script does not account for
+such an import.
+						*help-notation*
 The following are highlighted differently in a Vim help file:
   - a special key name expressed either in <> notation as in <PageDown>, or
     as a Ctrl character as in CTRL-X