Olá,
tive um problema meio bizarro fazendo @links dentro dos meus Javadocs. Aparentemente, o @link não tenta bater os tipos dos argumentos, e sim só o número deles.
Ex.: tenho 2 métodos, teste(int) e teste(boolean), se eu colocar {@link Classe#teste(boolean)} o Javadoc redireciona para a documentação do Classe#teste(int), porque este está declarado antes do Classe#teste(boolean).
Alguém sabe como funciona o parsing do Javadoc para uma possível explicação desse fato? Tentei mudar a ordem deles, e aí a linkagem funcionou perfeito.