Merge pull request #1556 from vim-jp/hh-updtate-syntax

Update syntax.{txt,jax}

Author: h-east

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 Apr 09
+*syntax.txt*	For Vim バージョン 9.1.  Last change: 2024 May 31
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -903,8 +903,25 @@ nasm_loose_syntax	非オフィシャルな拡張構文をエラーとしない
 nasm_ctx_outside_macro	マクロ外のコンテキストをエラーとしない
 nasm_no_warn		潜在的に危険な構文をToDoとしてハイライトしない
 
+ASTRO						*astro.vim* *ft-astro-syntax*
 
-ASPPERL and ASPVBS			*ft-aspperl-syntax* *ft-aspvbs-syntax*
+コンフィグレーション
+
+以下の変数は、特定の構文ハイライト機能を制御する。
+これらを .vimrc に追加できる: >
+	let g:astro_typescript = "enable"
+<
+".astro" ファイルで TypeScript と TSX を有効にする。デフォルト値: "disable" >
+	let g:astro_stylus = "enable"
+<
+".astro" ファイルでスタイラスを有効にする。デフォルト値: "disable"
+
+NOTE: astro ファイルでスタイラスをサポートするには、外部プラグインをインストー
+ルする必要がある。
+
+
+ASPPERL							*ft-aspperl-syntax*
+ASPVBS							*ft-aspvbs-syntax*
 
 *.aspと*.asaという名のファイルはどちらもPerlもしくはVisual Basicのスクリプトた
 りえる。Vimにとってこれを判別するのは難しいので、グローバル変数を設定すること
@@ -1431,9 +1448,10 @@ Euphoria には二つの構文強調表示ファイルがある。一つは Euph
 3.1.1 用で、デフォルトではこれが使われる。もう一つは Euphoria 4.0.5 以降用であ
 る。
 
