commit bab8a616f0de6013af5e1ac573484cad5bdaf45a
author Joerg Zieren <zieren@google.com> Mon Jul 08 15:29:11 2019 +0000
committer Gerrit Code Review <noreply-gerritcodereview@google.com> Mon Jul 08 15:29:11 2019 +0000
tree 4a7f5502ccefb30403814cb21e657c97a6b9f7f6
parent 7a37b443c8b728ef9e148eaad8682cdb33460507
parent ffeec8fb843ee63887eaad5a4d0019db989e36bb

Merge "Add javadoc for special value 0 of comment line number"

java/com/google/gerrit/extensions/client/Comment.java

diff --git a/java/com/google/gerrit/extensions/client/Comment.java b/java/com/google/gerrit/extensions/client/Comment.java
index 3bca4bb..d5fbf89 100644
--- a/java/com/google/gerrit/extensions/client/Comment.java
+++ b/java/com/google/gerrit/extensions/client/Comment.java
@@ -30,7 +30,9 @@
   public String path;
   public Side side;
   public Integer parent;
-  public Integer line; // value 0 or null indicates a file comment, normal lines start at 1
+  /** Value 0 or null indicates a file comment, normal lines start at 1. */
+  public Integer line;
+
   public Range range;
   public String inReplyTo;
   public Timestamp updated;

java/com/google/gerrit/reviewdb/client/Comment.java

diff --git a/java/com/google/gerrit/reviewdb/client/Comment.java b/java/com/google/gerrit/reviewdb/client/Comment.java
index d1f97fb..94e7583 100644
--- a/java/com/google/gerrit/reviewdb/client/Comment.java
+++ b/java/com/google/gerrit/reviewdb/client/Comment.java
@@ -185,7 +185,9 @@
   }
 
   public Key key;
+  /** The line number (1-based) to which the comment refers, or 0 for a file comment. */
   public int lineNbr;
+
   public Identity author;
   protected Identity realAuthor;
   public Timestamp writtenOn;