[seasar-javadoc:823] Re: S2ContainerBuilder

[Koichi Kobayashi]

小林 (koichik) です．

Date:    Fri, 2 Mar 2007 21:13:37 +0900
From:    Seto Azusa <azusa ＠ fieldnotes.jp>
To:      seasar-javadoc ＠ ml.seasar.org
Subject: [seasar-javadoc:822] Re: S2ContainerBuilder

> すみません、一箇所修正漏れがありました。
> (ビルダクラス→ビルダインターフェース)
> よろしくお願いします。

どうもでーす．
以下，コメントです．
細かい点ばかりですが．

■クラスコメント

>  * 特定の形式の定義情報から{@link org.seasar.framework.container.S2Container S2コンテナ}を組み立てるビルダインターフェースです。

『ビルダ「の」インターフェース』がいいかも．

■build(String path)
■build(String path, ClassLoader classLoader)

>      * 指定された設定ファイルからS2コンテナを組み立てます。

と

>      * 指定された設定ファイルに基づき、指定されたクラスローダを使用してS2コンテナを組み立てます。

の言い回しが微妙に違っているのがちょっと気になるので，
後者を

     * 指定された設定ファイルから指定されたクラスローダを使用してS2コンテナを組み立てます。

にした方がいいかなぁとか．
include() も前者の表現なので．

■include(S2Container parent, String path)

>      * @see S2Container#include(S2Container)

こういう場合，S2Container は FQN で書かないと
できあがった Javadoc がちゃんとリンクにならなかったような
気がするのですが，大丈夫でしょうか？
一応 mvn javadoc:javadoc して確認願います．


-- 
<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>