Fix some Javadoc warnings, mostly around the use of the default constructor.

RELNOTES=n/a
PiperOrigin-RevId: 698442998

Author: cpovirk

android/guava/src/com/google/common/cache/CacheBuilder.java

@@ -984,7 +984,6 @@ Ticker getTicker(boolean recordsTime) {
    *
    * @return the cache builder reference that should be used instead of {@code this} for any
    *     remaining configuration and cache building
-   * @return this {@code CacheBuilder} instance (for chaining)
    * @throws IllegalStateException if a removal listener was already set
    */
   public <K1 extends K, V1 extends V> CacheBuilder<K1, V1> removalListener(

android/guava/src/com/google/common/collect/ForwardingSetMultimap.java

@@ -39,6 +39,8 @@
 @ElementTypesAreNonnullByDefault
 public abstract class ForwardingSetMultimap<K extends @Nullable Object, V extends @Nullable Object>
     extends ForwardingMultimap<K, V> implements SetMultimap<K, V> {
+  /** Constructor for use by subclasses. */
+  public ForwardingSetMultimap() {}
 
   @Override
   protected abstract SetMultimap<K, V> delegate();

android/guava/src/com/google/common/collect/ImmutableClassToInstanceMap.java

@@ -94,6 +94,9 @@ public static <B> Builder<B> builder() {
    * @since 2.0
    */
   public static final class Builder<B> {
+    /** Creates a new builder. */
+    public Builder() {}
+
     private final ImmutableMap.Builder<Class<? extends B>, B> mapBuilder = ImmutableMap.builder();
 
     /**

android/guava/src/com/google/common/collect/TreeTraverser.java

@@ -77,6 +77,8 @@
 @GwtCompatible
 @ElementTypesAreNonnullByDefault
 public abstract class TreeTraverser<T> {
+  /** Constructor for use by subclasses. */
+  public TreeTraverser() {}
 
   /**
    * Returns a tree traverser that uses the given function to navigate from a node to its children.

android/guava/src/com/google/common/graph/AbstractGraph.java

@@ -30,6 +30,8 @@
 @Beta
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractGraph<N> extends AbstractBaseGraph<N> implements Graph<N> {
+  /** Constructor for use by subclasses. */
+  public AbstractGraph() {}
 
   @Override
   public final boolean equals(@CheckForNull Object obj) {

android/guava/src/com/google/common/graph/AbstractNetwork.java

@@ -53,6 +53,9 @@
 @Beta
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractNetwork<N, E> implements Network<N, E> {
+  /** Constructor for use by subclasses. */
+  public AbstractNetwork() {}
+
   @Override
   public Graph<N> asGraph() {
     return new AbstractGraph<N>() {

android/guava/src/com/google/common/graph/AbstractValueGraph.java

@@ -40,6 +40,8 @@
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractValueGraph<N, V> extends AbstractBaseGraph<N>
     implements ValueGraph<N, V> {
+  /** Constructor for use by subclasses. */
+  public AbstractValueGraph() {}
 
   @Override
   public Graph<N> asGraph() {

android/guava/src/com/google/common/math/LinearTransformation.java

@@ -38,6 +38,13 @@
 @GwtIncompatible
 @ElementTypesAreNonnullByDefault
 public abstract class LinearTransformation {
+  /**
+   * Constructor for use by subclasses inside Guava.
+   *
+   * @deprecated Create instances by using the static factory methods of the class.
+   */
+  @Deprecated
+  public LinearTransformation() {}
 
   /**
    * Start building an instance which maps {@code x = x1} to {@code y = y1}. Both arguments must be

android/guava/src/com/google/common/math/PairedStatsAccumulator.java

@@ -34,6 +34,8 @@
 @GwtIncompatible
 @ElementTypesAreNonnullByDefault
 public final class PairedStatsAccumulator {
+  /** Creates a new accumulator. */
+  public PairedStatsAccumulator() {}
 
   // These fields must satisfy the requirements of PairedStats' constructor as well as those of the
   // stat methods of this class.

android/guava/src/com/google/common/math/Quantiles.java

@@ -130,6 +130,14 @@
 @GwtIncompatible
 @ElementTypesAreNonnullByDefault
 public final class Quantiles {
+  /**
+   * Constructor for a type that is not meant to be instantiated.
+   *
+   * @deprecated Use the static factory methods of the class. There is no reason to create an
+   *     instance of {@link Quantiles}.
+   */
+  @Deprecated
+  public Quantiles() {}
 
   /** Specifies the computation of a median (i.e. the 1st 2-quantile). */
   public static ScaleAndIndex median() {