Changeset 321 for EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/NotifierPlugin.rb

Timestamp:

Aug 23, 2017, 9:27:43 AM (7 years ago)

Author:

coas-nagasima

Message:

文字コードを設定

File:

• EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/NotifierPlugin.rb (modified) (52 diffs, 1 prop)

EcnlProtoTool/trunk/asp3_dcre/tecsgen/tecslib/plugin/NotifierPlugin.rb

@@ -14 +14 @@
 class NotifierPlugin < CelltypePlugin
 
-        # ---------- アダプタ関数の生成 -------------
+        # ---------- アダプタ関数の生成 -------------
         #
-        # siHandlerBodyの受け口関数は，タイムイベント通知の通知å
-ˆã¨ã—て直接指定する
-        # ことはできない．シグネチャが一致していないことが理由である．このため，アダ
-        # プタとして動作する関数を生成し，カーネルからの呼出しをTECSの呼出しに変換で
-        # きるようにするå¿
-要がある．
+        # siHandlerBodyの受け口関数は，タイムイベント通知の通知先として直接指定する
+        # ことはできない．シグネチャが一致していないことが理由である．このため，アダ
+        # プタとして動作する関数を生成し，カーネルからの呼出しをTECSの呼出しに変換で
+        # きるようにする必要がある．
         #
-        # 基本的には，受け口毎にアダプタ関数を生成すれば十分である．しかし，これでは
-        # メモリ消費量が不å¿
-è¦ã«å¢—åŠ ã—ã¦ã—ã¾ã†ï¼Žãã“ã§ï¼Œé€šçŸ¥å
-ˆé–¢æ•°ã«intptr_t型の引数
-        # を渡せることに着目し，関数の"一般化"を図る．すなわち受け口のある属性(ここ
-        # では，結合å
-ˆã®ã‚»ãƒ«ï¼Œæ·»å­—などを指す)を，アダプタ関数の引数として受け取れる
-        # ようにし，1個のアダプタ関数を2個以上の結合に対し用いることができるように
-        # する．
+        # 基本的には，受け口毎にアダプタ関数を生成すれば十分である．しかし，これでは
+        # メモリ消費量が不必要に増加してしまう．そこで，通知先関数にintptr_t型の引数
+        # を渡せることに着目し，関数の"一般化"を図る．すなわち受け口のある属性(ここ
+        # では，結合先のセル，添字などを指す)を，アダプタ関数の引数として受け取れる
+        # ようにし，1個のアダプタ関数を2個以上の結合に対し用いることができるように
+        # する．
         #
-        # アダプタ関数の属性について整理すると，
-        #  - 受け口関数 - 一般化を行うと，実行時コストが大きく増大してしまうことが
-        #    確認されている．このため，一般化は行わない．EntryPropertyにも含めない．
-        #  - セルインデックス - CELLIDX型で，型の規定はないが，"ポインタ値であったり
-        #    整数値であったりする。" (TECS 5.3.6) より，インデックスかポインタある
-        #    ことが分かる．インデックスだとすると，この値はセルCBのアドレッシングに
-        #    使用されるので，intptr_tã«åŽã¾ã‚‹ç­ˆã§ã‚ã‚‹ï¼Žãƒã‚¤ãƒ³ã‚¿ã®å ´åˆï¼Œå½“ç„¶intptr_t
-        #    に収まる．
-        #  - 受け口é
-åˆ—の添字 - int_t．同様にintptr_tに収まる筈である．
-        # これらのうち，セルインデックスと受け口é
-åˆ—の添字はパラメータに含めることが
-        # できそうであるが，両方は無理である．
-        # ä¸¡æ–¹ã‚’æ ¼ç´ã—ãŸé
-åˆ—を生成し，そのé
-åˆ—ã®è¦ç´ へのポインタを渡すようにするとい
-        # う選択肢も可能であるが，実行速度を優å
-ˆã™ã‚‹ãŸã‚ã«ï¼Œã“の方法はとらなかった．
+        # アダプタ関数の属性について整理すると，
+        #  - 受け口関数 - 一般化を行うと，実行時コストが大きく増大してしまうことが
+        #    確認されている．このため，一般化は行わない．EntryPropertyにも含めない．
+        #  - セルインデックス - CELLIDX型で，型の規定はないが，"ポインタ値であったり
+        #    整数値であったりする。" (TECS 5.3.6) より，インデックスかポインタある
+        #    ことが分かる．インデックスだとすると，この値はセルCBのアドレッシングに
+        #    使用されるので，intptr_tに収まる筈である．ポインタの場合，当然intptr_t
+        #    に収まる．
+        #  - 受け口配列の添字 - int_t．同様にintptr_tに収まる筈である．
+        # これらのうち，セルインデックスと受け口配列の添字はパラメータに含めることが
+        # できそうであるが，両方は無理である．
+        # 両方を格納した配列を生成し，その配列の要素へのポインタを渡すようにするとい
+        # う選択肢も可能であるが，実行速度を優先するために，この方法はとらなかった．
         #
