Javadocの挙動を変更する、その1



この問題は今現在調査中である。

javadocの挙動を変更したい。今現在困っているのは、「アノテーションに日本語文字列を指定すると、Javadocにはそれがユニコードエスケープシーケンスとして現れてしまい、読むことができない」ことである。

調べてみると、かなり以前からこの挙動のようだ。

以下のいずれかにして欲しいものなのだが、どうにもならないようだ。

  • アノテーションを出すならちゃんと日本語として出してほしい。
  • アノテーション出さないようにするオプションを追加して欲しい。

いずれも望みは薄いように思われる。

独自のDocletを作る

標準のDocletを使っているからこうなってしまうのかもしれないが、では、独自のDocletを作るにはどうすれば良いのだろうか?

Java7時点では以下のようなドキュメントがあった。

しかし現在はDeprecatedになっている。Java9以上では、以下のあたりがドキュメントらしい。

続く