Merge pull request #1671 from vim-jp/hh-update-syntax

Update syntax.{txt,jax}

Author: h-east

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Aug 22
+*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Aug 31
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -180,8 +180,7 @@ NOTE: 長い行があって表示が遅く、構文ハイライトをオフに
 1. 上同様、'runtimepath' に示されるユーザーディレクトリを作成する。
 
 2. "after/syntax" というディレクトリを作成する。UNIXの例: >
-	mkdir ~/.vim/after
-	mkdir ~/.vim/after/syntax
+	mkdir -p ~/.vim/after/syntax
 
 3. 追加設定を行うコマンドを含む Vim script ファイルを作成する。例として、C言語
    のコメントの色を変更するには: >
@@ -2098,6 +2097,21 @@ Note これら 3 つの変数は HTML 構文ファイルで維持されること
 10 である。大きな数値を使用すると、再描画が遅くなる可能性があるという欠点があ
 る。
 
+Java プラットフォームへの重要な変更は、リリース用に実装されたり、プレビュー機
+能として提供される JDK Enhancement Proposals (JEPs) の形で徐々に導入される。こ
+のような機能がプラットフォームに統合されるか、この取り組みから取り下げられるま
+でには、複数の JEP とリリースサイクルが必要になる場合がある。アーリーアダプター
+に対応するため Vim には実装されている構文関連のプレビュー機能に対するオプショ
+ンのサポートがある。以下のようにプレビュー機能番号のリストを指定して、これをリ
+クエストできる: >
+	:let g:java_syntax_previews = [430]
+
+サポートされている JEP 番号は以下の表から取得される:
+	`430`: String Templates [JDK 21]
+
+Note 特定のプレビュー機能が Java プラットフォームに統合されると、すぐにそのエ
+ントリはテーブルから削除され、関連するオプション機能は廃止されることに注意。
+
 
 JSON			*json.vim* *ft-json-syntax* *g:vim_json_conceal*
 					       *g:vim_json_warnings*

en/syntax.txt

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim version 9.1.  Last change: 2024 Aug 22
+*syntax.txt*	For Vim version 9.1.  Last change: 2024 Aug 31
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -179,8 +179,7 @@ add a few items or change the highlighting, follow these steps:
 1. Create your user directory from 'runtimepath', see above.
 
 2. Create a directory in there called "after/syntax".  For Unix: >
-	mkdir ~/.vim/after
-	mkdir ~/.vim/after/syntax
+	mkdir -p ~/.vim/after/syntax
 
 3. Write a Vim script that contains the commands you want to use.  For
    example, to change the colors for the C syntax: >
@@ -2164,6 +2163,22 @@ This will make the syntax synchronization start 50 lines before the first
 displayed line.  The default value is 10.  The disadvantage of using a larger
 number is that redrawing can become slow.
 
+Significant changes to the Java platform are gradually introduced in the form
+of JDK Enhancement Proposals (JEPs) that can be implemented for a release and
+offered as its preview features.  It may take several JEPs and a few release
+cycles for such a feature to become either integrated into the platform or
+withdrawn from this effort.  To cater for early adopters, there is optional
+support in Vim for syntax related preview features that are implemented.  You
+can request it by specifying a list of preview feature numbers as follows: >
+	:let g:java_syntax_previews = [430]
+
+The supported JEP numbers are to be drawn from this table:
+	`430`: String Templates [JDK 21]
+
+Note that as soon as the particular preview feature will have been integrated
+into the Java platform, its entry will be removed from the table and related
+optionality will be discontinued.
+
 
 JSON			*json.vim* *ft-json-syntax* *g:vim_json_conceal*
 					       *g:vim_json_warnings*