Considere un método estático en una clase, que lo he documentado usando 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)
    ...

Para evitar duplicar la descripción en las versiones sobrecargadas del método, me gustaría usar un 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)

Que da la siguiente advertencia:

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

ASCII 60 es<, que es parte de la firma del método. Funciona conMap, String, String) nut esta notación no puede distinguir dos tipos diferentes de mapas.

Esto parece ser un error conocido. ¿Hay una buena solución?