>だが内部的なクラスに関してはその限りではない
>内部的なクラスのインターフェースなんて実装方法そのものだからな
>仕様が変わらなくても実装方法が変われば内部的なクラスの
>インターフェースなんてどうにでも変わる
だから、インターフェイスが変わるのはリファクタリングの範疇だし、
それはJavadocも自動的に変わるだろ。リファクタリングも十分できるぞ。
仕様が変わらないのにJavadocの仕様説明が変わるのか？

まぁ、どのスコープまでJavadocを書くとか、
そういう前提がないのに議論しててもあまり意味がないな。
俺が言っている前提は、private以外は書く。
privateは公開されるものではないので、そこがどう変わろうと関係ない。
その他は外部に公開されるので、メンバがどのように振舞うかは明記すべき。

>Seasarのクラスなんてほっとんどpublishedじゃないだろ
べつにSeasarの話じゃなくてJavadocとリファクタリングの話をしているわけだが。

まぁ、そもそもSeasarには、どれがpublishedか明記されているか？
publishedかどうか明記するまえにJavadocをまともに書いていないだけなんだろうけど。

まぁ、コミッタ乙！