From 9e8343c1350d8cfd1e1b46ff327d55958fd2eafa Mon Sep 17 00:00:00 2001
From: Christian Aistleitner <christian@quelltextlich.at>
Date: Wed, 20 May 2015 15:04:42 +0200
Subject: [PATCH] Fix @see to external class in api to allow compilation with
 Java 8
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The recently added GarbageCollectorListener came with a @see to a JGit
class. While Java 7 did not error out on that, Java 8 does:

  [...]/events/GarbageCollectorListener.java:34: error: reference not found
     * @see org.eclipse.jgit.api.GarbageCollectCommand#call()
            ^

As Java 8's javadoc currently (1.8.0_45) even complains when adding a
“-link”, we work around the issue by transforming the @see to the
classname into a @see with a full <a/>.

Change-Id: I1c061d5219b4fe8818d3fca8a56b4a433aa557d4
---
 .../gerrit/extensions/events/GarbageCollectorListener.java      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gerrit-extension-api/src/main/java/com/google/gerrit/extensions/events/GarbageCollectorListener.java b/gerrit-extension-api/src/main/java/com/google/gerrit/extensions/events/GarbageCollectorListener.java
index 557fcd861c..eb223c6ecd 100644
--- a/gerrit-extension-api/src/main/java/com/google/gerrit/extensions/events/GarbageCollectorListener.java
+++ b/gerrit-extension-api/src/main/java/com/google/gerrit/extensions/events/GarbageCollectorListener.java
@@ -31,7 +31,7 @@ public interface GarbageCollectorListener {
      * Properties describing the result of the garbage collection performed by
      * JGit
      *
-     * @see org.eclipse.jgit.api.GarbageCollectCommand#call()
+     * @see <a href="http://download.eclipse.org/jgit/site/3.7.0.201502260915-r/apidocs/org/eclipse/jgit/api/GarbageCollectCommand.html#call%28%29">GarbageCollectCommand</a>
      */
     Properties getStatistics();
   }