-        # このため，一般化は以下のパターンに分類して行う．
+        # このため，一般化は以下のパターンに分類して行う．
         #
-        # 1. セルインデックスのみ一般化．セルインデックスのパターン数が受け口é
-åˆ—の
-        #    添字のパターン数より多いか，あるいは受け口がé
-åˆ—ã§ãªã„å ´åˆã«è¡Œã‚ã‚Œã‚‹ï¼Ž
-        # 2. 受け口é
-åˆ—ã®æ·»å­—ã®ã¿ä¸€èˆ¬åŒ–ï¼Žã“ã®å ´åˆï¼Œã‚»ãƒ«ã”ã¨ã«ç•°ãªã‚‹é–¢æ•°ã‚’ç”¨ã„ã‚‹ï¼Ž
+        # 1. セルインデックスのみ一般化．セルインデックスのパターン数が受け口配列の
+        #    添字のパターン数より多いか，あるいは受け口が配列でない場合に行われる．
+        # 2. 受け口配列の添字のみ一般化．この場合，セルごとに異なる関数を用いる．
         #
-        # これより，各受け口関数について，アダプタ関数の生成個数は，
-        #         O(min{セルインデックスのパターン数, 添字のパターン数})
-        # となる．
+        # これより，各受け口関数について，アダプタ関数の生成個数は，
+        #         O(min{セルインデックスのパターン数, 添字のパターン数})
+        # となる．
         #
-        # プラグインでの処理をワンパスで行うために，tecsgen.cfgではアダプタ関数を直
-        # 接指定するのではなく，代わりにアダプタ関数を表すマクロを使用する．この
-        # マクロはアダプタ関数ハンドルと呼ぶことにする．
-        # アダプタ関数ハンドルは，次の2å€‹ã®è¦ç´ ã‹ã‚‰æˆã‚‹ï¼Ž
-        #  - アダプタ関数へののポインタ
-        #  - アダプタ関数の引数
+        # プラグインでの処理をワンパスで行うために，tecsgen.cfgではアダプタ関数を直
+        # 接指定するのではなく，代わりにアダプタ関数を表すマクロを使用する．この
+        # マクロはアダプタ関数ハンドルと呼ぶことにする．
+        # アダプタ関数ハンドルは，次の2個の要素から成る．
+        #  - アダプタ関数へののポインタ
+        #  - アダプタ関数の引数
 
         # @private
         class AdapterGenerator
 
-                # 結合å
-ˆã«é–¢ã™ã‚‹å±žæ€§ã‚’含む．セル，受け口é
-åˆ—の添字から成る．
-                # 同一のEntryPropertyとなる結合は，å
-¨ãåŒã˜æ–¹æ³•ã§ãã®å—け口関数を呼び
-                # 出せる．
+                # 結合先に関する属性を含む．セル，受け口配列の添字から成る．
+                # 同一のEntryPropertyとなる結合は，全く同じ方法でその受け口関数を呼び
+                # 出せる．
                 # @private
                 class EntryProperty
-                        # @return [Cell] 受け口側のセル．
+                        # @return [Cell] 受け口側のセル．
                         attr_reader :cell
 
-                        # @return [Integer, nil] 受け口é
-åˆ—の添字．é
-åˆ—ã§ãªã„å ´åˆã¯nil．
+                        # @return [Integer, nil] 受け口配列の添字．配列でない場合はnil．
                         attr_reader :subscript
 
@@ -100 +82 @@
                         end
 
-                        # 同値性の定義．Hashのキーとして使用するのにå¿
-要．
+                        # 同値性の定義．Hashのキーとして使用するのに必要．
                         def eql?(o) @cell == o.cell && @subscript == o.subscript end
                         def hash() @cell.hash ^ @subscript.hash end
@@ -108 +89 @@
                 # @private
                 class EntryPort
-                        # @param [Port] port 結合å
-ˆã®ã‚»ãƒ«ã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—の受け口．
+                        # @param [Port] port 結合先のセルのセルタイプの受け口．
                         def initialize(port, prefix)
                                 @port = port
                                 @global_name = "#{prefix}_#{@port.get_celltype.get_global_name}_#{@port.get_name}"
 
-                                # 受け口関数名．siHandlerBodyを想定しているので，関数名はmainで固定である．
+                                # 受け口関数名．siHandlerBodyを想定しているので，関数名はmainで固定である．
                                 @entry_fn_name = "#{@port.get_celltype.get_global_name}_#{@port.get_name}_main"
 
@@ -121 +101 @@
                         end
 
-                        # @return [String] グローバルに一意(なものとして扱えるよう)な識別子．
+                        # @return [String] グローバルに一意(なものとして扱えるよう)な識別子．
                         attr_reader :global_name
 
@@ -127 +107 @@
                         attr_reader :port
 
