[ProgressIndicator] Corrected comments for javadoc.

PiperOrigin-RevId: 343570043
(cherry picked from commit 3795197)

Author: pekingme

lib/java/com/google/android/material/progressindicator/BaseProgressIndicator.java

@@ -59,7 +59,7 @@
  *
  * <ul>
  *   <li>{@code trackThickness}: the thickness of the indicator and track.
- *   <li>{@code indicatorColor}: the color of the indicator.
+ *   <li>{@code indicatorColor}: the color(s) of the indicator.
  *   <li>{@code trackColor}: the color of the track.
  *   <li>{@code trackCornerRadius}: the radius of the rounded corner of the indicator and track.
  *   <li>{@code showAnimationBehavior}: the animation direction to show the indicator and track.
@@ -538,7 +538,7 @@ public int getTrackThickness() {
   /**
    * Sets the track thickness of this progress indicator.
    *
-   * @param trackThickness The new indicator size in pixel.
+   * @param trackThickness The new track/indicator thickness in pixels.
    * @see #getTrackThickness()
    * @attr ref
    *     com.google.android.material.progressindicator.R.stylable#BaseProgressIndicator_trackThickness

lib/java/com/google/android/material/progressindicator/BaseProgressIndicatorSpec.java

@@ -40,7 +40,7 @@
  * reflect the attributes defined in {@link R.styleable#BaseProgressIndicator}.
  */
 public abstract class BaseProgressIndicatorSpec {
-  /** The thickness of the progress track and indicator. */
+  /** The thickness of the track and indicator. */
   @Px public int trackThickness;
 
   /**
@@ -51,13 +51,12 @@ public abstract class BaseProgressIndicatorSpec {
   @Px public int trackCornerRadius;
 
   /**
-   * The color array of the progress stroke. In determinate mode and single color indeterminate
-   * mode, only the first item will be used.
+   * The color array used in the indicator. In determinate mode, only the first item will be used.
    */
   @NonNull public int[] indicatorColors = new int[0];
 
   /**
-   * The color used for the progress track. If not defined, it will be set to the indicatorColor and
+   * The color used in the track. If not defined, it will be set to the indicatorColors and
    * apply the first disable alpha value from the theme.
    */
   @ColorInt public int trackColor;
@@ -71,7 +70,7 @@ public abstract class BaseProgressIndicatorSpec {
   /**
    * Instantiates BaseProgressIndicatorSpec.
    *
-   * <p>If attributes are missing, the values stored in the default style {@link
+   * <p>If attributes are missing, the values defined in the default style {@link
    * R.style#Widget_MaterialComponents_ProgressIndicator} will be loaded.
    *
    * @param context Current themed context.

lib/java/com/google/android/material/progressindicator/CircularProgressIndicator.java

@@ -40,7 +40,7 @@
  *
  * <ul>
  *   <li>{@code trackThickness}: the thickness of the indicator and track.
- *   <li>{@code indicatorColor}: the color of the indicator.
+ *   <li>{@code indicatorColor}: the color(s) of the indicator.
  *   <li>{@code trackColor}: the color of the track.
  *   <li>{@code trackCornerRadius}: the radius of the rounded corner of the indicator and track.
  *   <li>{@code indicatorSize}: the outer diameter of the spinner.
@@ -90,11 +90,13 @@ private void initializeDrawables() {
   // **************** Getters and setters ****************
 
   /**
-   * Sets the indicator size of this progress indicator.
+   * Sets the track thickness of this progress indicator.
    *
-   * @param trackThickness The new indicator size in pixel.
-   * @throws IllegalArgumentException if indicator radius is less than half of the new indicator
-   *     size.
+   * @param trackThickness The new track/indicator thickness in pixel.
+   * @see #getTrackThickness()
+   * @attr ref
+   *     com.google.android.material.progressindicator.R.stylable#BaseProgressIndicator_trackThickness
+   * @throws IllegalArgumentException if indicator size is less than twice of the track thickness.
    */
   @Override
   public void setTrackThickness(int trackThickness) {
@@ -130,7 +132,7 @@ public void setIndicatorInset(@Px int indicatorInset) {
   }
 
   /**
-   * Returns the radius of this progress indicator.
+   * Returns the size (outer diameter) of this progress indicator.
    *
    * @see #setIndicatorSize(int)
    * @attr ref

lib/java/com/google/android/material/progressindicator/LinearProgressIndicator.java

@@ -42,7 +42,7 @@
  *
  * <ul>
  *   <li>{@code trackThickness}: the thickness of the indicator and track.
- *   <li>{@code indicatorColor}: the color of the indicator.
+ *   <li>{@code indicatorColor}: the color(s) of the indicator.
  *   <li>{@code trackColor}: the color of the track.
  *   <li>{@code trackCornerRadius}: the radius of the rounded corner of the indicator and track.
  *   <li>{@code indeterminateAnimationType}: the type of indeterminate animation.