syntax.jax: Update Vim 8.2.3687 translate a part

Author: tsuyoshicho

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 8.2.  Last change: 2021 Aug 16
+*syntax.txt*	For Vim バージョン 8.2.  Last change: 2021 Nov 20
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -1056,32 +1056,45 @@ ChangeLogでは行頭のスペースのハイライトできる。これをオ
 
 CLOJURE							*ft-clojure-syntax*
 
-デフォルト構文グループは、変数 *g:clojure_syntax_keywords* や
-*b:clojure_syntax_keywords* を用いて追加できる。値には構文グループの名前をキー
-とし、値にカスタム識別子の|List|を持つ|Dictionary|を指定する:
+						*g:clojure_syntax_keywords*
+
+"clojure.core" 内の公開変数のシンタックスハイライトがデフォルトで提供され、
+しかし追加シンボルを変数 |g:clojure_syntax_keywords| へ追加することでハイライ
+トできる。値には構文グループの名前をキーとし、値にカスタム識別子のリスト
+|List| を持つ辞書 |Dictionary| を指定する。
 >
 	let g:clojure_syntax_keywords = {
-	    \ 'clojureMacro': ["defproject", "defcustom"],
-	    \ 'clojureFunc': ["string/join", "string/replace"]
+	    \   'clojureMacro': ["defproject", "defcustom"],
+	    \   'clojureFunc': ["string/join", "string/replace"]
 	    \ }
 <
 有効な構文グループについては、Clojure 構文スクリプトを参照。
 
-バッファ変数(|buffer-variable|) *b:clojure_syntax_without_core_keywords* がセッ
-トされると、言語定数と特定のフォームにのみマッチする。
+そしてまたプラグイン作者が動的にシンボルをハイライトする意図で使用するための
+バッファローカル版として変数 *b:clojure_syntax_keywords* もある。
+
+変数 *b:clojure_syntax_without_core_keywords* への設定で、"clojure.core" の変
+数をデフォルトでハイライトしなくなる。これは `(:refer-clojure :only [])` で設
+定される名前空間に便利である。
+
+							*g:clojure_fold*
 
-*g:clojure_fold* を設定するとシンタックスエンジンに基づいた Clojure コードの折
-り畳みが有効化される。複数行に渡るリスト、ベクタ、マップなどを標準の Vim を
-使って折り畳みできる |fold-commands|。
+|g:clojure_fold| を1に設定すると Clojure のコードの折り畳みが有効になる。
+標準のVimの折り畳みコマンド |fold-commands| で1行を越える任意のlist, vector,
+mapを折り畳みできる。
 
-このオプションは rainbow-parentheses プラグインのような、角カッコの構文範囲を
-変更するようなスクリプトを使っているときは機能しない。
 
-このオプションは初期設定でオフになっている。
+						*g:clojure_discard_macro*
+
+この変数を1に設定すると Clojure の "Discard マクロ" の基本的なハイライトを有効
+にする。
 >
-	" 初期設定
-	let g:clojure_fold = 0
+	#_(defn foo [x]
+	    (println x))
 <
+Note このオプションでは重なった Discard マクロのハイライトは正しくならない(例
+`#_#_`)。
+
 
 COBOL						*cobol.vim* *ft-cobol-syntax*
 
@@ -1484,6 +1497,14 @@ FORM用の既定の拡張カラーモードではヘッダー命令とFORMプロ
 拡張モードを使うことは、gvimで暗いディスプレイを使用した場合にも利点がある。命
 令文は黄色ではなく明るい黄色で表示され、条件文は視認性のため明るい青で表示され
 る。
+ 
+
+FORTH						*forth.vim* *ft-forth-syntax*
+
+Files matching "*.fs" could be F# or Forth.  If the automatic detection
+doesn't work for you, or you don't edit F# at all, use this in your
+startup vimrc: >
+   :let filetype_fs = "forth"
 
 
 FORTRAN					*fortran.vim* *ft-fortran-syntax*