-                        # 指定したEntryPropertyに対応するアダプタ関数ハンドルを取得する．
+                        # 指定したEntryPropertyに対応するアダプタ関数ハンドルを取得する．
                         # @param [EntryProperty] ep
-                        # @return [String] アダプタ関数ハンドル．
+                        # @return [String] アダプタ関数ハンドル．
                         # @private
                         def adapter_handle_for_entry_property(ep)
@@ -139 +119 @@
                         end
 
-                        # 結合å
-ˆã®æƒ
-å ±ã«å¿œã˜ãŸã‚¢ãƒ€ãƒ—ã‚¿é–¢æ•°ã‚’ã‚½ãƒ¼ã‚¹ãƒ»ãƒ˜ãƒƒãƒ€ãƒ¼ã«å‡ºåŠ›ã™ã‚‹ï¼Ž
-                        # 一般化指定は，`cell`または`subscript`の一方のみ行うことができる．
+                        # 結合先の情報に応じたアダプタ関数をソース・ヘッダーに出力する．
+                        # 一般化指定は，`cell`または`subscript`の一方のみ行うことができる．
                         #
                         # @param [AdapterGenerator] context
-                        # @param [String] fn_name 関数名．
-                        # @param [Cell, Symbol] cell ã‚»ãƒ«ï¼Žã‚»ãƒ«ã«ã¤ã„ã¦ä¸€èˆ¬åŒ–ã™ã‚‹å ´åˆã¯ `:generic`
-                        # @param [Integer, Symbol, nil] subscript æ·»å­—ï¼Žæ·»å­—ã«ã¤ã„ã¦ä¸€èˆ¬åŒ–ã™ã‚‹å ´åˆã¯ `:generic`
+                        # @param [String] fn_name 関数名．
+                        # @param [Cell, Symbol] cell セル．セルについて一般化する場合は `:generic`
+                        # @param [Integer, Symbol, nil] subscript 添字．添字について一般化する場合は `:generic`
                         # @private
                         def generate_inner(context, fn_name, cell, subscript)
@@ -158 +136 @@
                                 ct = @port.get_celltype
 
-                                # シングルトンセルタイプ以外では，CELLIDXの指定がå¿
-要．
+                                # シングルトンセルタイプ以外では，CELLIDXの指定が必要．
                                 unless ct.is_singleton?
                                         if cell == :generic
                                                 params << "(CELLIDX)extinf"
                                         else
-                                                # セルのCELLIDXを得る
+                                                # セルのCELLIDXを得る
                                                 if ct.has_INIB? || ct.has_CB?
                                                         params << ct.get_name_array(cell)[7]
@@ -173 +150 @@
                                 end
 
-                                # 受け口é
-åˆ—の添字．
+                                # 受け口配列の添字．
                                 if @port.get_array_size
                                         if subscript == :generic
@@ -192 +168 @@
                         end
 
-                        # 指定したJoinに対応するアダプタ関数ハンドルを取得する．
-                        # @return [Array] アダプタ関数ハンドル．
+                        # 指定したJoinに対応するアダプタ関数ハンドルを取得する．
+                        # @return [Array] アダプタ関数ハンドル．
                         def make_adapter_handle(join)
                                 prop = EntryProperty.from_join(join)
@@ -203 +179 @@
                         end
 
-                        # ソース・ヘッダーの記述を生成する．
+                        # ソース・ヘッダーの記述を生成する．
                         # @param [AdapterGenerator] context
                         def generate(context)
@@ -217 +193 @@
                                 no_cellidx = false
                                 if !(ct.has_INIB? || ct.has_CB?)
-                                        # CB, INIB最適化により，CB, INIBが両方不要になったケース．
-                                        # CELLIDXが不要であるので，セルについて一般化しても意味
-                                        # はないので，添字による一般化を選択する．
+                                        # CB, INIB最適化により，CB, INIBが両方不要になったケース．
+                                        # CELLIDXが不要であるので，セルについて一般化しても意味
+                                        # はないので，添字による一般化を選択する．
                                         generalize_by_cell_idx = false
                                         no_cellidx = true
 
-                                        # å
-¨ã¦ã®ã‚»ãƒ«ã‚’同一視する．
+                                        # 全てのセルを同一視する．
                                         cells = { @props[0].cell => @props }
 
                                         header_file.print " * No INIB & CB: generalized by subscript\n"
                                 elsif @port.get_array_size
-                                        # 一般化パターンの分類を行うために，受け口側セルや添字の
-                                        # パターン数を分析して，最適な方を選択する．
+                                        # 一般化パターンの分類を行うために，受け口側セルや添字の
+                                        # パターン数を分析して，最適な方を選択する．
                                         generalize_by_cell_idx = cells.length >= subscripts.length
                                         if generalize_by_cell_idx
@@ -238 +213 @@
                                         end
                                 else
