[seasar-javadoc:894] Re: [AbstractAnnotationHandler]

Koichi Kobayashi [E-MAIL ADDRESS DELETED]
2007年 6月 3日 (日) 02:03:01 JST


小林 (koichik) です.

Date:    Wed, 30 May 2007 23:32:50 +0900
From:    "Jundo Ishikawa" <[E-MAIL ADDRESS DELETED]>
To:      [E-MAIL ADDRESS DELETED]
Subject: [seasar-javadoc:892] Re: [AbstractAnnotationHandler]

>  それから、protectedなフィールドってコメントを書かないんでしたっけ?
> ちょっと覚えていないのですが。Javadocに反映されるかどうかだと、反映されて
> しまうみたいなのですが。。。

Wiki の「方針」としては

・private には書かない

となっているだけですね.
それだとデフォルト (package private) にも書かなきゃいけなく
なっちゃいますが,これは Javadoc に反映されないので
不要かなぁ.

異論が無ければ public および protected なメソッド
およびフィールドは書くことにしたいと思いますが
どうでしょうか?

P.S.
現在の s2-tiger プロジェクトは protected なメンバに
Javadoc がないと警告が出ます.
seasar2 もそうしたのですが,いつの間にかひがさんに
戻されちゃってますね...


-- 
<component name="koichik">
    <property name="fullName">"Koichi Kobayashi"</property>
    <property name="email">"[E-MAIL ADDRESS DELETED]"</property>
    <property name="blog">"http://d.hatena.ne.jp/koichik"</property>
</component>



seasar-javadoc メーリングリストの案内