Cleanup javadocs so they pass the java8 doclint checks

Bug: 431552
Change-Id: I469316f5645205016e1fa6b0fbd2ff3b509b14bc
Signed-off-by: Robin Stocker <robin@nibor.org>

org.eclipse.jgit.http.server/src/org/eclipse/jgit/http/server/ClientVersionUtil.java

@@ -131,7 +131,7 @@ private static int[] grow(int[] tmp) {
 	 *            first parsed version string.
 	 * @param b
 	 *            second parsed version string.
-	 * @return <0 if a is before b; 0 if a equals b; >0 if a is after b.
+	 * @return &lt; 0 if a is before b; 0 if a equals b; &gt;0 if a is after b.
 	 */
 	public static int compare(int[] a, int[] b) {
 		for (int i = 0; i < a.length && i < b.length; i++) {

org.eclipse.jgit.ui/src/org/eclipse/jgit/awtui/CommitGraphPane.java

@@ -74,7 +74,7 @@
  * <li>Commit graph and short message</li>
  * <li>Author name and email address</li>
  * <li>Author date and time</li>
- * </ul>
+ * </ol>
  */
 public class CommitGraphPane extends JTable {
 	private static final long serialVersionUID = 1L;

org.eclipse.jgit/src/org/eclipse/jgit/api/DescribeCommand.java

@@ -142,7 +142,7 @@ public DescribeCommand setTarget(String rev) throws IOException,
 	 * @return if there's a tag that points to the commit being described, this
 	 *         tag name is returned. Otherwise additional suffix is added to the
 	 *         nearest tag, just like git-describe(1).
-	 *         <p/>
+	 *         <p>
 	 *         If none of the ancestors of the commit being described has any
 	 *         tags at all, then this method returns null, indicating that
 	 *         there's no way to describe this tag.

org.eclipse.jgit/src/org/eclipse/jgit/api/MergeCommand.java

@@ -107,7 +107,7 @@ public class MergeCommand extends GitCommand<MergeResult> {
 	/**
 	 * The modes available for fast forward merges corresponding to the
 	 * <code>--ff</code>, <code>--no-ff</code> and <code>--ff-only</code>
-	 * options under <code>branch.<name>.mergeoptions</code>.
+	 * options under <code>branch.&lt;name&gt;.mergeoptions</code>.
 	 */
 	public enum FastForwardMode implements ConfigEnum {
 		/**
@@ -162,7 +162,7 @@ public enum Merge {
 			 *
 			 * @param ffMode
 			 *            the <code>FastForwardMode</code> value to be mapped
-			 * @return the mapped code>FastForwardMode.Merge</code> value
+			 * @return the mapped <code>FastForwardMode.Merge</code> value
 			 */
 			public static Merge valueOf(FastForwardMode ffMode) {
 				switch (ffMode) {
@@ -182,7 +182,7 @@ public static Merge valueOf(FastForwardMode ffMode) {
 		 *
 		 * @param ffMode
 		 *            the <code>FastForwardMode.Merge</code> value to be mapped
-		 * @return the mapped code>FastForwardMode</code> value
+		 * @return the mapped <code>FastForwardMode</code> value
 		 */
 		public static FastForwardMode valueOf(FastForwardMode.Merge ffMode) {
 			switch (ffMode) {

org.eclipse.jgit/src/org/eclipse/jgit/api/MergeResult.java

@@ -464,32 +464,36 @@ public void addConflict(String path, org.eclipse.jgit.merge.MergeResult<?> lowLe
 	 * file to a two-dimensional int-array of line-numbers telling where in the
 	 * file conflict markers for which merged commit can be found.
 	 * <p>
-	 * If the returned value contains a mapping "path"->[x][y]=z then this means
+	 * If the returned value contains a mapping "path"-&gt;[x][y]=z then this
+	 * means
 	 * <ul>
 	 * <li>the file with path "path" contains conflicts</li>
-	 * <li>if y < "number of merged commits": for conflict number x in this file
+	 * <li>if y &lt; "number of merged commits": for conflict number x in this
-	 * the chunk which was copied from commit number y starts on line number z.
+	 * file the chunk which was copied from commit number y starts on line
-	 * All numberings and line numbers start with 0.</li>
+	 * number z. All numberings and line numbers start with 0.</li>
 	 * <li>if y == "number of merged commits": the first non-conflicting line
 	 * after conflict number x starts at line number z</li>
 	 * </ul>
 	 * <p>
 	 * Example code how to parse this data:
-	 * <pre> MergeResult m=...;
+	 *
-	 * Map<String, int[][]> allConflicts = m.getConflicts();
+	 * <pre>
+	 * MergeResult m=...;
+	 * Map&lt;String, int[][]&gt; allConflicts = m.getConflicts();
 	 * for (String path : allConflicts.keySet()) {
 	 * 	int[][] c = allConflicts.get(path);
 	 * 	System.out.println("Conflicts in file " + path);
 	 * 	for (int i = 0; i < c.length; ++i) {
 	 * 		System.out.println("  Conflict #" + i);
-	 * 		for (int j = 0; j < (c[i].length) - 1; ++j) {
+	 * 		for (int j = 0; j &lt;	 (c[i].length) - 1; ++j) {
 	 * 			if (c[i][j] >= 0)
 	 * 				System.out.println("    Chunk for "
 	 * 						+ m.getMergedCommits()[j] + " starts on line #"
 	 * 						+ c[i][j]);
 	 * 		}
 	 * 	}
-	 * }</pre>
+	 * }
+	 * </pre>
 	 *
 	 * @return the conflicts or <code>null</code> if no conflict occurred
 	 */

org.eclipse.jgit/src/org/eclipse/jgit/api/PullCommand.java

@@ -111,16 +111,18 @@ public PullCommand setProgressMonitor(ProgressMonitor monitor) {
 
 	/**
 	 * Set if rebase should be used after fetching. If set to true, rebase is
-	 * used instead of merge. This is equivalent to --rebase on the command line.
+	 * used instead of merge. This is equivalent to --rebase on the command
-	 * <p/>
+	 * line.
-	 * If set to false, merge is used after fetching, overriding the configuration
+	 * <p>
-	 * file. This is equivalent to --no-rebase on the command line.
+	 * If set to false, merge is used after fetching, overriding the
-	 * <p/>
+	 * configuration file. This is equivalent to --no-rebase on the command
-	 * This setting overrides the settings in the configuration file.
+	 * line.
-	 * By default, the setting in the repository configuration file is used.
+	 * <p>
-	 * <p/>
+	 * This setting overrides the settings in the configuration file. By
-	 * A branch can be configured to use rebase by default.
+	 * default, the setting in the repository configuration file is used.
-	 * See branch.[name].rebase and branch.autosetuprebase.
+	 * <p>
+	 * A branch can be configured to use rebase by default. See
+	 * branch.[name].rebase and branch.autosetuprebase.
 	 *
 	 * @param useRebase
 	 * @return {@code this}

org.eclipse.jgit/src/org/eclipse/jgit/diff/DiffEntry.java

@@ -372,7 +372,7 @@ public String getOldPath() {
 	 * <li><i>file modify</i>: always {@link #getOldPath()}</li>
 	 * <li><i>file delete</i>: always <code>/dev/null</code></li>
 	 * <li><i>file copy</i>: destination file the copy ends up at</li>
-	 * <li><i>file rename</i>: destination file the rename ends up at/li>
+	 * <li><i>file rename</i>: destination file the rename ends up at</li>
 	 * </ul>
 	 *
 	 * @return new name for this file.
@@ -453,7 +453,7 @@ public AbbreviatedObjectId getNewId() {
 	 * <pre>
 	 * TreeFilter filterA = ...;
 	 * TreeFilter filterB = ...;
-	 * List<DiffEntry> entries = DiffEntry.scan(walk, false, filterA, filterB);
+	 * List&lt;DiffEntry&gt; entries = DiffEntry.scan(walk, false, filterA, filterB);
 	 * DiffEntry entry = entries.get(0);
 	 * boolean filterAMatched = entry.isMarked(0);
 	 * boolean filterBMatched = entry.isMarked(1);

org.eclipse.jgit/src/org/eclipse/jgit/diff/Edit.java

@@ -51,16 +51,16 @@
  * Regions should be specified using 0 based notation, so add 1 to the start and
  * end marks for line numbers in a file.
  * <p>
- * An edit where <code>beginA == endA && beginB < endB</code> is an insert edit,
+ * An edit where <code>beginA == endA && beginB &lt; endB</code> is an insert
- * that is sequence B inserted the elements in region
+ * edit, that is sequence B inserted the elements in region
  * <code>[beginB, endB)</code> at <code>beginA</code>.
  * <p>
- * An edit where <code>beginA < endA && beginB == endB</code> is a delete edit,
+ * An edit where <code>beginA &lt; endA && beginB == endB</code> is a delete
- * that is sequence B has removed the elements between
+ * edit, that is sequence B has removed the elements between
  * <code>[beginA, endA)</code>.
  * <p>
- * An edit where <code>beginA < endA && beginB < endB</code> is a replace edit,
+ * An edit where <code>beginA &lt; endA && beginB &lt; endB</code> is a replace
- * that is sequence B has replaced the range of elements between
+ * edit, that is sequence B has replaced the range of elements between
  * <code>[beginA, endA)</code> with those found in <code>[beginB, endB)</code>.
  */
 public class Edit {
@@ -105,11 +105,11 @@ public Edit(final int as, final int bs) {
 	 * @param as
 	 *            beginA: start of region in sequence A; 0 based.
 	 * @param ae
-	 *            endA: end of region in sequence A; must be >= as.
+	 *            endA: end of region in sequence A; must be &gt;= as.
 	 * @param bs
 	 *            beginB: start of region in sequence B; 0 based.
 	 * @param be
-	 *            endB: end of region in sequence B; must be >= bs.
+	 *            endB: end of region in sequence B; must be &gt; = bs.
 	 */
 	public Edit(final int as, final int ae, final int bs, final int be) {
 		beginA = as;

org.eclipse.jgit/src/org/eclipse/jgit/diff/MyersDiff.java

@@ -167,11 +167,21 @@ private void calculateEdits(Edit r) {
 	}
 
 	/**
-	 * Calculates the differences between a given part of A against another given part of B
+	 * Calculates the differences between a given part of A against another
-	 * @param beginA start of the part of A which should be compared (0<=beginA<sizeof(A))
+	 * given part of B
-	 * @param endA end of the part of A which should be compared (beginA<=endA<sizeof(A))
+	 *
-	 * @param beginB start of the part of B which should be compared (0<=beginB<sizeof(B))
+	 * @param beginA
-	 * @param endB end of the part of B which should be compared (beginB<=endB<sizeof(B))
+	 *            start of the part of A which should be compared
+	 *            (0&lt;=beginA&lt;sizeof(A))
+	 * @param endA
+	 *            end of the part of A which should be compared
+	 *            (beginA&lt;=endA&lt;sizeof(A))
+	 * @param beginB
+	 *            start of the part of B which should be compared
+	 *            (0&lt;=beginB&lt;sizeof(B))
+	 * @param endB
+	 *            end of the part of B which should be compared
+	 *            (beginB&lt;=endB&lt;sizeof(B))
 	 */
 	protected void calculateEdits(int beginA, int endA,
 			int beginB, int endB) {

org.eclipse.jgit/src/org/eclipse/jgit/dircache/DirCache.java

@@ -730,14 +730,14 @@ public void unlock() {
 	}
 
 	/**
-	 * Locate the position a path's entry is at in the index.
+	 * Locate the position a path's entry is at in the index. For details refer
-	 * For details refer to #findEntry(byte[], int).
+	 * to #findEntry(byte[], int).
 	 *
 	 * @param path
 	 *            the path to search for.
-	 * @return if >= 0 then the return value is the position of the entry in the
+	 * @return if >= 0 then the return value is the position of the entry in
-	 *         index; pass to {@link #getEntry(int)} to obtain the entry
+	 *         the index; pass to {@link #getEntry(int)} to obtain the entry
-	 *         information. If < 0 the entry does not exist in the index.
+	 *         information. If &lt; 0 the entry does not exist in the index.
 	 */
 	public int findEntry(final String path) {
 		final byte[] p = Constants.encode(path);
@@ -758,9 +758,9 @@ public int findEntry(final String path) {
 	 *            the byte array starting with the path to search for.
 	 * @param pLen
 	 *            the length of the path in bytes
-	 * @return if >= 0 then the return value is the position of the entry in the
+	 * @return if &gt;= 0 then the return value is the position of the entry in
-	 *         index; pass to {@link #getEntry(int)} to obtain the entry
+	 *         the index; pass to {@link #getEntry(int)} to obtain the entry
-	 *         information. If < 0 the entry does not exist in the index.
+	 *         information. If &lt; 0 the entry does not exist in the index.
 	 * @since 3.4
 	 */
 	public int findEntry(final byte[] p, final int pLen) {
@@ -917,7 +917,7 @@ public DirCacheTree getCacheTree(final boolean build) {
 	 *            returned tree identity.
 	 * @return identity for the root tree.
 	 * @throws UnmergedPathException
-	 *             one or more paths contain higher-order stages (stage > 0),
+	 *             one or more paths contain higher-order stages (stage &gt; 0),
 	 *             which cannot be stored in a tree object.
 	 * @throws IllegalStateException
 	 *             one or more paths contain an invalid mode which should never

org.eclipse.jgit/src/org/eclipse/jgit/dircache/DirCacheEntry.java

@@ -548,7 +548,7 @@ public void setLastModified(final long when) {
 	 * <p>
 	 * Note that this is the length of the file in the working directory, which
 	 * may differ from the size of the decompressed blob if work tree filters
-	 * are being used, such as LF<->CRLF conversion.
+	 * are being used, such as LF&lt;-&gt;CRLF conversion.
 	 * <p>
 	 * Note also that for very large files, this is the size of the on-disk file
 	 * truncated to 32 bits, i.e. modulo 4294967296. If that value is larger

org.eclipse.jgit/src/org/eclipse/jgit/fnmatch/FileNameMatcher.java

@@ -80,7 +80,6 @@
  * </ul>
  * e. g. [[:xdigit:]]</li>
  * </ul>
- * </p>
  * Any character can be escaped by prepending it with a \
  */
 public class FileNameMatcher {

org.eclipse.jgit/src/org/eclipse/jgit/internal/storage/pack/PackWriter.java

@@ -132,11 +132,13 @@
  * <li>by providing iterator of {@link RevObject} specifying exact list and
  * order of objects in pack</li>
  * </ul>
+ * <p>
  * Typical usage consists of creating instance intended for some pack,
  * configuring options, preparing the list of objects by calling
  * {@link #preparePack(Iterator)} or
  * {@link #preparePack(ProgressMonitor, Collection, Collection)}, and finally
- * producing the stream with {@link #writePack(ProgressMonitor, ProgressMonitor, OutputStream)}.
+ * producing the stream with
+ * {@link #writePack(ProgressMonitor, ProgressMonitor, OutputStream)}.
  * </p>
  * <p>
  * Class provide set of configurable options and {@link ProgressMonitor}

org.eclipse.jgit/src/org/eclipse/jgit/lib/AbbreviatedObjectId.java

@@ -325,7 +325,7 @@ public final int prefixCompare(final int[] bs, final int p) {
 		return NB.compareUInt32(w5, mask(5, bs[p + 4]));
 	}
 
-	/** @return value for a fan-out style map, only valid of length >= 2. */
+	/** @return value for a fan-out style map, only valid of length >= 2. */
 	public final int getFirstByte() {
 		return w1 >>> 24;
 	}

org.eclipse.jgit/src/org/eclipse/jgit/lib/AnyObjectId.java

@@ -156,8 +156,8 @@ public final int getByte(int index) {
 	 *
 	 * @param other
 	 *            the other id to compare to. Must not be null.
-	 * @return < 0 if this id comes before other; 0 if this id is equal to
+	 * @return &lt; 0 if this id comes before other; 0 if this id is equal to
-	 *         other; > 0 if this id comes after other.
+	 *         other; &gt; 0 if this id comes after other.
 	 */
 	public final int compareTo(final AnyObjectId other) {
 		if (this == other)

org.eclipse.jgit/src/org/eclipse/jgit/lib/CoreConfig.java

@@ -64,13 +64,13 @@ public CoreConfig parse(final Config cfg) {
 
 	/** Permissible values for {@code core.autocrlf}. */
 	public static enum AutoCRLF {
-		/** Automatic CRLF->LF conversion is disabled. */
+		/** Automatic CRLF->LF conversion is disabled. */
 		FALSE,
 
-		/** Automatic CRLF->LF conversion is enabled. */
+		/** Automatic CRLF->LF conversion is enabled. */
 		TRUE,
 
-		/** CRLF->LF performed, but no LF->CRLF. */
+		/** CRLF->LF performed, but no LF->CRLF. */
 		INPUT;
 	}
 

org.eclipse.jgit/src/org/eclipse/jgit/lib/RefComparator.java

@@ -84,7 +84,7 @@ public static Collection<Ref> sort(final Collection<Ref> refs) {
 	 *            the reference instance.
 	 * @param o2
 	 *            the name to compare to.
-	 * @return standard Comparator result of < 0, 0, > 0.
+	 * @return standard Comparator result of &lt; 0, 0, &gt; 0.
 	 */
 	public static int compareTo(Ref o1, String o2) {
 		return o1.getName().compareTo(o2);
@@ -97,7 +97,7 @@ public static int compareTo(Ref o1, String o2) {
 	 *            the reference instance.
 	 * @param o2
 	 *            the other reference instance.
-	 * @return standard Comparator result of < 0, 0, > 0.
+	 * @return standard Comparator result of &lt; 0, 0, &gt; 0.
 	 */
 	public static int compareTo(final Ref o1, final Ref o2) {
 		return o1.getName().compareTo(o2.getName());

org.eclipse.jgit/src/org/eclipse/jgit/lib/Tree.java

@@ -81,7 +81,7 @@ public class Tree extends TreeEntry {
 	 * @param lasta '/' if a is a tree, else NUL
 	 * @param lastb '/' if b is a tree, else NUL
 	 *
-	 * @return < 0 if a is sorted before b, 0 if they are the same, else b
+	 * @return &lt; 0 if a is sorted before b, 0 if they are the same, else b
 	 */
 	public static final int compareNames(final byte[] a, final byte[] b, final int lasta,final int lastb) {
 		return compareNames(a, b, 0, b.length, lasta, lastb);

org.eclipse.jgit/src/org/eclipse/jgit/lib/TreeFormatter.java

@@ -111,7 +111,7 @@ public TreeFormatter(int size) {
 	}
 
 	/**
-	 * Add a link to a submodule commit, mode is {@link #GITLINK}.
+	 * Add a link to a submodule commit, mode is {@link FileMode#GITLINK}.
 	 *
 	 * @param name
 	 *            name of the entry.
@@ -123,7 +123,7 @@ public void append(String name, RevCommit commit) {
 	}
 
 	/**
-	 * Add a subtree, mode is {@link #TREE}.
+	 * Add a subtree, mode is {@link FileMode#TREE}.
 	 *
 	 * @param name
 	 *            name of the entry.
@@ -135,7 +135,7 @@ public void append(String name, RevTree tree) {
 	}
 
 	/**
-	 * Add a regular file, mode is {@link #REGULAR_FILE}.
+	 * Add a regular file, mode is {@link FileMode#REGULAR_FILE}.
 	 *
 	 * @param name
 	 *            name of the entry.

org.eclipse.jgit/src/org/eclipse/jgit/merge/MergeFormatter.java

@@ -68,7 +68,7 @@ public class MergeFormatter {
 	 *            the merge result which should be presented
 	 * @param seqName
 	 *            When a conflict is reported each conflicting range will get a
-	 *            name. This name is following the "<<<<<<< " or ">>>>>>> "
+	 *            name. This name is following the "&lt;&lt;&lt;&lt;&lt;&lt;&lt; " or "&gt;&gt;&gt;&gt;&gt;&gt;&gt; "
 	 *            conflict markers. The names for the sequences are given in
 	 *            this list
 	 * @param charsetName

org.eclipse.jgit/src/org/eclipse/jgit/revwalk/FooterLine.java

@@ -124,7 +124,7 @@ public String getValue() {
 	 * Extract the email address (if present) from the footer.
 	 * <p>
 	 * If there is an email address looking string inside of angle brackets
-	 * (e.g. "<a@b>"), the return value is the part extracted from inside the
+	 * (e.g. "&lt;a@b&gt;"), the return value is the part extracted from inside the
 	 * brackets. If no brackets are found, then {@link #getValue()} is returned
 	 * if the value contains an '@' sign. Otherwise, null.
 	 *

org.eclipse.jgit/src/org/eclipse/jgit/revwalk/RevCommitList.java

@@ -344,7 +344,8 @@ public void fillTo(final int highMark) throws MissingObjectException,
 	 * walker specified by {@link #source(RevWalk)} is pumped until the
 	 * specified commit is loaded. Callers can test the final size of the list
 	 * by {@link #size()} to determine if the high water mark specified was met.
-	 * <p/>
+	 * <p>
+	 *
 	 * @param commitToLoad
 	 *            commit the caller wants this list to contain when the fill
 	 *            operation is complete.

org.eclipse.jgit/src/org/eclipse/jgit/storage/pack/PackConfig.java

@@ -599,7 +599,7 @@ public int getThreads() {
 	 * Default setting: 0 (auto-detect processors)
 	 *
 	 * @param threads
-	 *            number of threads to use. If <= 0 the number of available
+	 *            number of threads to use. If &lt;= 0 the number of available
 	 *            processors for this JVM is used.
 	 */
 	public void setThreads(int threads) {

org.eclipse.jgit/src/org/eclipse/jgit/transport/URIish.java

@@ -65,8 +65,8 @@
 /**
  * This URI like construct used for referencing Git archives over the net, as
  * well as locally stored archives. It is similar to RFC 2396 URI's, but also
- * support SCP and the malformed file://<path> syntax (as opposed to the correct
+ * support SCP and the malformed file://&lt;path&gt; syntax (as opposed to the correct
- * file:<path> syntax.
+ * file:&lt;path&gt; syntax.
  */
 public class URIish implements Serializable {
 	/**
@@ -660,7 +660,7 @@ public String toPrivateASCIIString() {
 	/**
 	 * Get the "humanish" part of the path. Some examples of a 'humanish' part
 	 * for a full path:
-	 * <table>
+	 * <table summary="path vs humanish path" border="1">
 	 * <tr>
 	 * <th>Path</th>
 	 * <th>Humanish part</th>

org.eclipse.jgit/src/org/eclipse/jgit/treewalk/CanonicalTreeParser.java

@@ -110,7 +110,7 @@ private CanonicalTreeParser(final CanonicalTreeParser p) {
 
 	/**
 	 * @return the parent of this tree parser
-	 * @internal
+	 * @deprecated internal use only
 	 */
 	public CanonicalTreeParser getParent() {
 		return (CanonicalTreeParser) parent;

org.eclipse.jgit/src/org/eclipse/jgit/treewalk/TreeWalk.java

@@ -777,7 +777,7 @@ public int getPathLength() {
 	 *            end with '/' prior to invocation.
 	 * @param pLen
 	 *            number of bytes from <code>buf</code> to test.
-	 * @return < 0 if p is before the current path; 0 if p matches the current
+	 * @return &lt; 0 if p is before the current path; 0 if p matches the current
 	 *         path; 1 if the current path is past p and p will never match
 	 *         again on this tree walk.
 	 */

org.eclipse.jgit/src/org/eclipse/jgit/util/FileUtils.java

@@ -193,7 +193,7 @@ public static void delete(final File f, int options) throws IOException {
 	 * the method fails. Furthermore if the destination exists and is a file
 	 * then the file will be deleted and then the rename is retried.
 	 * <p>
-	 * This operation is <em>not</me> atomic.
+	 * This operation is <em>not</em> atomic.
 	 *
 	 * @see FS#retryFailedLockFileCommit()
 	 * @param src

org.eclipse.jgit/src/org/eclipse/jgit/util/IO.java

@@ -317,7 +317,7 @@ public static int readFully(InputStream fd, byte[] dst, int off)
 	 * @param fd
 	 *            the stream to skip bytes from.
 	 * @param toSkip
-	 *            total number of bytes to be discarded. Must be >= 0.
+	 *            total number of bytes to be discarded. Must be >= 0.
 	 * @throws EOFException
 	 *             the stream ended before the requested number of bytes were
 	 *             skipped.

org.eclipse.jgit/src/org/eclipse/jgit/util/IntList.java

@@ -44,7 +44,7 @@
 
 package org.eclipse.jgit.util;
 
-/** A more efficient List<Integer> using a primitive integer array. */
+/** A more efficient List&lt;Integer&gt; using a primitive integer array. */
 public class IntList {
 	private int[] entries;
 

org.eclipse.jgit/src/org/eclipse/jgit/util/LongList.java

@@ -46,7 +46,7 @@
 
 import java.util.Arrays;
 
-/** A more efficient List<Long> using a primitive long array. */
+/** A more efficient List&lt;Long&gt; using a primitive long array. */
 public class LongList {
 	private long[] entries;
 

org.eclipse.jgit/src/org/eclipse/jgit/util/NB.java

@@ -56,7 +56,7 @@ public final class NB {
 	 *            the first value to compare.
 	 * @param b
 	 *            the second value to compare.
-	 * @return < 0 if a < b; 0 if a == b; > 0 if a > b.
+	 * @return &lt; 0 if a &lt; b; 0 if a == b; &gt; 0 if a &gt; b.
 	 */
 	public static int compareUInt32(final int a, final int b) {
 		final int cmp = (a >>> 1) - (b >>> 1);

org.eclipse.jgit/src/org/eclipse/jgit/util/RawParseUtils.java

@@ -982,7 +982,7 @@ public static String decodeNoFallback(final Charset cs,
 	 * Decode a region of the buffer under the ISO-8859-1 encoding.
 	 *
 	 * Each byte is treated as a single character in the 8859-1 character
-	 * encoding, performing a raw binary->char conversion.
+	 * encoding, performing a raw binary->char conversion.
 	 *
 	 * @param buffer
 	 *            buffer to pull raw bytes from.

org.eclipse.jgit/src/org/eclipse/jgit/util/io/InterruptTimer.java

@@ -113,7 +113,7 @@ public InterruptTimer(final String threadName) {
 	 *
 	 * @param timeout
 	 *            number of milliseconds before the interrupt should trigger.
-	 *            Must be > 0.
+	 *            Must be > 0.
 	 */
 	public void begin(final int timeout) {
 		if (timeout <= 0)

org.eclipse.jgit/src/org/eclipse/jgit/util/io/TimeoutInputStream.java

@@ -79,7 +79,7 @@ public int getTimeout() {
 
 	/**
 	 * @param millis
-	 *            number of milliseconds before aborting a read. Must be > 0.
+	 *            number of milliseconds before aborting a read. Must be > 0.
 	 */
 	public void setTimeout(final int millis) {
 		if (millis < 0)

org.eclipse.jgit/src/org/eclipse/jgit/util/io/TimeoutOutputStream.java

@@ -80,7 +80,7 @@ public int getTimeout() {
 
 	/**
 	 * @param millis
-	 *            number of milliseconds before aborting a write. Must be > 0.
+	 *            number of milliseconds before aborting a write. Must be > 0.
 	 */
 	public void setTimeout(final int millis) {
 		if (millis < 0)