Merge pull request #1731 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 Sep 19
+*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Oct 06
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -2044,7 +2044,8 @@ Java 1.1 では、関数 `System.out.println()` と `System.err.println()` は
 Javadoc は、Java プログラムファイルから特別なコメントを取り出し、HTML ページを
 作成するプログラムである。標準設定では、この HTML コードは HTML ファイルと同様
 にハイライトされる (|html.vim| を参照)。このコード内に JavaScript と CSS を追
-加することもできる (以下を参照)。HTML レンダリングは次のように分岐する。
+加することもできる (以下を参照)。HTML および Markdown のレンダリングは次のよう
+に分岐する:
   1. 最初の文 (後ろに空白文字または行末文字が続く最初のピリオド `.` までのすべ
      ての文字、または最初のブロックタグまでのすべての文字。例: `@param`、
      `@return`) は以下として色付けされる
@@ -2057,8 +2058,14 @@ Javadoc は、Java プログラムファイルから特別なコメントを取
 	*Special	special symbols
      そして、それらの引数の一部は以下として色付けされる
 	*Function	function names.
-この機能をオフにするには、スタートアップファイルに以下の行を追加する: >
+HTML と Markdown の両方でこの機能をオフにするには、スタートアップファイルに以
+下の行を追加する: >
 	:let g:java_ignore_javadoc = 1
+あるいは、HTML コメントまたは Markdown コメントのみを抑制する: >
+	:let g:java_ignore_html = 1
+	:let g:java_ignore_markdown = 1
+
+Markdown コメントの追加サポートについては |ft-java-plugin| を参照。
 
 上で説明した特別な Javadoc コメントのハイライトを使用する場合、JavaScript、
 Visual Basic スクリプト、埋め込み CSS (スタイルシート) の特別なハイライトもオ
@@ -2123,7 +2130,7 @@ Note 特定のプレビュー機能が Java プラットフォームに統合さ
 
 
 JSON			*json.vim* *ft-json-syntax* *g:vim_json_conceal*
-					       *g:vim_json_warnings*
+						*g:vim_json_warnings*
 
 json構文ファイルは、標準で conceal サポート付きのシンタックスハイライトを提供
 する。conceal を無効にするには: >
@@ -3829,10 +3836,13 @@ g:vimsyn_embed オプションは、どの外部スクリプト言語の埋め
 ようになった: >
 
    g:vimsyn_folding == 0 または変数が存在しない: 構文ベースの折り畳みはしない
-   g:vimsyn_folding =~ 'a' : augroups
+   g:vimsyn_folding =~ 'a' : augroups を折り畳む
+   g:vimsyn_folding =~ 'c' : Vim9 クラスを折り畳む
+   g:vimsyn_folding =~ 'e' : Vim9 列挙型を折り畳む
    g:vimsyn_folding =~ 'f' : 関数を折り畳む
    g:vimsyn_folding =~ 'h' : heredoc を折り畳む
-   g:vimsyn_folding =~ 'H' : Vim9-script の旧来のヘッダーを折り畳む
+   g:vimsyn_folding =~ 'i' : Vim9 インターフェイスを折り畳む
+   g:vimsyn_folding =~ 'H' : Vim9 の旧来のヘッダーを折り畳む
    g:vimsyn_folding =~ 'l' : Lua      スクリプトを折り畳む
    g:vimsyn_folding =~ 'm' : MzScheme スクリプトを折り畳む
    g:vimsyn_folding =~ 'p' : Perl     スクリプトを折り畳む

en/syntax.txt

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim version 9.1.  Last change: 2024 Sep 19
+*syntax.txt*	For Vim version 9.1.  Last change: 2024 Oct 06
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -2106,7 +2106,8 @@ respectively.
 Javadoc is a program that takes special comments out of Java program files and
 creates HTML pages.  The standard configuration will highlight this HTML code
 similarly to HTML files (see |html.vim|).  You can even add JavaScript and CSS
-inside this code (see below).  The HTML rendering diverges as follows:
+inside this code (see below).  The HTML rendering and the Markdown rendering
+diverge as follows:
   1. The first sentence (all characters up to the first period `.`, which is
      followed by a whitespace character or a line terminator, or up to the
      first block tag, e.g. `@param`, `@return`) is colored as
@@ -2119,8 +2120,14 @@ inside this code (see below).  The HTML rendering diverges as follows:
 	*Special	special symbols
      and some of their arguments are colored as
 	*Function	function names.
-To turn this feature off, add the following line to your startup file: >
+To turn this feature off for both HTML and Markdown, add the following line to
+your startup file: >
 	:let g:java_ignore_javadoc = 1
+Alternatively, only suppress HTML comments or Markdown comments: >
+	:let g:java_ignore_html = 1
+	:let g:java_ignore_markdown = 1
+
+See |ft-java-plugin| for additional support available for Markdown comments.
 
 If you use the special Javadoc comment highlighting described above, you can
 also turn on special highlighting for JavaScript, Visual Basic scripts, and
@@ -2189,7 +2196,7 @@ optionality will be discontinued.
 
 
 JSON			*json.vim* *ft-json-syntax* *g:vim_json_conceal*
-					       *g:vim_json_warnings*
+						*g:vim_json_warnings*
 
 The json syntax file provides syntax highlighting with conceal support by
 default. To disable concealment: >
@@ -3949,10 +3956,13 @@ mzscheme and embedded perl).
 Some folding is now supported with when 'foldmethod' is set to "syntax": >
 
    g:vimsyn_folding == 0 or doesn't exist: no syntax-based folding
-   g:vimsyn_folding =~ 'a' : augroups
+   g:vimsyn_folding =~ 'a' : fold augroups
+   g:vimsyn_folding =~ 'c' : fold Vim9 classes
+   g:vimsyn_folding =~ 'e' : fold Vim9 enums
    g:vimsyn_folding =~ 'f' : fold functions
    g:vimsyn_folding =~ 'h' : fold heredocs
-   g:vimsyn_folding =~ 'H' : fold Vim9-script legacy headers
+   g:vimsyn_folding =~ 'i' : fold Vim9 interfaces
+   g:vimsyn_folding =~ 'H' : fold Vim9 legacy headers
    g:vimsyn_folding =~ 'l' : fold Lua      script
    g:vimsyn_folding =~ 'm' : fold MzScheme script
    g:vimsyn_folding =~ 'p' : fold Perl     script