Рассмотрим статический метод в классе, который я задокументировал с помощьюJavadoc:

/**
 * Description here.
 *
 * @param names       - The parameters of the impression request.
 * @param ids         - An intent object to enrich.
 * @param prefix - A prefix.
 */

public static void parse(Map<String, String> names, String ids, String prefix)
    ...

Чтобы избежать дублирования описания в перегруженных версиях метода, я бы хотел использовать javadoc@link:

 /**
 * Overloaded version with default prefix.
 * {@link #<parse(Map<String, String>, String, String)> [Text]}
 */

public static void parse(Map<String, String> names, String ids, String prefix)

Что дает следующее предупреждение:

@link:illegal character: "60" in "#parseBtCategories(Map<String, String>, 
                                                     String, String) Text"

ASCII 60 является<, который является частью сигнатуры метода. Работает сMap, String, String) Орех это обозначение не может различить два разных типа карт.

Это похоже на известную ошибку. Есть ли хороший обходной путь?