Fix some Javadoc warnings, mostly around the use of the default const…

…ructor.

RELNOTES=n/a
PiperOrigin-RevId: 698442998

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() {

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

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

android/guava/src/com/google/common/reflect/AbstractInvocationHandler.java

@@ -40,6 +40,8 @@
  */
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractInvocationHandler implements InvocationHandler {
+  /** Constructor for use by subclasses. */
+  public AbstractInvocationHandler() {}
 
   private static final Object[] NO_ARGS = {};
 

android/guava/src/com/google/common/reflect/MutableTypeToInstanceMap.java

@@ -39,6 +39,8 @@
 @ElementTypesAreNonnullByDefault
 public final class MutableTypeToInstanceMap<B extends @Nullable Object>
     extends ForwardingMap<TypeToken<? extends @NonNull B>, B> implements TypeToInstanceMap<B> {
+  /** Creats a new map. */
+  public MutableTypeToInstanceMap() {}
 
   private final Map<TypeToken<? extends @NonNull B>, B> backingMap = Maps.newHashMap();
 

android/guava/src/com/google/common/util/concurrent/AbstractListeningExecutorService.java

@@ -40,6 +40,8 @@
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractListeningExecutorService extends AbstractExecutorService
     implements ListeningExecutorService {
+  /** Constructor for use by subclasses. */
+  public AbstractListeningExecutorService() {}
 
   /**
    * @since 19.0 (present with return type {@code ListenableFutureTask} since 14.0)

android/guava/src/com/google/common/util/concurrent/AbstractScheduledService.java

@@ -512,6 +512,8 @@ public boolean isCancelled() {
    * @since 11.0
    */
   public abstract static class CustomScheduler extends Scheduler {
+    /** Constructor for use by subclasses. */
+    public CustomScheduler() {}
 
     /** A callable class that can reschedule itself using a {@link CustomScheduler}. */
     private final class ReschedulableCallable implements Callable<@Nullable Void> {

android/guava/src/com/google/common/util/concurrent/FakeTimeLimiter.java

@@ -39,6 +39,9 @@
 @GwtIncompatible
 @ElementTypesAreNonnullByDefault
 public final class FakeTimeLimiter implements TimeLimiter {
+  /** Creates a new {@link FakeTimeLimiter}. */
+  public FakeTimeLimiter() {}
+
   @CanIgnoreReturnValue // TODO(kak): consider removing this
   @Override
   public <T> T newProxy(

android/guava/src/com/google/common/util/concurrent/Service.java

@@ -211,6 +211,9 @@ enum State {
    * @since 15.0 (present as an interface in 13.0)
    */
   abstract class Listener {
+    /** Constructor for use by subclasses. */
+    public Listener() {}
+
     /**
      * Called when the service transitions from {@linkplain State#NEW NEW} to {@linkplain
      * State#STARTING STARTING}. This occurs when {@link Service#startAsync} is called the first

android/guava/src/com/google/common/util/concurrent/ServiceManager.java

@@ -160,6 +160,9 @@ public String toString() {
    * @since 15.0 (present as an interface in 14.0)
    */
   public abstract static class Listener {
+    /** Constructor for use by subclasses. */
+    public Listener() {}
+
     /**
      * Called when the service initially becomes healthy.
      *

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

@@ -972,7 +972,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(

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();

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();
 
     /**

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

@@ -78,6 +78,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.

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) {

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

@@ -54,6 +54,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>() {

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

@@ -41,6 +41,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() {

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

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.

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() {

guava/src/com/google/common/math/StatsAccumulator.java

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

guava/src/com/google/common/reflect/AbstractInvocationHandler.java

@@ -40,6 +40,8 @@
  */
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractInvocationHandler implements InvocationHandler {
+  /** Constructor for use by subclasses. */
+  public AbstractInvocationHandler() {}
 
   private static final Object[] NO_ARGS = {};
 

guava/src/com/google/common/reflect/MutableTypeToInstanceMap.java

@@ -39,6 +39,8 @@
 @ElementTypesAreNonnullByDefault
 public final class MutableTypeToInstanceMap<B extends @Nullable Object>
     extends ForwardingMap<TypeToken<? extends @NonNull B>, B> implements TypeToInstanceMap<B> {
+  /** Creats a new map. */
+  public MutableTypeToInstanceMap() {}
 
   private final Map<TypeToken<? extends @NonNull B>, B> backingMap = Maps.newHashMap();
 

guava/src/com/google/common/util/concurrent/AbstractListeningExecutorService.java

@@ -40,6 +40,8 @@
 @ElementTypesAreNonnullByDefault
 public abstract class AbstractListeningExecutorService extends AbstractExecutorService
     implements ListeningExecutorService {
+  /** Constructor for use by subclasses. */
+  public AbstractListeningExecutorService() {}
 
   /**
    * @since 19.0 (present with return type {@code ListenableFutureTask} since 14.0)

guava/src/com/google/common/util/concurrent/AbstractScheduledService.java

@@ -520,6 +520,8 @@ public boolean isCancelled() {
    * @since 11.0
    */
   public abstract static class CustomScheduler extends Scheduler {
+    /** Constructor for use by subclasses. */
+    public CustomScheduler() {}
 
     /** A callable class that can reschedule itself using a {@link CustomScheduler}. */
     private final class ReschedulableCallable implements Callable<@Nullable Void> {

guava/src/com/google/common/util/concurrent/FakeTimeLimiter.java

@@ -39,6 +39,9 @@
 @GwtIncompatible
 @ElementTypesAreNonnullByDefault
 public final class FakeTimeLimiter implements TimeLimiter {
+  /** Creates a new {@link FakeTimeLimiter}. */
+  public FakeTimeLimiter() {}
+
   @CanIgnoreReturnValue // TODO(kak): consider removing this
   @Override
   public <T> T newProxy(

guava/src/com/google/common/util/concurrent/Service.java

@@ -242,6 +242,9 @@ enum State {
    * @since 15.0 (present as an interface in 13.0)
    */
   abstract class Listener {
+    /** Constructor for use by subclasses. */
+    public Listener() {}
+
     /**
      * Called when the service transitions from {@linkplain State#NEW NEW} to {@linkplain
      * State#STARTING STARTING}. This occurs when {@link Service#startAsync} is called the first

guava/src/com/google/common/util/concurrent/ServiceManager.java

@@ -160,6 +160,9 @@ public String toString() {
    * @since 15.0 (present as an interface in 14.0)
    */
   public abstract static class Listener {
+    /** Constructor for use by subclasses. */
+    public Listener() {}
+
     /**
      * Called when the service initially becomes healthy.
      *