-                                        # 常にCELLIDXで一般化
+                                        # 常にCELLIDXで一般化
                                         generalize_by_cell_idx = true
                                         header_file.print " * non-array entry port: generalized by cell\n"
@@ -246 +221 @@
 
                                 if generalize_by_cell_idx
-                                        # CELLIDXについて一般化
+                                        # CELLIDXについて一般化
                                         subscripts.each { |subscript, props|
                                                 if subscript
                                                         fn_name = "#{@global_name}_adap_#{subscript}"
                                                 else
-                                                        # 受け口é
-åˆ—ã§ãªã„å ´åˆ
+                                                        # 受け口配列でない場合
                                                         fn_name = "#{@global_name}_adap"
                                                 end
@@ -262 +236 @@
                                                         handle = adapter_handle_for_entry_property(prop)
 
-                                                        # セルのCELLIDXを得る
+                                                        # セルのCELLIDXを得る
                                                         if ct.has_INIB? || ct.has_CB?
                                                                 idx = ct.get_name_array(prop.cell)[7]
@@ -273 +247 @@
                                         }
                                 else
-                                        # 添字について一般化
+                                        # 添字について一般化
                                         cells.each { |cell, props|
                                                 if no_cellidx
-                                                        # CB/INIB なし
+                                                        # CB/INIB なし
                                                         fn_name = "#{@global_name}_adap"
                                                 else
@@ -302 +276 @@
                 attr :header_file
 
-                # @param [String] celltype_name ハンドラ関数のセルタイプ．
-                # @param [String] prefix 名前衝突を防ぐためのプレフィックス．
+                # @param [String] celltype_name ハンドラ関数のセルタイプ．
+                # @param [String] prefix 名前衝突を防ぐためのプレフィックス．
                 def initialize(celltype_name, prefix)
                         @celltype_name = celltype_name
@@ -313 +287 @@
 
                 # ===AdapterGenerator#make_adapter_handle===
-                # 指定した結合の呼出しを行うためのアダプタ関数ハンドルを生成する．
-                # @return [Array] アダプタ関数ハンドル．
+                # 指定した結合の呼出しを行うためのアダプタ関数ハンドルを生成する．
+                # @return [Array] アダプタ関数ハンドル．
                 def make_adapter_handle(join)
                         entry_port = @entry_ports[join.get_rhs_port]
@@ -326 +300 @@
 
                 # ===AdapterGenerator#finish===
-                # 各受け口に対し，アダプタ関数を生成する．
+                # 各受け口に対し，アダプタ関数を生成する．
                 def finish
                         @source_file = AppFile.open( "#{$gen}/#{@celltype_name}.c" )
@@ -336 +310 @@
                 @header_file.print "\n/* Generated by #{self.class.name} */\n\n"
 
-                        # NotifierPluginã‚’ä½¿ç”¨ã™ã‚‹ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ãŒè¤‡æ•°ã‚ã‚‹å ´åˆï¼Œãã‚Œãžã‚Œã«
-                        # 対しAdapterGenerator#finishが呼び出される．tTimeEventHandler.hに
-                        # 続けて書き込んでしまうと，ヘッダーガードの関係で2回目以降の記述
-                        # が読み込まれなくなってしまう．このため，ファイル名 + セルタイプ名
-                        # という少し特殊なヘッダーガードを用いる．
+                        # NotifierPluginを使用するセルタイプが複数ある場合，それぞれに
+                        # 対しAdapterGenerator#finishが呼び出される．tTimeEventHandler.hに
+                        # 続けて書き込んでしまうと，ヘッダーガードの関係で2回目以降の記述
+                        # が読み込まれなくなってしまう．このため，ファイル名 + セルタイプ名
+                        # という少し特殊なヘッダーガードを用いる．
                         header_guard = "#{@celltype_name}_H_#{@prefix}"
 
@@ -346 +320 @@
                 @header_file.print "\#define #{header_guard}\n\n"
 
-                # カーネルコンフィギュレータを実行する際，ハンドラ受け口のセルタイプ
-                # のセルCBの定義がå¿
-è¦ãªå ´åˆãŒã‚ã‚‹ï¼Ž
+                # カーネルコンフィギュレータを実行する際，ハンドラ受け口のセルタイプ
+                # のセルCBの定義が必要な場合がある．
                 @header_file.print "\#include \"#{@celltype_name}_aux.h\"\n\n"
 
-                        # 結合å
-ˆã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—の定義は，自分のセルのtecsgen.hよりもå
-ˆã«
-                        # 読み込まなければならないが，このプラグインが複数実行されると，
-                        # é †åºãŒå´©ã‚Œã¦ã—ã¾ã†ï¼Žãã“ã§ï¼Œçµåˆå
-ˆã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—の定義はもう一つの
-                        # ヘッダーファイル(tCelltypeName_aux.h)から読み込むようにする．
+                        # 結合先のセルタイプの定義は，自分のセルのtecsgen.hよりも先に
+                        # 読み込まなければならないが，このプラグインが複数実行されると，
+                        # 順序が崩れてしまう．そこで，結合先のセルタイプの定義はもう一つの
+                        # ヘッダーファイル(tCelltypeName_aux.h)から読み込むようにする．
                         aux_header_file = AppFile.open( "#{$gen}/#{@celltype_name}_aux.h" )
                 aux_header_file.print "\n/* Generated by #{self.class.name} */\n\n"
@@ -368 +338 @@
                         cb_type_only_guard = "#{@celltype_name}_AUX_H_#{@prefix}_CB_TYPE_ONLY"
 
-                        # 結合å
-ˆã®ã‚»ãƒ«ã‚¿ã‚¤ãƒ—の定義を読み込む
+                        # 結合先のセルタイプの定義を読み込む
                         aux_header_file.print "#ifndef TOPPERS_CB_TYPE_ONLY\n"
                     aux_header_file.print "#define TOPPERS_CB_TYPE_ONLY\n"
@@ -400 +369 @@
         end
 
-        # ------ 通知のハンドラの種類の定義 -------
+        # ------ 通知のハンドラの種類の定義 -------
 
         class Handler
@@ -410 +379 @@
         end
 
-        # 通常のハンドラ
+        # 通常のハンドラ
         EVENT_HANDLER = Handler::new("ciNotificationHandler")
 
-        # エラーハンドラ (é€šå¸¸ã®ãƒãƒ³ãƒ‰ãƒ©ãŒå¤±æ•—ã—ãŸå ´åˆã«å‘¼ã³å‡ºã•ã‚Œã‚‹)
+        # エラーハンドラ (通常のハンドラが失敗した場合に呼び出される)
         ERROR_HANDLER = Handler::new("ciErrorNotificationHandler")
 
@@ -436 +405 @@
         end
 
-        # ------ 通知の属性の定義 -------
+        # ------ 通知の属性の定義 -------
         #
-        # ãƒãƒ³ãƒ‰ãƒ©ã‚¿ã‚¤ãƒ—ã«åˆè‡´ã—ãªã„å±žæ€§ãŒæŒ‡å®šã•ã‚ŒãŸå ´åˆã«
-        # エラーを出力できるよう、å
-¨ã¦ã®å±žæ€§ã‚’ここで列挙する。
+        # ハンドラタイプに合致しない属性が指定された場合に
+        # エラーを出力できるよう、全ての属性をここで列挙する。
 
         SETVAR_ADDR_ATTR =   HandlerAttribute::new("setVariableAddress")
@@ -456 +424 @@
         ]
 