-Euphoria バージョン 3.1.1 (http://www.rapideuphoria.com/) は DOS プラット
-フォームのアプリケーションの開発にまだ必要とされている。Euphoria バージョン 4
-(http://www.openeuphoria.org/) はそれをサポートしていない。
+Euphoria バージョン 3.1.1 (http://www.rapideuphoria.com/ リンク切れのようだ)
+は DOS プラットフォームのアプリケーションの開発にまだ必要とされている。
+Euphoria バージョン 4 (http://www.openeuphoria.org/) はそれをサポートしていな
+い。
 
 以下の拡張子のファイルは自動的に Euphoria ファイルタイプとして認識される:
 
@@ -1489,8 +1507,8 @@ Elixir と Euphoria はファイル拡張子 *.ex を共有している。g:file
 FLEXWIKI				*flexwiki.vim* *ft-flexwiki-syntax*
 
 
-FlexWiki は http://www.flexwiki.com で入手できる ASP.NET ベースの wiki パッ
-ケージである。
+FlexWiki は、ASP.NET ベースの wiki パッケージで、以前は
+http://www.flexwiki.com で入手できた。
 NOTE: このサイトは現在機能していない。Wikipedia によると 2009 年に開発がストッ
 プした。
 
@@ -1935,17 +1953,25 @@ java.ioなど特定のパッケージの識別子だけをハイライトした
 関数を認識する方法はJavaコードの書き方に依存するため、関数名はハイライトされな
 い。構文ファイルは関数をハイライトする方法を2つ備えている:
 
-関数宣言が常にタブ、スペース8個、スペース2個のいずれかでインデントされているな
-ら >
+関数宣言をタブ、または、8 つまでのスペース文字で一貫してインデントして記述す
+る場合は、以下のように設定する >
 	:let java_highlight_functions="indent"
-とするとよいかもしれない。
-しかし、関数とクラスの命名(大文字・小文字についての)に関するJavaガイドラインに
-したがっているなら >
+	:let java_highlight_functions="indent1"
+	:let java_highlight_functions="indent2"
+	:let java_highlight_functions="indent3"
+	:let java_highlight_functions="indent4"
+	:let java_highlight_functions="indent5"
+	:let java_highlight_functions="indent6"
+	:let java_highlight_functions="indent7"
+	:let java_highlight_functions="indent8"
+Note 'shiftwidth' に関しては、これがインデントの一番左のステップであることに注
+意すること。
+ただし、関数とクラスの命名方法 (大文字と小文字を考慮) に関する Java ガイドライ
+ンに従っていて、インデントがある場合は、以下のように設定することをお勧めする >
 	:let java_highlight_functions="style"
-とすること。
-もしどちらのオプションもだめで、それでも関数宣言をハイライトしたいなら、
-java.vim中の定義を変更するか、もとのjava.vimに関数をハイライトするコードを加え
-て自分用のjava.vimを作るかして独自の定義を作るしかない。
+どちらの設定もうまくいかないが、それでも関数宣言をハイライトしたい場合は、
+java.vim の定義を変更するか、元の定義を組み込んだ独自の java.vim を作成してか
+ら関数をハイライトするコードを追加して、独自の定義を作成すること。
 
 Java 1.1では、System.out.println()とSystem.err.println()はデバッグのためだけに
 使われるものだった。そのためデバッグ用の文を区別してハイライトすることができ
@@ -2004,6 +2030,15 @@ json構文ファイルは、標準で conceal サポート付きのシンタッ
 	let g:vim_json_warning = 0
 
 
+JQ				*jq.vim* *jq_quote_highlight* *ft-jq-syntax*
+
+数字に独自の色を付けないようにするには、vimrc に以下のコードを追加する: >
+	hi link jqNumber Normal
+
+引用符を文字列とは異なるハイライトにしたい場合は >
+	let g:jq_quote_highlight = 1
+
+
 LACE						*lace.vim* *ft-lace-syntax*
 
 Lace (Language for Assembly of Classes in Eiffel)は大文字・小文字を無視する。
@@ -2585,8 +2620,8 @@ perl用の構文ハイライトにはたくさんのオプションがある。
 シンクロナイズには3つのオプションがある。最初の2つは、シンクロナイズのトリガー
 の一部をオフにするもので、ハイライトが適切に機能しないときのみ必要になる。スク
 ロール中に突然スクリーン全体の色がすっかり変わってしまったらこれらのうち1つを
-オフにしてみること。その誤りを引き起こした行を特定できるなら、それを知らせてく
-ださい。
+オフにしてみること。その誤りを引き起こした行を特定できる場合、それを開発者に知
+らせてください。
 
 1つのトリガーは "^\s*sub\s*" に関するもので、もう1つはほぼ "^[$@%]" に関するも
 のである。 >
@@ -2914,6 +2949,13 @@ knitrチャンクヘッダー内のRコードをハイライトするには、|v
 	let rrst_syn_hl_chunk = 1
 
 
+RASI					*rasi.vim* *ft-rasi-syntax*
+
+Rasi は Rofi Advanced Style Information の略である。これは、検索ウィンドウのレ
+ンダリングをスタイル設定するために、プログラム rofi によって使用される。この言
+語は、CSS スタイルシートに大きく影響を受けている。次の拡張子を持つファイルは、
+rasi ファイルとして認識される: .rasi。
+
 READLINE				*readline.vim* *ft-readline-syntax*
 
 readlineライブラリは主としてBASHシェルで使われ、BASHはかなりの数のコマンドとオ
@@ -3611,6 +3653,19 @@ tfの構文ハイライトには1つのオプションがある。
 
 	:let tf_minlines = your choice
 <
+TYPESCRIPT				*typescript.vim* *ft-typescript-syntax*
+				*typescriptreact.vim* *ft-typescriptreact-syntax*
+
+TypeScript 構文のハイライトを制御する 1 つのオプションがある。
+
+						*g:typescript_host_keyword*
+この変数を 1 に設定すると、`addEventListener` などのホスト固有の API がハイラ
+イトされる。無効にするには、.vimrc で 0 に設定する: >
+
+	let g:typescript_host_keyword = 0
+<
+デフォルト値は 1 である。
+
 VIM						*vim.vim* *ft-vim-syntax*
 			*g:vimsyn_minlines*	*g:vimsyn_maxlines*
 正確な構文ハイライトと画面更新速度はトレードオフの問題である。正確さを向上させ
@@ -3644,12 +3699,15 @@ syntax/vim.vim によって折り畳みが可能である: >
    g:vimsyn_folding == 0 または変数が存在しない: 構文ベースの折り畳みはしない
    g:vimsyn_folding =~ 'a' : augroups
    g:vimsyn_folding =~ 'f' : 関数を折り畳む
+   g:vimsyn_folding =~ 'h' : heredoc を折り畳む
+   g:vimsyn_folding =~ 'H' : Vim9-script の旧来のヘッダーを折り畳む
    g:vimsyn_folding =~ 'l' : lua      スクリプトを折り畳む
    g:vimsyn_folding =~ 'm' : mzscheme スクリプトを折り畳む
    g:vimsyn_folding =~ 'p' : perl     スクリプトを折り畳む
    g:vimsyn_folding =~ 'P' : python   スクリプトを折り畳む
    g:vimsyn_folding =~ 'r' : ruby     スクリプトを折り畳む
    g:vimsyn_folding =~ 't' : tcl      スクリプトを折り畳む
+let g:vimsyn_folding = 'acfhlmpPrt'
 <
 							*g:vimsyn_noerror*
 syntax/vim.vimによるエラーのハイライトは必ずしも正しいとは限らない。Vim script
@@ -4160,14 +4218,16 @@ conceal						*conceal* *:syn-conceal*
 際に Conceal 表示されるかどうかは 'conceallevel' オプションの設定に依存する。
 現在行のアイテムを Conceal 表示するかどうかは 'concealcursor' オプションで制御
 できる (行の編集を妨げないようにするため)。
-もう一つの方法として|matchadd()|を用いても、テキストを隠すことができる。
+テキストを隠す別の方法は |matchadd()| を使用することだが、内部的には少し異なる
+動作をする。|syntax-vs-match|
 
 concealends						*:syn-concealends*
 
 "concealends" 引数が指定されると、リージョンの開始部分と終了部分が Conceal 可
 能になる (リージョンの中身はならない)。アイテムが実際に Conceal 表示されるかど
 うかは 'conceallevel' の設定に依存する。"matchgroup" で別のハイライトを設定す
 ることでリージョンの終了部分だけを別に Conceal 表示するということもできる。
+|synconcealed()| 関数を使用すると、conceal された項目に関する情報を取得できる。
 
 cchar							*:syn-cchar*
 							*E844*

en/syntax.txt

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim version 9.1.  Last change: 2024 Apr 09
+*syntax.txt*	For Vim version 9.1.  Last change: 2024 May 31
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -930,8 +930,24 @@ nasm_loose_syntax	unofficial parser allowed syntax not as Error
 nasm_ctx_outside_macro	contexts outside macro not as Error
 nasm_no_warn		potentially risky syntax not as ToDo
 
+ASTRO						*astro.vim* *ft-astro-syntax*
 
-ASPPERL and ASPVBS			*ft-aspperl-syntax* *ft-aspvbs-syntax*
+Configuration
+
+The following variables control certain syntax highlighting features.
+You can add them to your .vimrc: >
+	let g:astro_typescript = "enable"
+<
+Enables TypeScript and TSX for ".astro" files. Default Value: "disable" >
+	let g:astro_stylus = "enable"
+<
+Enables Stylus for ".astro" files. Default Value: "disable"
+
+NOTE: You need to install an external plugin to support stylus in astro files.
+
+
+ASPPERL							*ft-aspperl-syntax*
+ASPVBS							*ft-aspvbs-syntax*
 
 *.asp and *.asa files could be either Perl or Visual Basic script.  Since it's
 hard to detect this you can set two global variables to tell Vim what you are
@@ -1467,9 +1483,9 @@ Two syntax highlighting files exist for Euphoria. One for Euphoria
 version 3.1.1, which is the default syntax highlighting file, and one for
 Euphoria version 4.0.5 or later.
 
-Euphoria version 3.1.1 (http://www.rapideuphoria.com/) is still necessary
-for developing applications for the DOS platform, which Euphoria version 4
-(http://www.openeuphoria.org/) does not support.
+Euphoria version 3.1.1 (http://www.rapideuphoria.com/ link seems dead) is
+still necessary for developing applications for the DOS platform, which
+Euphoria version 4 (http://www.openeuphoria.org/) does not support.
 
 The following file extensions are auto-detected as Euphoria file type:
 
@@ -1526,7 +1542,8 @@ Elixir.
 
 FLEXWIKI				*flexwiki.vim* *ft-flexwiki-syntax*
 
-FlexWiki is an ASP.NET-based wiki package available at http://www.flexwiki.com
+FlexWiki is an ASP.NET-based wiki package which used to be available at
+http://www.flexwiki.com
 NOTE: This site currently doesn't work, on Wikipedia is mentioned that
 development stopped in 2009.
 
@@ -1999,15 +2016,25 @@ Function names are not highlighted, as the way to find functions depends on
 how you write Java code.  The syntax file knows two possible ways to highlight
 functions:
 
-If you write function declarations that are always indented by either
-a tab, 8 spaces or 2 spaces you may want to set >
+If you write function declarations that are consistently indented by either
+a tab, or a space . . . or eight space character(s), you may want to set >
 	:let java_highlight_functions="indent"
+	:let java_highlight_functions="indent1"
+	:let java_highlight_functions="indent2"
+	:let java_highlight_functions="indent3"
+	:let java_highlight_functions="indent4"
+	:let java_highlight_functions="indent5"
+	:let java_highlight_functions="indent6"
+	:let java_highlight_functions="indent7"
+	:let java_highlight_functions="indent8"
+Note that in terms of 'shiftwidth', this is the leftmost step of indentation.
 However, if you follow the Java guidelines about how functions and classes are
-supposed to be named (with respect to upper and lowercase), use >
+supposed to be named (with respect to upper- and lowercase) and there is any
+amount of indentation, you may want to set >
 	:let java_highlight_functions="style"
-If both options do not work for you, but you would still want function
-declarations to be highlighted create your own definitions by changing the
-definitions in java.vim or by creating your own java.vim which includes the
+If neither setting does work for you, but you would still want function
+declarations to be highlighted, create your own definitions by changing the
+definitions in java.vim or by creating your own java.vim that includes the
 original one and then adds the code to highlight functions.
 
 In Java 1.1 the functions System.out.println() and System.err.println() should
@@ -2071,6 +2098,15 @@ To disable syntax highlighting of errors: >
 	let g:vim_json_warnings = 0
 
 
+JQ				*jq.vim* *jq_quote_highlight* *ft-jq-syntax*
+
+To disable numbers having their own color add the following to your vimrc: >
+	hi link jqNumber Normal
+
+If you want quotes to have different highlighting than strings >
+	let g:jq_quote_highlight = 1
+
+
 LACE						*lace.vim* *ft-lace-syntax*
 
 Lace (Language for Assembly of Classes in Eiffel) is case insensitive, but the
@@ -2670,8 +2706,8 @@ perl_string_as_statement, it will be highlighted as in the second line.
 The syncing has 3 options.  The first two switch off some triggering of
 synchronization and should only be needed in case it fails to work properly.
 If while scrolling all of a sudden the whole screen changes color completely
-then you should try and switch off one of those.  Let me know if you can
-figure out the line that causes the mistake.
+then you should try and switch off one of those.  Let the developer know if
+you can figure out the line that causes the mistake.
 
 One triggers on "^\s*sub\s*" and the other on "^[$@%]" more or less. >
 
@@ -3012,6 +3048,13 @@ To highlight R code in knitr chunk headers, add to your |vimrc|: >
 	let rrst_syn_hl_chunk = 1
 
 
+RASI					*rasi.vim* *ft-rasi-syntax*
+
+Rasi stands for Rofi Advanced Style Information. It is used by the program
+rofi to style the rendering of the search window. The language is heavily
+inspired by CSS stylesheet. Files with the following extensions are recognized
+as rasi files: .rasi.
+
 READLINE				*readline.vim* *ft-readline-syntax*
 
 The readline library is primarily used by the BASH shell, which adds quite a
@@ -3728,6 +3771,19 @@ set "tf_minlines" to the value you desire.  Example: >
 
 	:let tf_minlines = your choice
 <
+TYPESCRIPT				*typescript.vim* *ft-typescript-syntax*
+				*typescriptreact.vim* *ft-typescriptreact-syntax*
+
+There is one option to control the TypeScript syntax highlighting.
+
+						*g:typescript_host_keyword*
+When this variable is set to 1, host-specific APIs such as `addEventListener`
+are highlighted. To disable set it to zero in your .vimrc: >
+
+	let g:typescript_host_keyword = 0
+<
+The default value is 1.
+
 VIM			*vim.vim*		*ft-vim-syntax*
 			*g:vimsyn_minlines*	*g:vimsyn_maxlines*
 There is a trade-off between more accurate syntax highlighting versus screen
@@ -3764,12 +3820,15 @@ Some folding is now supported with syntax/vim.vim: >
    g:vimsyn_folding == 0 or doesn't exist: no syntax-based folding
    g:vimsyn_folding =~ 'a' : augroups
    g:vimsyn_folding =~ 'f' : fold functions
+   g:vimsyn_folding =~ 'h' : fold heredocs
+   g:vimsyn_folding =~ 'H' : fold Vim9-script legacy headers
    g:vimsyn_folding =~ 'l' : fold lua      script
    g:vimsyn_folding =~ 'm' : fold mzscheme script
    g:vimsyn_folding =~ 'p' : fold perl     script
    g:vimsyn_folding =~ 'P' : fold python   script
    g:vimsyn_folding =~ 'r' : fold ruby     script
    g:vimsyn_folding =~ 't' : fold tcl      script
+let g:vimsyn_folding = 'acfhlmpPrt'
 <
 							*g:vimsyn_noerror*
 Not all error highlighting that syntax/vim.vim does may be correct; Vim script
@@ -4296,15 +4355,19 @@ Whether or not it is actually concealed depends on the value of the
 'conceallevel' option.  The 'concealcursor' option is used to decide whether
 concealable items in the current line are displayed unconcealed to be able to
 edit the line.
-Another way to conceal text is with |matchadd()|.
+
+Another way to conceal text is with |matchadd()|, but internally this works a
+bit differently |syntax-vs-match|.
 
 concealends						*:syn-concealends*
 
 When the "concealends" argument is given, the start and end matches of
 the region, but not the contents of the region, are marked as concealable.
 Whether or not they are actually concealed depends on the setting on the
 'conceallevel' option. The ends of a region can only be concealed separately
-in this way when they have their own highlighting via "matchgroup"
+in this way when they have their own highlighting via "matchgroup".  The
+|synconcealed()| function can be used to retrieve information about conealed
+items.
 
 cchar							*:syn-cchar*
 							*E844*