Merge pull request #1608 from vim-jp/hh-update-sign

Update sign.{txt,jax}

Author: h-east

doc/sign.jax

@@ -1,4 +1,4 @@
-*sign.txt*      For Vim バージョン 9.1.  Last change: 2024 Jun 08
+*sign.txt*      For Vim バージョン 9.1.  Last change: 2024 Jul 07
 
 
 		VIMリファレンスマニュアル    by Gordon Prieur
@@ -78,7 +78,9 @@
 							*sign-priority*
 設置された各目印には、優先順位値が割り当てられる。同じ行に複数の目印が設置され
 ている場合、最も優先順位の高い目印の属性が目印のグループとは独立して使用され
-る。デフォルトの優先順位は10である。優先順位は、目印の設置時に割り当てられる。
+る。デフォルトの優先順位は 10 だが、定義時に違う値を指定することにより、この値
+を異なる目印に対して変更することができる。優先順位は、目印の設置時に割り当てら
+れる。
 
 2つの同じプライオリティの目印が、1つがアイコンかテキストで signcolumn にあり、
 もう1つが行のハイライトとなっている場合であれば、両方が表示される。
@@ -130,6 +132,8 @@
 			Motif		pixmap (.xpm)
 			Win32		.bmp, .ico, .cur
 					pixmap (.xpm) |+xpm_w32|
+	priority={prio}
+		目印のデフォルトの優先順位。|sign-priority| を参照。
 
 	linehl={group}
 		目印が設置された行全体を強調表示するのに使われるハイライトグ
@@ -205,10 +209,11 @@
 
 		デフォルトでは、目印はグローバル目印グループに設置される。
 
-		デフォルトでは、目印にデフォルトの優先順位10が割り当てられてい
-		る。別の優先順位値を割り当てるには、"priority={prio}" を使用し
-		て値を指定する。優先順位は、複数の目印が同じ行に設置されている
-		ときに、表示される目印を決定するために使用される。
+		デフォルトでは、目印の定義で別途指定されていない限り、目印には
+		デフォルトの優先順位 10 が割り当てられる。別の優先順位値を割り
+		当てるには、"priority={prio}" を使用して値を指定する。優先順位
+		は、複数の目印が同じ行に設置されているときに、表示される目印を
+		決定するために使用される。
 
 		例: >
 			:sign place 5 line=3 name=sign1 file=a.py
@@ -407,6 +412,7 @@ sign_define({list})
 		   icon		目印用のビットマップファイルへのフルパス。
 		   linehl	目印が設置されている行全体に使用されるハイライ
 				トグループ。
+		   priority	目印のデフォルトの優先順位
 		   numhl	目印が設置されている行番号に使用されるハイライ
 				トグループ。
 		   text		アイコンがない場合、またはGUIが使用されていな
@@ -456,6 +462,7 @@ sign_getdefined([{name}])				*sign_getdefined()*
 		   linehl	目印が設置されている行全体に使用されるハイライ
 				トグループ。設定されなければ存在しない。
 		   name		目印の名前
+		   priority	目印のデフォルトの優先順位
 		   numhl	目印が設置されている行番号に使用されるハイライ
 				トグループ。設定されなければ存在しない。
 		   text		アイコンがない場合、またはGUIが使用されていな
@@ -645,8 +652,9 @@ sign_placelist({list})				*sign_placelist()*
 				|sign_define()| を参照。
 		    priority	目印の優先順位。1行に複数の目印が設置されてい
 				る場合、最も優先度の高い目印が使用される。指定
-				しない場合、デフォルト値の10が使用される。詳細
-				については |sign-priority| を参照。
+				されていない場合は、目印の定義で別途指定されて
+				いない限り、デフォルト値の 10 が使用される。詳
+				細については |sign-priority| を参照。
 
 		{id}が既存の目印を参照する場合、指定された{name}または
 		{priority}を使用するように既存の目印が変更される。

en/sign.txt

@@ -1,4 +1,4 @@
-*sign.txt*      For Vim version 9.1.  Last change: 2024 Jun 08
+*sign.txt*      For Vim version 9.1.  Last change: 2024 Jul 07
 
 
 		  VIM REFERENCE MANUAL    by Gordon Prieur
@@ -80,8 +80,9 @@ used by popup windows where 'cursorline' is set.
 							*sign-priority*
 Each placed sign is assigned a priority value. When multiple signs are placed
 on the same line, the attributes of the sign with the highest priority is used
-independently of the sign group. The default priority for a sign is 10. The
-priority is assigned at the time of placing a sign.
+independently of the sign group. The default priority for a sign is 10, this
+value can be changed for different signs by specifying a different value at
+definition time.  The priority is assigned at the time of placing a sign.
 
 When two signs with the same priority are present, and one has an icon or text
 in the signcolumn while the other has line highlighting, then both are
@@ -135,6 +136,8 @@ See |sign_define()| for the equivalent Vim script function.
 			Motif		pixmap (.xpm)
 			Win32		.bmp, .ico, .cur
 					pixmap (.xpm) |+xpm_w32|
+	priority={prio}
+		Default priority for the sign, see |sign-priority|.
 
 	linehl={group}
 		Highlighting group used for the whole line the sign is placed
@@ -209,11 +212,11 @@ See |sign_place()| for the equivalent Vim script function.
 
 		By default, the sign is placed in the global sign group.
 
-		By default, the sign is assigned a default priority of 10. To
-		assign a different priority value, use "priority={prio}" to
-		specify a value.  The priority is used to determine the sign
-		that is displayed when multiple signs are placed on the same
-		line.
+		By default, the sign is assigned a default priority of 10,
+		unless specified otherwise by the sign definition.  To assign a
+		different priority value, use "priority={prio}" to specify a
+		value.  The priority is used to determine the sign that is
+		displayed when multiple signs are placed on the same line.
 
 		Examples: >
 			:sign place 5 line=3 name=sign1 file=a.py
@@ -401,6 +404,7 @@ sign_define({list})
 		   icon		full path to the bitmap file for the sign.
 		   linehl	highlight group used for the whole line the
 				sign is placed in.
+		   priority	default priority value of the sign
 		   numhl	highlight group used for the line number where
 				the sign is placed.
 		   text		text that is displayed when there is no icon
@@ -453,6 +457,7 @@ sign_getdefined([{name}])				*sign_getdefined()*
 		   linehl	highlight group used for the whole line the
 				sign is placed in; not present if not set
 		   name		name of the sign
+		   priority	default priority value of the sign
 		   numhl	highlight group used for the line number where
 				the sign is placed; not present if not set
 		   text		text that is displayed when there is no icon
@@ -646,7 +651,8 @@ sign_placelist({list})				*sign_placelist()*
 		    priority	Priority of the sign. When multiple signs are
 				placed on a line, the sign with the highest
 				priority is used. If not specified, the
-				default value of 10 is used. See
+				default value of 10 is used, unless specified
+				otherwise by the sign definition. See
 				|sign-priority| for more information.
 
 		If {id} refers to an existing sign, then the existing sign is