@@ -1628,14 +1649,6 @@ FVWM CONFIGURATION FILES			*fvwm.vim* *ft-fvwm-syntax*
   :au! BufNewFile,BufRead /etc/X11/fvwm2/*  let b:fvwm_version = 2 |
 					 \ set filetype=fvwm
 
-全ての有効な色の名前をVimにハイライトさせるには、システムの色データベース
-(rgb.txt)の位置を知らせる必要がある。これには変数 "rgb_file" にその場所を設定
-する。色データベースが/usr/X11/lib/X11/にあるとすれば: >
-
-	:let rgb_file = "/usr/X11/lib/X11/rgb.txt"
-
-このような内容をファイル.vimrcに追加する。
-
 
 GSP						*gsp.vim* *ft-gsp-syntax*
 
@@ -4649,17 +4662,29 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
 
 			再帰的な読み込みはされない。つまりカラースキームスクリ
 			プト中で ":colorscheme" を使うことはできない。
-
-			カラースキームをカスタマイズするには異なる名前を使い、
-			例えば "~/.vim/colors/mine.vim"、`:runtime`を用いてオ
-			リジナルのカラースキームを読み込む: >
+ 
+			カラースキームのカスタマイズには2つの選択肢がある。
+			特定の色として表われているものを変えるために、カラース
+			キームのロード前にカラー名を再定義できる。
+			desert スキームはカーソルの色として khaki を使う。
+			同じ色のより暗いバリエーションを使うなら:: >
+
+				let v:colornames['khaki'] = '#bdb76b'
+				colorscheme desert
+<
+			さらなるカスタマイズとして、|:highlight-link| 連係の変
+			更や他の名前を使うならば、例えば
+			"~/.vim/colors/mine.vim"、`:runtime`を用いてオリジナル
+			のカラースキームを読み込む: >
 				runtime colors/evening.vim
 				hi Statement ctermfg=Blue guifg=Blue
 
-<			カラースキームが読み込まれる前に、自動コマンドイベント
-			|ColorSchemePre| が発生する。カラースキームが読み込ま
-			れた後、自動コマンドイベント |ColorScheme| が発生す
-			る。カラースキームファイルを書くための情報については次
+<			カラースキームがロードされる前に全デフォルトのカラーリ
+			ストのスクリプト(`colors/lists/default.vim`)が実行され
+			|ColorSchemePre| 自動コマンドイベントが起動される。カ
+			ラースキームがロードされたら |ColorScheme| 自動コマン
+			ドイベントが起動される。
+			カラースキームファイルを書くための情報については次
 			を参照: >
 				:edit $VIMRUNTIME/colors/README.txt
 
@@ -4668,6 +4693,7 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
 :hi[ghlight] {group-name}
 			1つのハイライトグループを表示する。
 
+						*highlight-clear*
 :hi[ghlight] clear	全てのハイライトをデフォルトに戻す。ユーザーによって加
 			えられたグループに対するハイライトが全て消去される。
 			現在の 'background' の値によってデフォルトの色が決ま
@@ -4681,7 +4707,9 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
 
 :hi[ghlight] [default] {group-name} {key}={arg} ..
 			ハイライトグループを追加する、または既存のグループに対
-			する強調を変更する。
+			する強調を変更する。指定された色の名前が認識されない場
+			合、|'runtimepath'| 上で見付かる各
+			`colors/lists/default.vim` がロードされる。
 			引数{key}={arg}については|highlight-args|を参照。
 			オプショナルな引数[default]については
 			|:highlight-default|を参照。
@@ -4952,8 +4980,35 @@ guisp={color-name}					*highlight-guisp*
 		"gg"	Green値
 		"bb"	Blue値
 	これらの値は16進であり、範囲は "00" から "ff"。例: >
-  :highlight Comment guifg=#11f0c3 guibg=#ff00ff
+            :highlight Comment guifg=#11f0c3 guibg=#ff00ff
+<
+	If you are authoring a color scheme and use the same hexademical value
+	repeatedly, you can define a name for it in |v:colornames|. For
+	example: >
+
+	    # provide a default value for this color but allow the user to
+	    # override it.
+	    :call extend(v:colornames, {'alt_turquoise': '#11f0c3'}, 'keep')
+	    :highlight Comment guifg=alt_turquoise guibg=magenta
+<
+	If you are using a color scheme that relies on named colors and you
+	would like to adjust the precise appearance of those colors, you can
+	do so by overriding the values in |v:colornames| prior to loading the
+	scheme: >
+
+	    let v:colornames['alt_turquoise'] = '#22f0d3'
+	    colorscheme alt
+<
+	If you want to develop a color list that can be relied on by others,
+	it is best to prefix your color names. By convention these color lists
+	are placed in the colors/lists directory. You can see an example in
+	'$VIMRUNTIME/colors/lists/csscolors.vim'. This list would be sourced
+	by a color scheme using: >
+
+	    :runtime colors/lists/csscolors.vim
+	    :highlight Comment guifg=css_turquoise
 <
+
 					*highlight-groups* *highlight-default*
 以下はデフォルトのハイライトグループである。これらのグループはデフォルトでオプ
 ション 'highlight' によって使われる。ただしハイライトは 'background' の値に依
@@ -5013,6 +5068,12 @@ LineNrBelow	'relativenumber' オプションが設定されているときのカ
 CursorLineNr	LineNr と同じだが 'cursorline' が設定され、'cursorlineopt' に
 		"number" が含まれるか "both" が設定されているときに現在行に使
 		われる。
+							*hl-CursorLineSign*
+CursorLineSign	SignColumn と同じだが 'cursorline' が設定されたときに現在行に
+		使われる。
+							*hl-CursorLineFold*
+CursorLineFold	FoldColumn と同じだが 'cursorline' が設定されたときに現在行に
+		使われる。
 							*hl-MatchParen*
 MatchParen	カーソル下の文字、または直後の文字が括弧であるとき、その文字と
 		対応する括弧に使われる。|pi_paren.txt|
@@ -5225,24 +5286,25 @@ Unixでは~/.vim/after/syntax/syncolor.vimファイルを使うとよい。例:
 	else
 	  highlight comment ctermfg=green guifg=green
 	endif
-
-カラースキームを使用すると、ユーザー定義の色が使われるのか、それともカラース
-キームで定義された色が使われるのかわからなくなる場合がある。これはカラースキー
-ムファイルに依存する。|:colorscheme|を参照。
-
+<
 								*E679*
 このsyncolor.vimが "syntax on" を実行しないこと、また、オプション 'background'
 を設定したりコマンド "colorscheme" を実行しないように注意すること。もしこれら
 を実行すると無限ループに陥ってしまう。
 
+Note カラースキームを使用すると、ユーザー定義の色が使われるのか、それともカラー
+スキームで定義された色が使われるのかわからなくなる場合がある。これはカラース
+キームファイルに依存する。|:colorscheme|を参照。
+
 							*syntax_cmd*
 syntax/syncolor.vimファイルが読み込まれると、変数 "syntax_cmd" に次の3つの値の
 どれかがセットされる:
-   "on"		":syntax on" コマンド。ハイライト色が上書きされるがリンクはそ
+   "on"		`:syntax on` コマンド。ハイライト色が上書きされるがリンクはそ
 		のまま。
-   "enable"	":syntax enable" コマンド。まだハイライトが定義されていないグ
-		ループに対して色を定義するだけ。":syntax default" を使うこと。
-   "reset"	":syntax reset" コマンドまたはカラースキームを読み込む。全ての
+   "enable"	`:syntax enable` コマンド。まだハイライトが定義されていないグ
+		ループに対して色を定義するだけ。`:highlight default` を使うこ
+		と。
+   "reset"	`:syntax reset` コマンドまたはカラースキームを読み込む。全ての
 	        色を定義する。
    "skip"	色を定義しない。'runtimepath' で前にあるsyncolor.vimファイルが
 		既にデフォルト設定をセットしているとき、そのデフォルト設定をス