Javadocの挙動を変更する、その1
この問題は今現在調査中である。
javadocの挙動を変更したい。今現在困っているのは、「アノテーションに日本語文字列を指定すると、Javadocにはそれがユニコードエスケープシーケンスとして現れてしまい、読むことができない」ことである。
調べてみると、かなり以前からこの挙動のようだ。
以下のいずれかにして欲しいものなのだが、どうにもならないようだ。
- アノテーションを出すならちゃんと日本語として出してほしい。
- アノテーション出さないようにするオプションを追加して欲しい。
いずれも望みは薄いように思われる。
独自のDocletを作る
標準のDocletを使っているからこうなってしまうのかもしれないが、では、独自のDocletを作るにはどうすれば良いのだろうか?
Java7時点では以下のようなドキュメントがあった。
しかし現在はDeprecatedになっている。Java9以上では、以下のあたりがドキュメントらしい。
続く