[seasar-javadoc:998] Re: ComponentCreatorImpl

Koichi Kobayashi [E-MAIL ADDRESS DELETED]
2007年 8月 22日 (水) 05:00:03 JST


小林 (koichik) です.

Date:    Mon, 20 Aug 2007 00:31:28 +0900
From:    "Jundo Ishikawa" <[E-MAIL ADDRESS DELETED]>
To:      [E-MAIL ADDRESS DELETED]
Subject: [seasar-javadoc:993]  ComponentCreatorImpl

>  お疲れ様です。忙しかったり夏バテ気味だったりで着手できていなかった
> ComponentCreatorImplのJavadocを書いてみました。

ありがとうございます.
書き物で忙しいというか書けなくて忙しいというか
忙しいといいつつ手は動いてないので返事が遅れました.
m(__)m

>  あと、@linkに指定しているクラス名等ですが、ひがさんの書いてたコメント
> で気が付いたんですけど、パッケージ指定が無くてもimportとかあるとリンク
> ちゃんと付くんですね。

ですね.
[seasar-javadoc:828] でも話題になりました.

以下,Javadoc へのコメントです.

■クラスコメント

>  * インターフェースだけしかないクラスや抽象クラスを

インタフェースだけしかないクラスってなんか微妙かも.
ここは

 * インターフェースや抽象クラスを

で十分のような.
enableInterface の getter/setter も同様.

■getNameSuffix()/setNameSuffix()

>      * 対象コンポーネント名を識別するための名前のサフィックスを返します。

ここも短めに

     * コンポーネント名のサフィックスを返します。

で十分のような.

> ちょっと、しつこい感じになっちゃったかもしれません。

しつこいというほどでもなかったけれど,上述の
ところだけ気になったかなぁ.



-- 
<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 メーリングリストの案内