-        # ------ ハンドラタイプの定義 -------
+        # ------ ハンドラタイプの定義 -------
 
         class BaseHandlerType
@@ -470 +438 @@
 
             #=== NotifierPlugin#BaseHandlerType#validate_join
-            # 指定したセルの結合å
-ˆãŒã€ã“のハンドラタイプに該当するかを検証
-            # handler:: Handler : ハンドラ
-            # cell:: Cell : セル
-            # join:: Join : 結合 (declarationがPortであるもの)
+            # 指定したセルの結合先が、このハンドラタイプに該当するかを検証
+            # handler:: Handler : ハンドラ
+            # cell:: Cell : セル
+            # join:: Join : 結合 (declarationがPortであるもの)
                 def validate_join(handler, cell, join)
                 return !generate_attr_map(handler, cell).nil?
@@ -480 +447 @@
 
             #=== NotifierPlugin#BaseHandlerType#generate_attr_map
-            # 指定したセルの属性と、既知のHandlerAttributeのマッピングを
-            # 生成し、Hash<HandlerAttribute, Join> (各属性とそれに対応する
-            # Join(declarationがDeclのもの)を表すHash)、あるいは、
-                # ãƒžãƒƒãƒ”ãƒ³ã‚°ãŒè¡Œãˆãªã„å ´åˆ(属性の不足、過剰)はnilを返す。
+            # 指定したセルの属性と、既知のHandlerAttributeのマッピングを
+            # 生成し、Hash<HandlerAttribute, Join> (各属性とそれに対応する
+            # Join(declarationがDeclのもの)を表すHash)、あるいは、
+                # マッピングが行えない場合(属性の不足、過剰)はnilを返す。
             #
-            # handler:: Handler : ハンドラ
-            # cell:: Cell : セル
+            # handler:: Handler : ハンドラ
+            # cell:: Cell : セル
                 def generate_attr_map(handler, cell)
                         map = {}
@@ -496 +463 @@
                                 join = join_list.get_item(attr_name.to_sym)
 
-                                # このセルタイプにおいてå¿
-é ˆã®å±žæ€§ã‹?
+                                # このセルタイプにおいて必須の属性か?
                                 is_required = @required_attributes.include?(known_attr)
 
