We aren't generating Java bindings for internal and other undocumented methods, and therefore providing {@link #...} for deprecated methods replaced by internal methods doesn't work. The easiest way is just to check for this and turn such links into plain text. --- generator/java.ml | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/generator/java.ml b/generator/java.ml index 83f2e65..732cbe6 100644 --- a/generator/java.ml +++ b/generator/java.ml @@ -299,7 +299,15 @@ public class GuestFS { (match f with | { deprecated_by = Not_deprecated } -> () | { deprecated_by = Replaced_by alt } -> - pr " * @deprecated In new code, use {@link #%s} instead\n" alt + (* Don't link to an undocumented function as javadoc will + * give a hard error. + *) + let f_alt = try List.find (fun { name = n } -> n = alt) actions + with Not_found -> assert false in + if is_documented f_alt then + pr " * @deprecated In new code, use {@link #%s} instead\n" alt + else + pr " * @deprecated In new code, use method %s instead\n" alt | { deprecated_by = Deprecated_no_replacement } -> pr " * @deprecated\n" ); -- 2.9.3