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

Update syntax.{txt,jax}

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Aug 13
+*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Aug 22
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -2071,6 +2071,13 @@ Note これら 3 つの変数は HTML 構文ファイルで維持されること
 数字と文字列は、以下で Javadoc 以外のコメントでも認識される >
 	:let g:java_comment_strings = 1
 
+'foldmethod' が "syntax" に設定されている場合、コードブロックと複数行コメント
+は折り畳まれる。複数行コメントの最初の行には通常テキストが書かれていないため、
+デフォルトの 'foldtext' 値では、Javadoc コメントの折り畳まれた内容は情報が少な
+くなる。この方法で書かれたコメントの場合は 2 行目の内容を表示し、それ以外の場
+合は 1 行目の内容を表示するように以下で選択できる >
+	:let g:java_foldtext_show_first_or_second_line = 1
+
 末尾の空白文字またはタブ文字の前の連続したスペース文字は、以下でエラーとして
 マークされる >
 	:let g:java_space_errors = 1

en/syntax.txt

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim version 9.1.  Last change: 2024 Aug 13
+*syntax.txt*	For Vim version 9.1.  Last change: 2024 Aug 22
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -2135,6 +2135,14 @@ Note that these three variables are maintained in the HTML syntax file.
 Numbers and strings can be recognized in non-Javadoc comments with >
 	:let g:java_comment_strings = 1
 
+When 'foldmethod' is set to "syntax", blocks of code and multi-line comments
+will be folded.  No text is usually written in the first line of a multi-line
+comment, making folded contents of Javadoc comments less informative with the
+default 'foldtext' value; you may opt for showing the contents of a second
+line for any comments written in this way, and showing the contents of a first
+line otherwise, with >
+	:let g:java_foldtext_show_first_or_second_line = 1
+
 Trailing whitespace characters or a run of space characters before a tab
 character can be marked as an error with >
 	:let g:java_space_errors = 1