-                                # 属性の指定が不足している? or 過剰?
-                                # 注: ハンドラタイプの判別には、セルで値が指定されているか
-                                #     が考æ
-®ã•ã‚Œã‚‹ã€‚セルタイプで初期値が指定されていても、
-                                #     それはハンドラタイプの決定に影響しない。
+                                # 属性の指定が不足している? or 過剰?
+                                # 注: ハンドラタイプの判別には、セルで値が指定されているか
+                                #     が考慮される。セルタイプで初期値が指定されていても、
+                                #     それはハンドラタイプの決定に影響しない。
                                 return nil if join.nil? != !is_required
 
-                                # å¿
-要のない属性であり、指定もされていないので飛ばす
+                                # 必要のない属性であり、指定もされていないので飛ばす
                                 next if join.nil?
 
-                                # TODO: attrの結合であることを検証
+                                # TODO: attrの結合であることを検証
 
                                 map[known_attr] = join
@@ -520 +484 @@
 
             #=== NotifierPlugin#BaseHandlerType#gen_cfg_handler_type
-            # タイムイベントの通知の種類を表すコンフィギュレータの記述を生成し、Stringまたはnilを返す
-            # handler:: Handler : ハンドラ
+            # タイムイベントの通知の種類を表すコンフィギュレータの記述を生成し、Stringまたはnilを返す
+            # handler:: Handler : ハンドラ
                 def gen_cfg_handler_type(handler)
                 raise "called abstract method gen_cfg_handler_type"
@@ -527 +491 @@
 
             #=== NotifierPlugin#BaseHandlerType#gen_cfg_handler_parameters
-            # タイムイベントの通知の引数を表すコンフィギュレータの記述を生成し、String[]を返す
-            # handler:: Handler : ハンドラ
-            # join:: Join : 結合 (declarationがPortであるもの)
+            # タイムイベントの通知の引数を表すコンフィギュレータの記述を生成し、String[]を返す
+            # handler:: Handler : ハンドラ
+            # join:: Join : 結合 (declarationがPortであるもの)
             # attrMap:: Hash<HandlerAttribute, Join> :
-            #     各属性とそれに対応するJoin (declarationがDeclのもの)
-            # cell:: Cell : セル
-                # adpt_gen:: AdapterGenerator : アダプタ関数を生成するオブジェクト
+            #     各属性とそれに対応するJoin (declarationがDeclのもの)
+            # cell:: Cell : セル
+                # adpt_gen:: AdapterGenerator : アダプタ関数を生成するオブジェクト
                 def gen_cfg_handler_parameters(handler, join, attrMap, cell, adpt_gen)
                 return nil
@@ -539 +503 @@
 
             #=== NotifierPlugin#BaseHandlerType#might_fail
-            # 通知の際、エラーが発生し、その結果エラー通知を呼ぶå¿
-要が生じる
-            # かどうかを返す。
+            # 通知の際、エラーが発生し、その結果エラー通知を呼ぶ必要が生じる
+            # かどうかを返す。
                 def might_fail
                         return false
@@ -557 +520 @@
                         id_attr = join.get_rhs_cell.get_celltype.find(:id)
                         if id_attr_join
-                                # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                                # セル生成時に初期化する場合
                                 id = id_attr_join.get_rhs.to_s
                         else
-                                # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                                # セルタイプの初期化値を使う場合
                                 id = id_attr.get_initializer.to_s
                         end
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = taskCell.get_celltype.get_name_array(taskCell)
                         id = taskCell.get_celltype.subst_name(id, name_array)
@@ -617 +580 @@
                         var_value = attrMap[SETVAR_VALUE_ATTR].get_rhs.to_s
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = cell.get_celltype.get_name_array(cell)
                         var_addr = cell.get_celltype.subst_name(var_addr, name_array)
@@ -646 +609 @@
                         var_addr = attrMap[SETVAR_ADDR_ATTR].get_rhs.to_s
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = cell.get_celltype.get_name_array(cell)
                         var_addr = cell.get_celltype.subst_name(var_addr, name_array)
@@ -673 +636 @@
                         var_addr = attrMap[INCVAR_ADDR_ATTR].get_rhs.to_s
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = cell.get_celltype.get_name_array(cell)
                         var_addr = cell.get_celltype.subst_name(var_addr, name_array)
@@ -697 +660 @@
                         id_attr = join.get_rhs_cell.get_celltype.find(:id)
                         if id_attr_join
-                                # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                                # セル生成時に初期化する場合
                                 id = id_attr_join.get_rhs.to_s
                         else
-                                # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                                # セルタイプの初期化値を使う場合
                                 id = id_attr.get_initializer.to_s
                         end
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = semaphoreCell.get_celltype.get_name_array(semaphoreCell)
                         id = semaphoreCell.get_celltype.subst_name(id, name_array)
@@ -737 +700 @@
                         id_attr = join.get_rhs_cell.get_celltype.find(:id)
                         if id_attr_join
