掲示板一覧   -   トピック一覧
   EA ソースコード生成・コード生成テンプレート
     C++ JavaDocスタイルのコメント


フラット表示 前のトピック | 次のトピック
投稿者 トピック
sugimoto
投稿日時: 2007-11-28 15:22
EA Administrator
投稿: 1895

Re: C++ JavaDocスタイルのコメント

引用:

throwsのタグ付き値のノート欄に記載がある場合は、
「@exception (タグ付き値) (ノートの内容)」のように出力された
ほうが良いと思いますので、機能改善要望として検討いたします。


上記(2.)について、
操作のタグ付き値にthrowsを記述した場合に、タグ付き値の
ノートの情報と共に@exceptionをコメントに出力できないか、
機能改善要望として検討させていただきましたが、
以下の理由により、この対応は困難であることが判明しました。

---
操作に複数の例外が定義されている場合、1つのタグ付き値に
それらの情報を設定するようになっているが、タグ付き値の
ノート欄に記載された情報が、それら複数の例外のうち、どの
例外に該当しているのかは判断することができないため。

また、この複数例外がある場合のタグ付き値の設定方法を
変更してしまうと、すでにタグ付き値を設定しているユーザー
にとっては、情報を設定しなおす必要があるため、変更が困難。
---

上記理由ため、コメントとして出力したい情報は、
タグ付き値の「ノート欄」に、@exception を含んだ情報
「@exception 例外クラス名 説明文」を記載していただきますよう、
お願いいたします。
フラット表示 前のトピック | 次のトピック

題名 投稿者 日時
   C++ JavaDocスタイルのコメント sugimoto 2007-10-30 16:23
   » Re: C++ JavaDocスタイルのコメント sugimoto 2007-11-28 15:22