Javadocコメントの最初の一文
marsのメモのコメントより。
Javadocコメントの最初の一文（ピリオドもしくは
読句点まで）がメソッド一覧に出るって知っててコメント書いてる人，どんだけいるんだろう？
読点（、）じゃなくて句点（。）ですね。ま、それはいいんですが、ずーっと、日本語環境ではピリオドには反応しないものだと思ってました。公式のドキュメントには、
最初の文 - 各 doc コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全な要約文である必要があります。この文は、後に空白、タブ、または行末記号が続く最初のピリオドに遭遇した時点、あるいは最初のタグに遭遇した時点で終了します。最初の文は、Javadoc によって HTML ページ上部のメンバの概要の部分にコピーされます。
って書いてあるのは知ってたものの、マイマシンのEclipseでJavadocのエクスポートすると、ピリオドがあっても無視されて初めの句点まで表示されてしまってたのです。JDK変えてもずっとそうだったので、そういう仕様なのだとばかり思っていました。
でもid:marsさんのコメントみて、やっぱそうなの？ひょっとしてEclipseのバグ？？と思い調べてみた。
EclipseでJavadocエクスポートさせて、その起動時のプロパティをデバッグビューで確認すると、
C:\jdk1.3.1_06\bin\javadoc.exe 〜
古っ！ライブラリにはJDK1.4.2を指定してるのに。
いろいろ設定を覗いた結果、「設定」→「Java」→「Javadoc」でjavadoc.exeのパスを指定するようになっているのを発見。これを直してもう一回生成すると、正しいJavadocが生成されました。JDK1.3.1_06のバグだった模様。よかったよかった。
しかし、なんでJavadocだけ独自の設定にするかなぁ＞Eclipse。インストール済みJREで設定しているVMがJDKのものだったらjavadocも連動して変えるとかしてほしい。
ずぅ〜っと勘違いしたまま過ごすところでした。きっかけをくれたid:marsさんに（勝手に）感謝。
はてなダイアリーモード
前書いたはてなダイアリーモードですが、NetInstallerでインストールするそうだ。名前は聞いたことあったけど実際に使ったこと無かったので、全然分からなかった(；・∀・)
んで、インストールしてみたが動かん……。なぜ。