-                                # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                                # セル生成時に初期化する場合
                                 id = id_attr_join.get_rhs.to_s
                         else
-                                # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                                # セルタイプの初期化値を使う場合
                                 id = id_attr.get_initializer.to_s
                         end
                         flg_pattern = attrMap[SETFLG_FLAG_ATTR].get_rhs.to_s
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = eventflagCell.get_celltype.get_name_array(eventflagCell)
                         id = eventflagCell.get_celltype.subst_name(id, name_array)
@@ -778 +741 @@
                         id_attr = join.get_rhs_cell.get_celltype.find(:id)
                         if id_attr_join
-                                # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                                # セル生成時に初期化する場合
                                 id = id_attr_join.get_rhs.to_s
                         else
-                                # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                                # セルタイプの初期化値を使う場合
                                 id = id_attr.get_initializer.to_s
                         end
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = dataqueueCell.get_celltype.get_name_array(dataqueueCell)
                         id = dataqueueCell.get_celltype.subst_name(id, name_array)
@@ -812 +775 @@
                         sent_value = attrMap[SNDDTQ_VALUE_ATTR].get_rhs.to_s
 
-                        # $id$等の置換
+                        # $id$等の置換
                         name_array = cell.get_celltype.get_name_array(cell)
                         sent_value = cell.get_celltype.subst_name(sent_value, name_array)
@@ -854 +817 @@
                 end
                 def gen_cfg_handler_parameters(handler, join, attrMap, cell, adpt_gen)
-                        # tTimeEventHandlerの結合å
-ˆã‚’取得
+                        # tTimeEventHandlerの結合先を取得
                         handler_cell = join.get_rhs_cell
                 call_join = handler_cell.get_join_list.get_item(:ciHandlerBody)
 
-                        # çµåˆã•ã‚Œã¦ã„ãªã„å ´åˆã¯tecsgenがエラーを出すはずなのでここでは
-                        # エラーにせず無視する．
+                        # 結合されていない場合はtecsgenがエラーを出すはずなのでここでは
+                        # エラーにせず無視する．
                         return [] unless call_join
 
-                        # アダプタ関数ハンドルを取得
+                        # アダプタ関数ハンドルを取得
                         adapter_handle = adpt_gen.make_adapter_handle(call_join)
                 return [adapter_handle[1], adapter_handle[0]]
@@ -897 +859 @@
 
     #@celltype:: Celltype
-    #@option:: String     :オプション文字列
+    #@option:: String     :オプション文字列
     def initialize( celltype, option )
         super
         @plugin_arg_check_proc_tab = NotifierPluginArgProc
         @plugin_arg_str = option
