[Libguestfs] [PATCH] generator: java: Don't link to undocumented methods.

[Richard W.M. Jones]

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