[seasar-javadoc:814] Re: S2ContainerBuilder

[Koichi Kobayashi]

小林 (koichik) です．

Date:    Tue, 20 Feb 2007 23:09:53 +0900
From:    Seto Azusa <azusa ＠ fieldnotes.jp>
To:      seasar-javadoc ＠ ml.seasar.org
Subject: [seasar-javadoc:813]  S2ContainerBuilder

> 遅れに遅れましたがS2ContainerBuilderのJavaDocです。

ありがとうございます．
以下，コメントです．

■クラスコメント

>  * <p>
>  * {@link org.seasar.framework.container.S2Container S2コンテナ}の構造を組み立てるビルダクラスです。
>  * </p>

最初の文は <p>〜</p> なしでお願いします．
# JDK のソースがそうなってるので．

んで，「S2コンテナの構造を組み立てる」の「構造」が微妙．
「S2コンテナを組み立てる」でいいような．
その後の「ビルダクラスです」は「ビルダのインターフェースです」
みたいな．

>  * S2コンテナの構造は、設定ファイルによって記述されますが、 設定ファイルの構造は、このインターフェイスではなく実装クラスによって規定されます。

ごめんなさい，ちょっと言わんとしてることが分からない．．．
「設定ファイルの構造は〜実装クラスによって規定されます」
ってところが特に．
「設定ファイルの解釈は実装クラスによって行われます」
のような意味合い？


メソッドのコメントについては「S2コンテナの構造」を除いて
いい感じ．


-- 
<component name="koichik">
    <property name="fullName">"Koichi Kobayashi"</property>
    <property name="email">"koichik ＠ improvement.jp"</property>
    <property name="blog">"http://d.hatena.ne.jp/koichik"</property>
</component>