-        @plugin_arg_str = option.gsub( /\A"(.*)/, '\1' )    # 前後の "" を取り除く
+        @plugin_arg_str = option.gsub( /\A"(.*)/, '\1' )    # 前後の "" を取り除く
         @plugin_arg_str.sub!( /(.*)"\z/, '\1' )
         @factory = nil
@@ -940 +902 @@
         kernelCfg.print "\#include \"tTimeEventHandler.h\"\n"
 
-                # アダプタ関数を生成する準備
+                # アダプタ関数を生成する準備
                 @adpt_gen = AdapterGenerator.new("tTimeEventHandler", @celltype.get_global_name)
 
-        # 属性置換が行えることを検証する。
-        # ここで行うのは、factoryで指定された属性名が
-        # 存在することを確認し、しなければエラーを出力することのみである。
-        # セルごとの処理の最中にエラーを出力することも可能ではあるが、
-        # そうするとセルタイプ側の問題であるのにもかかわらず、セルごとに
-        # エラーが表示されてしまう。
+        # 属性置換が行えることを検証する。
+        # ここで行うのは、factoryで指定された属性名が
+        # 存在することを確認し、しなければエラーを出力することのみである。
+        # セルごとの処理の最中にエラーを出力することも可能ではあるが、
+        # そうするとセルタイプ側の問題であるのにもかかわらず、セルごとに
+        # エラーが表示されてしまう。
         # {{attribute_name}} -> attribute_value
         @factory.scan(/\{\{([a-zA-Z0-9_]*?)\}\}/) { |match|
                 name = $1.to_sym
 
-                # {{_handler_params_}} はハンドラに関する指定。プラグインå†
-で値が生成される
+                # {{_handler_params_}} はハンドラに関する指定。プラグイン内で値が生成される
                 next if name == :_handler_params_
 
@@ -968 +929 @@
         }
 
-                # アダプタ関数の生成を完了させる
+                # アダプタ関数の生成を完了させる
                 @adpt_gen.finish
 
@@ -982 +943 @@
         handler_flag = nil
 
-                # ignoreErrorsを取得
+                # ignoreErrorsを取得
                 ignoreErrors_attr_join = cell.get_join_list.get_item(:ignoreErrors)
                 ignoreErrors_attr = cell.get_celltype.find(:ignoreErrors)
                 if ignoreErrors_attr_join
-                        # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                        # セル生成時に初期化する場合
                         ignoreErrors = ignoreErrors_attr_join.get_rhs.to_s
                 else
-                        # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                        # セルタイプの初期化値を使う場合
                         ignoreErrors = ignoreErrors_attr.get_initializer.to_s
                 end
@@ -1002 +963 @@
 
         [EVENT_HANDLER, ERROR_HANDLER].each { |handler|
-                # 呼び口の結合を取得
+                # 呼び口の結合を取得
                 call_join = cell.get_join_list.get_item(handler.call_port_name.to_sym)
 
-                # ハンドラタイプを判別する
+                # ハンドラタイプを判別する
                 matches = HANDLER_TYPES.select { |handler_type|
                         handler_type.validate_join(handler, cell, call_join)
@@ -1015 +976 @@
                 end
 
-                        # 最初に見つかった有効なハンドラタイプを使用
+                        # 最初に見つかった有効なハンドラタイプを使用
                 ht = matches[0]
 
-                        # 通知ハンドラで「エラーが発生するはずがない」のに「エラーハンドラが指定されている」
-                        # もしくはその逆のパターンを検出する。
-                        # (handler_flagがnilã§ã‚ã‚‹å ´åˆã€ãƒãƒ³ãƒ‰ãƒ©ã‚¿ã‚¤ãƒ—ãŒä¸æ˜Žã§ã‚ã‚Šã€ã‚¨ãƒ©ãƒ¼ãŒç™ºç”Ÿã™ã‚‹ã‹ä¸æ˜Ž
-                        #  なため、検出は行わない。)
+                        # 通知ハンドラで「エラーが発生するはずがない」のに「エラーハンドラが指定されている」
+                        # もしくはその逆のパターンを検出する。
+                        # (handler_flagがnilである場合、ハンドラタイプが不明であり、エラーが発生するか不明
+                        #  なため、検出は行わない。)
                 if handler == ERROR_HANDLER && !ht.is_a?(NullHandlerType) && !event_handler_might_fail
                         cdl_error( "ASP1004 cell $1: handler type $2 which never raises an error was inferred for the normal notification handler, but an error notification handler was specified.",
@@ -1036 +997 @@
                 end
 
-                        # 通知方法の静的API記述を生成する
+                        # 通知方法の静的API記述を生成する
                 handler_flag = ht.gen_cfg_handler_type(handler)
                 handler_flags << handler_flag if handler_flag
@@ -1050 +1011 @@
         }
 
-                # $id$等の置換
+                # $id$等の置換
                 name_array = cell.get_celltype.get_name_array(cell)
                 handler_args.collect! { |e|
@@ -1060 +1021 @@
                 }
 
-        # tecsgen.cfgの記述を生成する。
-        # factoryに対し、パラメータ置換を行う。
+        # tecsgen.cfgの記述を生成する。
+        # factoryに対し、パラメータ置換を行う。
         # {{attribute_name}} -> attribute_value
         text = @factory.gsub(/\{\{([a-zA-Z0-9_]*?)\}\}/) { |match|
@@ -1067 +1028 @@
                         subst_attr = cell.get_celltype.find(name)
 
-                        # {{_handler_params_}} はハンドラの指定に置換する。
+                        # {{_handler_params_}} はハンドラの指定に置換する。
                         if name == :_handler_params_
                         args_joined = handler_flags.join(' | ')
@@ -1078 +1039 @@
 
                         unless subst_attr
-                                # å±žæ€§ãŒè¦‹ã¤ã‹ã‚‰ãªã„ã¨ã„ã†ã‚¨ãƒ©ãƒ¼ã¯ã™ã§ã«å ±å‘Šã•ã‚Œã¦ã„ã‚‹ã®ã§
-                                # ここではダミー値を返しておくだけである。
+                                # 属性が見つからないというエラーはすでに報告されているので
+                                # ここではダミー値を返しておくだけである。
                                 next ""
                         end
@@ -1085 +1046 @@
                         subst_attr_join = cell.get_join_list.get_item(name)
                         if subst_attr_join
-                                # ã‚»ãƒ«ç”Ÿæˆæ™‚ã«åˆæœŸåŒ–ã™ã‚‹å ´åˆ
+                                # セル生成時に初期化する場合
                                 subst = subst_attr_join.get_rhs.to_s
                         else
-                                # ã‚»ãƒ«ã‚¿ã‚¤ãƒ—ã®åˆæœŸåŒ–å€¤ã‚’ä½¿ã†å ´åˆ
+                                # セルタイプの初期化値を使う場合
                                 subst = subst_attr.get_initializer.to_s
                         end
 
-                        # $id$等の置換
+                        # $id$等の置換
                         cell.get_celltype.subst_name(subst, name_array)
         }
 
-        # 出力
+        # 出力
         kernelCfg.puts text