commit 029a9ddf01584f00fe97ced9260aa4cd7dee3cff
author Matthias Sohn <matthias.sohn@sap.com> Sat Oct 10 23:38:48 2020 +0200
committer Matthias Sohn <matthias.sohn@sap.com> Sun Oct 11 09:25:47 2020 +0200
tree 93e473c636f08bcb3f56d106d5ecfbdf56101768
parent aed17b3d86227c64baba7d3346762a34f3b82c2c

Fix warning "Javadoc: Malformed reference (missing end space separator)"

Javadoc doesn't support generic parameters in @link tags and renders
{@link List<ContextLineInfo>} as 'Link' without adding a link.
Work around this by removing the generic type parameter and setting an
explicit label including the generic type parameter. This shows the
desired text and renders a link to the List class.

See https://bugs.java.com/bugdatabase/view_bug.do?bug_id=6422214

Change-Id: I34aa7b4dec034a3954b328a4e5922e4cb5ddffec

java/com/google/gerrit/server/CommentContextLoader.java

diff --git a/java/com/google/gerrit/server/CommentContextLoader.java b/java/com/google/gerrit/server/CommentContextLoader.java
index 7f84693..bbc7cf3 100644
--- a/java/com/google/gerrit/server/CommentContextLoader.java
+++ b/java/com/google/gerrit/server/CommentContextLoader.java
@@ -63,7 +63,8 @@
 
   /**
    * Returns an empty list of {@link ContextLineInfo}. Clients are expected to call this method one
-   * or more times. Each call returns a reference to an empty {@link List<ContextLineInfo>}.
+   * or more times. Each call returns a reference to an empty {@link List
+   * List&lt;ContextLineInfo&gt;}.
    *
    * <p>A single call to {@link #fill()} will cause all list references returned from this method to
    * be populated. If a client calls this method again with a comment that was passed before calling