[seasar-javadoc:823] Re: S2ContainerBuilder

Koichi Kobayashi koichik @ improvement.jp
2007年 3月 3日 (土) 06:30:21 JST


小林 (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>



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