Javadocの構文は言語使用には組み込まれておらず、Javadocツールの挙動にあわせて書かなきゃなりません。
でも、そのツールの挙動もどこに明文化されているかわからず、今のところ手探りで挙動をそろえてます。
{@link List<String>}型の値を返す。
なんてのは実は正しく解析できず、@linkや@seeの中身はイレイジャを使わなきゃなりません。
{@link List}型の値を返す。
これ、いつまでこの仕様なのかわからんので、ちゃんとパラメータ化型の解釈とかもできるほうがいいんですかね。
Irenkaだとやってるんですが。