Update

Author: h-east

doc/vim9class.jax

@@ -118,7 +118,7 @@ new() メソッドを使用して、このクラスからオブジェクトを
 
 
 オブジェクト変数の書き込みアクセス ~
-
+						    *read-only-variable*
 では、オブジェクト変数を直接変更してみよう: >
 
 	pos.lnum = 9
@@ -133,7 +133,7 @@ new() メソッドを使用して、このクラスからオブジェクトを
 方法である。ほとんどの場合、値を使用しても問題はないが、値を設定すると注意が必
 要な副作用が発生する可能性がある。この場合、SetLnum() メソッドは行番号が有効か
 どうかをチェックし、エラーを返すか、最も近い有効な値を使用する。
-							*:public* *E1331*
+					*:public* *public-variable* *E1331*
 副作用を気にせず、オブジェクト変数をいつでも変更できるようにしたい場合は、オブ
 ジェクト変数をパブリックにすることができる: >
 
@@ -150,17 +150,17 @@ new() メソッドを使用して、このクラスからオブジェクトを
 							*E1376*
 クラス名を使用してオブジェクト変数にアクセスすることはできない。
 
-プライベート変数 ~
-					*private-variable* *E1332* *E1333*
-一方、オブジェクト変数を直接読み取られたくない場合は、オブジェクト変数をプライ
-ベートにすることができる。これは、名前の前にアンダースコアを付けることによって
-行う: >
+Protected 変数 ~
+					*protected-variable* *E1332* *E1333*
+一方、オブジェクト変数をクラスまたはそのサブクラスの外部から直接読み取られたく
+ない場合は、オブジェクト変数を保護することができる。これは、名前の前にアンダー
+スコアを付けることによって行われる: >
 
 	this._lnum: number
 	this._col number
 
-次に、プライベート変数の値を取得するメソッドを提供する必要がある。これらは一般
-にゲッターと呼ばれる。"Get" で始まる名前を使用することをお勧めする: >
+次に、protected 変数の値を取得するメソッドを提供する必要がある。これらは一般に
+ゲッターと呼ばれる。"Get" で始まる名前を使用することをお勧めする: >
 
 	def GetLnum(): number
 	   return this._lnum
@@ -180,10 +180,10 @@ new() メソッドを使用して、このクラスからオブジェクトを
 	   return this._lnum
 	enddef
 <
-プライベートメソッド ~
+Protected メソッド ~
 						*private-method* *E1366*
 オブジェクトメソッドを同じクラスの他のメソッドからのみアクセス可能にし、クラス
-の外部からは使用しないようにしたい場合は、オブジェクトメソッドをプライベートに
+の外部からは使用しないようにしたい場合は、オブジェクトメソッドを protected に
 できる。これを行うには、メソッド名の前にアンダースコアを付ける: >
 
     class SomeClass
@@ -195,7 +195,7 @@ new() メソッドを使用して、このクラスからオブジェクトを
 	enddef
     endclass
 <
