GP-523 - Fix javadoc errors

Ghidra/Framework/Generic/src/main/java/generic/concurrent/ConcurrentQ.java

@@ -114,8 +114,8 @@ import ghidra.util.task.TaskMonitor;
  *     }
  * };
  *
- * QItemListener<ITEM, RESULT> itemListener = new QItemListener<ITEM, RESULT>() {
+ * {@literal QItemListener<ITEM, RESULT> itemListener = new QItemListener<ITEM, RESULT>()} {
- *     public void itemProcessed(QResult<ITEM, RESULT> result) {
+ *     {@literal public void itemProcessed(QResult<ITEM, RESULT> result)} {
  *         RESULT result = result.getResult();
  *             // work on my result...
  *         }

Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/pcode/floatformat/BigFloat.java

@@ -15,7 +15,8 @@
  */
 package ghidra.pcode.floatformat;
 
-import java.math.*;
+import java.math.BigDecimal;
+import java.math.BigInteger;
 
 /**
  * An IEEE 754 floating point class.
@@ -94,12 +95,15 @@ public strictfp class BigFloat implements Comparable<BigFloat> {
 
 	@Override
 	public boolean equals(Object obj) {
-		if (this == obj)
+		if (this == obj) {
 			return true;
-		if (obj == null)
+		}
+		if (obj == null) {
 			return false;
-		if (getClass() != obj.getClass())
+		}
+		if (getClass() != obj.getClass()) {
 			return false;
+		}
 		BigFloat other = (BigFloat) obj;
 		if (expbits != other.expbits) {
 			return false;
@@ -225,11 +229,12 @@ public strictfp class BigFloat implements Comparable<BigFloat> {
 	 * This function is used internally to round after a computation.
 	 * 
 	 * <p>Assume that the true value is
-	 *    <code>sign * (unscaled + eps) * 2 ^ (scale-fracbits)</code>
+	 * <pre>   sign * (unscaled + eps) * 2 ^ (scale-fracbits)
 	 * and
-	 *    <code>unscaled.bitLength() > fracbits+1</code>
+	 *   unscaled.bitLength() &gt; fracbits+1 
-	 *     (or the value is subnormal with at least 1 bit of extra precision)
+	 *
-	 *  
+	 * (or the value is subnormal with at least 1 bit of extra precision)
+	 * </pre> 
 	 * @param eps &lt; 1
 	 */
 	protected void internalRound(boolean eps) {
@@ -320,8 +325,9 @@ public strictfp class BigFloat implements Comparable<BigFloat> {
 			case SIGNALING_NAN:
 				return "sNaN";
 			case INFINITE:
-				if (sign < 0)
+				if (sign < 0) {
 					return "-inf";
+				}
 				return "+inf";
 			case FINITE:
 				String s = (sign < 0) ? "-" : "";

Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/pcode/floatformat/FloatFormat.java

@@ -220,7 +220,9 @@ public strictfp class FloatFormat {
 	// set sign bit and return the result if size <= 8
 	private long setSign(long x, boolean sign) {
 		if (!sign)
+		 {
 			return x; // Assume bit is already zero
+		}
 		long mask = 1;
 		mask <<= signbit_pos;
 		x |= mask; // Stick in the bit
@@ -299,7 +301,7 @@ public strictfp class FloatFormat {
 	/**
 	 * Decode {@code encoding} to a BigFloat using this format.
 	 * 
-	 * NB: this method should not be used if {@link #size}>8
+	 * NB: this method should not be used if {@link #size}&gt;8
 	 * 
 	 * @param encoding the encoding
 	 * @return the decoded value as a BigFloat
@@ -535,7 +537,7 @@ public strictfp class FloatFormat {
 	/**
 	 * Convert an encoded value to a binary floating point representation.
 	 * 
-	 * NB: this method should not be used if {@link #size}>8
+	 * NB: this method should not be used if {@link #size}&gt;8
 	 * 
 	 * @param encoding the encoding of a floating point value in this format
 	 * @return a binary string representation of the encoded floating point {@code encoding}
@@ -548,8 +550,9 @@ public strictfp class FloatFormat {
 
 		switch (kind) {
 			case INFINITE:
-				if (sgn)
+				if (sgn) {
 					return "-inf";
+				}
 				return "+inf";
 			case QUIET_NAN:
 				return "qNaN";

Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/model/address/AddressSetView.java

@@ -242,7 +242,7 @@ public interface AddressSetView extends Iterable<AddressRange> {
 
 	/**
 	 * Trim address set removing all addresses less-than-or-equal to specified 
-	 * address based upon {@link Address#compareTo(Address)} behavior.  
+	 * address based upon {@link Address} comparison.
 	 * The address set may contain address ranges from multiple 
 	 * address spaces.
 	 * @param set address set to be trimmed
@@ -269,7 +269,7 @@ public interface AddressSetView extends Iterable<AddressRange> {
 
 	/**
 	 * Trim address set removing all addresses greater-than-or-equal to specified 
-	 * address based upon {@link Address#compareTo(Address)} behavior.  
+	 * address based upon {@link Address} comparison.  
 	 * The address set may contain address ranges from multiple 
 	 * address spaces.
 	 * @param set address set to be trimmed

gradle/root/distribution.gradle

@@ -125,6 +125,8 @@ task createJavadocs(type: Javadoc, description: 'Generate javadocs for all proje
 	// generate documentation using html5
 	options.addBooleanOption("html5", true)
 
+	options.addBooleanOption('Xdoclint:none', true)
+	
 	// Some internal packages are not public and need to be exported.
     options.addMultilineStringsOption("-add-exports").setValue(["java.desktop/sun.awt.image=ALL-UNNAMED", 
     															"java.desktop/sun.awt=ALL-UNNAMED", 
@@ -132,7 +134,8 @@ task createJavadocs(type: Javadoc, description: 'Generate javadocs for all proje
     															"java.base/sun.security.provider=ALL-UNNAMED", 
     															"java.base/sun.security.util=ALL-UNNAMED"])
 }
-  
+
+
  /*********************************************************************************
  * JSONDOCS - RAW
  *
@@ -179,6 +182,7 @@ task createJsondocs(type: Javadoc, description: 'Generate JSON docs for all proj
 	// Newer versions of gradle set this to true by default.
 	// The JsonDoclet doesn't have the -notimestamp option so ensure it isn't set.
 	options.setNoTimestamp(false)
+	
 		
 	// Some internal packages are not public and need to be exported. 
     options.addMultilineStringsOption("-add-exports").setValue(["java.desktop/sun.awt.image=ALL-UNNAMED",