-クラス外のプライベートメソッドにアクセスすると、エラーが発生する (上記のクラス
+クラス外の protected メソッドにアクセスすると、エラーが発生する (上記のクラス
 を使用した場合): >
 
     var a = SomeClass.new()
@@ -288,8 +288,8 @@ new() メソッドを定義するときは、戻り値の型を指定しない
 にアクセスすることはできない。
 
 オブジェクトメンバと同様に、名前の最初の文字としてアンダースコアを使用すること
-でアクセスをプライベートにすることができ、プリフィックス "public" を付けること
-でパブリックにすることができる: >
+でアクセスを保護することができ、プリフィックス "public" を付けることでアクセス
+を公開することができる: >
 
     class OtherThing
 	static total: number	      # 誰でも読み取り可、クラスのみ書き込み可
@@ -319,7 +319,7 @@ new() メソッドを定義するときは、戻り値の型を指定しない
 必要がある。
 
 オブジェクトメソッドと同様に、メソッド名の最初の文字としてアンダースコアを使用
-することで、アクセスをプライベートにすることができる: >
+することで、アクセスを protected にすることができる: >
 
     class OtherThing
 	static def _Foo()
@@ -469,9 +469,9 @@ Shape, Square および Triangle を使用した上記の例は、オブジェ
 <
 					*E1378* *E1379* *E1380* *E1387*
 インターフェイスには、オブジェクトメソッドと読み取り専用のオブジェクト変数のみ
-を含めることができる。インターフェイスには、読み書き可能なプライベートオブジェ
-クト変数、プライベートオブジェクトメソッド、クラス変数、およびクラスメソッドを
-含めることはできない。
+を含めることができる。インターフェイスには、読み書き可能または protected オブ
+ジェクト変数、protected オブジェクトメソッド、クラス変数、およびクラスメソッド
+を含めることはできまない。
 
 インターフェイスは、"extends" を使用して別のインターフェイスを拡張できる。サブ
 インターフェイスは、スーパーインターフェイスからすべてのインスタンス変数とメ
@@ -519,7 +519,7 @@ Shape, Square および Triangle を使用した上記の例は、オブジェ
 	specifies SomeInterface
 <							*E1355* *E1369*
 各変数とメソッドの名前は 1 回だけ使用できる。同じ名前で異なる型の引数を持つメ
-ソッドを定義することはできない。パブリックとプライベートのメンバー変数を同じ名
+ソッドを定義することはできない。パブリックと protected のメンバー変数を同じ名
 前で使用することはできない。スーパークラスで使用したオブジェクト変数名を子クラ
 スで再利用することはできない。
 
@@ -552,8 +552,8 @@ Shape, Square および Triangle を使用した上記の例は、オブジェ
 ラスのメソッドは、先頭に "super." を付けることで呼び出すことができる。
 
 						*E1377*
-子クラスのメソッド (パブリックまたはプライベート) のアクセスレベルは、スーパー
-クラスと同じである必要がある。
+子クラスのメソッド (パブリックまたは protected) のアクセスレベルは、スーパーク
+ラスと同じである必要がある。
 
 基底クラスの他のオブジェクトメソッドは、子クラスによって引き継がれる。
 
@@ -590,22 +590,22 @@ Shape, Square および Triangle を使用した上記の例は、オブジェ
 						*E1318* *E1325* *E1388*
 クラス内では、`:class` と `:endclass` の間に、次の項目を含めることができる:
 - オブジェクト変数宣言: >
-	this._privateVariableName: memberType
+	this._protectedVariableName: memberType
 	this.readonlyVariableName: memberType
 	public this.readwriteVariableName: memberType
 - クラス変数宣言: >
-	static _privateClassVariableName: memberType
+	static _protectedClassVariableName: memberType
 	static readonlyClassVariableName: memberType
 	static public readwriteClassVariableName: memberType
 - コンストラクタメソッド: >
 	def new(arguments)
 	def newName(arguments)
 - クラスメソッド: >
 	static def SomeMethod(arguments)
-	static def _PrivateMethod(arguments)
+	static def _ProtectedMethod(arguments)
 - オブジェクトメソッド: >
 	def SomeMethod(arguments)
-	def _PrivateMethod(arguments)
+	def _ProtectedMethod(arguments)
 
 オブジェクト変数の場合は、型を指定する必要がある。最善の方法は、": {type}" を
 使用してこれを明示的に行うことである。単純な型の場合、"= 123" などの初期化子を
@@ -696,8 +696,8 @@ Note ここでは "v:none" 以外のデフォルト値を使用できないこ
 ト変数を初期化したい場合は、それらが宣言されている場所で実行すること。この方法
 では、デフォルト値を 1 箇所で確認するだけで済む。
 
-すべてのオブジェクト変数はデフォルトコンストラクタで使用され、プライベートアク
-セスのコンストラクタも使用される。
+すべてのオブジェクト変数は、アクセス保護されたものを含め、デフォルトのコンスト
+ラクタで使用されます。
 
 クラスが別のクラスを拡張する場合、そのクラスのオブジェクト変数が最初に来る。
 
@@ -943,6 +943,18 @@ ClassName() メソッドはなく、ClassName というクラス内の別名の
 なり混乱する。
 
 
+Vim9class のアクセスモード ~
+						    *vim9-access-modes*
+The variable access modes, and their meaning, supported by Vim9class are
+Vim9class でサポートされる変数アクセスモードとその意味は、
+	|public-variable|	どこからでも読み書きできる
+	|read-only-variable|	どこからでも読み取れ、クラスおよびサブクラス内
+				から書き込みできる
+	|protected-variable|	クラスおよびサブクラス内から読み書きできる
+
+メソッドのアクセスモードは似ているが、読み取り専用モードがない。
+
+
 オブジェクト変数へのデフォルトの読み取りアクセス ~
 
 ユーザーの中には、オブジェクト変数のアクセスルールが非対称であると指摘する人も
@@ -958,35 +970,38 @@ ClassName() メソッドはなく、ClassName というクラス内の別名の
 の少ないコードを作成するのに役立つ。
 
 
-アンダースコアを使用してオブジェクト変数をプライベートにする ~
+アンダースコアを使用してオブジェクト変数を protected にする ~
 
 オブジェクト変数がプライベートの場合、クラス内 (およびサブクラス内) でのみ読み
-取りおよび変更でき、クラス外では使用できない。アンダースコアを先頭に付けること
-は、それを可視化する簡単な方法である。さまざまなプログラミング言語がこれを推奨
-している。
+取りおよび変更でき、クラス外では使用できない。
+
+オブジェクト変数が保護されている場合、その変数はクラス内 (およびサブクラス内)
+でのみ読み取りおよび変更でき、クラス外では使用できない。アンダースコアを先頭に
+付けることは、それを可視化する簡単な方法である。さまざまなプログラミング言語が
+これを推奨している。
 
 もし気が変わって、クラス外からオブジェクト変数にアクセスできるようにしたい場合
 は、すべてのアンダースコアを削除する必要がある。
 名前はクラス (およびサブクラス) の中にしか現れないため、見つけて変更するのは簡
 単である。
 
 逆の方法ははるかに困難である: クラス内のオブジェクト変数の先頭にアンダースコア
-を追加してプライベートにすることは簡単にできるが、他の場所で使用されている場合
+を追加して protected にすることは簡単にできるが、他の場所で使用されている場合
 は追跡して変更する必要がある。"set" メソッド呼び出しにする必要がある場合があ
 る。これは、アクセスを奪うには、そのアクセスが存在するすべての場所に対して作業
 を行う必要があるという現実の問題を反映している。
 
-別の方法としては、"public" がアクセスを別の方向に変更するのと同様に、"private"
-キーワードを使用することもできる。まぁ、これはキーワードの数を減らすためなのだ
-が。
+別の方法としては、"public" がアクセスを別の方向に変更するのと同様に、
+"protected" キーワードを使用することもできる。まぁ、これはキーワードの数を減ら
+すためなのだが。
 
 
-オブジェクト変数に protected はない ~
+オブジェクト変数に private はない ~
 
 一部の言語では、オブジェクト変数へのアクセスを制御するいくつかの方法が提供され
 ている。
 最もよく知られているのは "protected" だが、その意味は言語によって異なる。他に
-は "shared", "private" さらには "friend" もある。
+は "shared", "private", "package" さらには "friend" もある。
 
 これらのルールは人生をより困難にする。多くの人が同じ複雑なコードに取り組むプロ
 ジェクトでは、ミスを犯しやすいので、これは当然のことだ。特に、クラスモデルに対