Avoid using @see in the summary fragment in C.java

PiperOrigin-RevId: 532536037

libraries/common/src/main/java/androidx/media3/common/C.java

@@ -142,17 +142,11 @@ public final class C {
   @IntDef({CRYPTO_MODE_UNENCRYPTED, CRYPTO_MODE_AES_CTR, CRYPTO_MODE_AES_CBC})
   @UnstableApi
   public @interface CryptoMode {}
-  /**
+  /** See {@link MediaCodec#CRYPTO_MODE_UNENCRYPTED}. */
-   * @see MediaCodec#CRYPTO_MODE_UNENCRYPTED
-   */
   @UnstableApi public static final int CRYPTO_MODE_UNENCRYPTED = MediaCodec.CRYPTO_MODE_UNENCRYPTED;
-  /**
+  /** See {@link MediaCodec#CRYPTO_MODE_AES_CTR}. */
-   * @see MediaCodec#CRYPTO_MODE_AES_CTR
-   */
   @UnstableApi public static final int CRYPTO_MODE_AES_CTR = MediaCodec.CRYPTO_MODE_AES_CTR;
-  /**
+  /** See {@link MediaCodec#CRYPTO_MODE_AES_CBC}. */
-   * @see MediaCodec#CRYPTO_MODE_AES_CBC
-   */
   @UnstableApi public static final int CRYPTO_MODE_AES_CBC = MediaCodec.CRYPTO_MODE_AES_CBC;
 
   /**
@@ -222,17 +216,11 @@ public final class C {
     ENCODING_PCM_FLOAT
   })
   public @interface PcmEncoding {}
-  /**
+  /** See {@link AudioFormat#ENCODING_INVALID}. */
-   * @see AudioFormat#ENCODING_INVALID
-   */
   @UnstableApi public static final int ENCODING_INVALID = AudioFormat.ENCODING_INVALID;
-  /**
+  /** See {@link AudioFormat#ENCODING_PCM_8BIT}. */
-   * @see AudioFormat#ENCODING_PCM_8BIT
-   */
   @UnstableApi public static final int ENCODING_PCM_8BIT = AudioFormat.ENCODING_PCM_8BIT;
-  /**
+  /** See {@link AudioFormat#ENCODING_PCM_16BIT}. */
-   * @see AudioFormat#ENCODING_PCM_16BIT
-   */
   @UnstableApi public static final int ENCODING_PCM_16BIT = AudioFormat.ENCODING_PCM_16BIT;
   /** Like {@link #ENCODING_PCM_16BIT}, but with the bytes in big endian order. */
   @UnstableApi public static final int ENCODING_PCM_16BIT_BIG_ENDIAN = 0x10000000;
@@ -240,67 +228,37 @@ public final class C {
   @UnstableApi public static final int ENCODING_PCM_24BIT = 0x20000000;
   /** PCM encoding with 32 bits per sample. */
   @UnstableApi public static final int ENCODING_PCM_32BIT = 0x30000000;
-  /**
+  /** See {@link AudioFormat#ENCODING_PCM_FLOAT}. */
-   * @see AudioFormat#ENCODING_PCM_FLOAT
-   */
   @UnstableApi public static final int ENCODING_PCM_FLOAT = AudioFormat.ENCODING_PCM_FLOAT;
-  /**
+  /** See {@link AudioFormat#ENCODING_MP3}. */
-   * @see AudioFormat#ENCODING_MP3
-   */
   @UnstableApi public static final int ENCODING_MP3 = AudioFormat.ENCODING_MP3;
-  /**
+  /** See {@link AudioFormat#ENCODING_AAC_LC}. */
-   * @see AudioFormat#ENCODING_AAC_LC
-   */
   @UnstableApi public static final int ENCODING_AAC_LC = AudioFormat.ENCODING_AAC_LC;
-  /**
+  /** See {@link AudioFormat#ENCODING_AAC_HE_V1}. */
-   * @see AudioFormat#ENCODING_AAC_HE_V1
-   */
   @UnstableApi public static final int ENCODING_AAC_HE_V1 = AudioFormat.ENCODING_AAC_HE_V1;
-  /**
+  /** See {@link AudioFormat#ENCODING_AAC_HE_V2}. */
-   * @see AudioFormat#ENCODING_AAC_HE_V2
-   */
   @UnstableApi public static final int ENCODING_AAC_HE_V2 = AudioFormat.ENCODING_AAC_HE_V2;
-  /**
+  /** See {@link AudioFormat#ENCODING_AAC_XHE}. */
-   * @see AudioFormat#ENCODING_AAC_XHE
-   */
   @UnstableApi public static final int ENCODING_AAC_XHE = AudioFormat.ENCODING_AAC_XHE;
-  /**
+  /** See {@link AudioFormat#ENCODING_AAC_ELD}. */
-   * @see AudioFormat#ENCODING_AAC_ELD
-   */
   @UnstableApi public static final int ENCODING_AAC_ELD = AudioFormat.ENCODING_AAC_ELD;
   /** AAC Error Resilient Bit-Sliced Arithmetic Coding. */
   @UnstableApi public static final int ENCODING_AAC_ER_BSAC = 0x40000000;
-  /**
+  /** See {@link AudioFormat#ENCODING_AC3}. */
-   * @see AudioFormat#ENCODING_AC3
-   */
   @UnstableApi public static final int ENCODING_AC3 = AudioFormat.ENCODING_AC3;
-  /**
+  /** See {@link AudioFormat#ENCODING_E_AC3}. */
-   * @see AudioFormat#ENCODING_E_AC3
-   */
   @UnstableApi public static final int ENCODING_E_AC3 = AudioFormat.ENCODING_E_AC3;
-  /**
+  /** See {@link AudioFormat#ENCODING_E_AC3_JOC}. */
-   * @see AudioFormat#ENCODING_E_AC3_JOC
-   */
   @UnstableApi public static final int ENCODING_E_AC3_JOC = AudioFormat.ENCODING_E_AC3_JOC;
-  /**
+  /** See {@link AudioFormat#ENCODING_AC4}. */
-   * @see AudioFormat#ENCODING_AC4
-   */
   @UnstableApi public static final int ENCODING_AC4 = AudioFormat.ENCODING_AC4;
-  /**
+  /** See {@link AudioFormat#ENCODING_DTS}. */
-   * @see AudioFormat#ENCODING_DTS
-   */
   @UnstableApi public static final int ENCODING_DTS = AudioFormat.ENCODING_DTS;
-  /**
+  /** See {@link AudioFormat#ENCODING_DTS_HD}. */
-   * @see AudioFormat#ENCODING_DTS_HD
-   */
   @UnstableApi public static final int ENCODING_DTS_HD = AudioFormat.ENCODING_DTS_HD;
-  /**
+  /** See {@link AudioFormat#ENCODING_DOLBY_TRUEHD}. */
-   * @see AudioFormat#ENCODING_DOLBY_TRUEHD
-   */
   @UnstableApi public static final int ENCODING_DOLBY_TRUEHD = AudioFormat.ENCODING_DOLBY_TRUEHD;
-  /**
+  /** See {@link AudioFormat#ENCODING_OPUS}. */
-   * @see AudioFormat#ENCODING_OPUS
-   */
   @UnstableApi public static final int ENCODING_OPUS = AudioFormat.ENCODING_OPUS;
 
   /**
@@ -313,14 +271,10 @@ public final class C {
   @IntDef({SPATIALIZATION_BEHAVIOR_AUTO, SPATIALIZATION_BEHAVIOR_NEVER})
   public @interface SpatializationBehavior {}
 
-  /**
+  /** See {@link AudioAttributes#SPATIALIZATION_BEHAVIOR_AUTO}. */
-   * @see AudioAttributes#SPATIALIZATION_BEHAVIOR_AUTO
-   */
   public static final int SPATIALIZATION_BEHAVIOR_AUTO =
       AudioAttributes.SPATIALIZATION_BEHAVIOR_AUTO;
-  /**
+  /** See {@link AudioAttributes#SPATIALIZATION_BEHAVIOR_NEVER}. */
-   * @see AudioAttributes#SPATIALIZATION_BEHAVIOR_NEVER
-   */
   public static final int SPATIALIZATION_BEHAVIOR_NEVER =
       AudioAttributes.SPATIALIZATION_BEHAVIOR_NEVER;
 
@@ -348,33 +302,19 @@ public final class C {
     STREAM_TYPE_DEFAULT
   })
   public @interface StreamType {}
-  /**
+  /** See {@link AudioManager#STREAM_ALARM}. */
-   * @see AudioManager#STREAM_ALARM
-   */
   @UnstableApi public static final int STREAM_TYPE_ALARM = AudioManager.STREAM_ALARM;
-  /**
+  /** See {@link AudioManager#STREAM_DTMF}. */
-   * @see AudioManager#STREAM_DTMF
-   */
   @UnstableApi public static final int STREAM_TYPE_DTMF = AudioManager.STREAM_DTMF;
-  /**
+  /** See {@link AudioManager#STREAM_MUSIC}. */
-   * @see AudioManager#STREAM_MUSIC
-   */
   @UnstableApi public static final int STREAM_TYPE_MUSIC = AudioManager.STREAM_MUSIC;
-  /**
+  /** See {@link AudioManager#STREAM_NOTIFICATION}. */
-   * @see AudioManager#STREAM_NOTIFICATION
-   */
   @UnstableApi public static final int STREAM_TYPE_NOTIFICATION = AudioManager.STREAM_NOTIFICATION;
-  /**
+  /** See {@link AudioManager#STREAM_RING}. */
-   * @see AudioManager#STREAM_RING
-   */
   @UnstableApi public static final int STREAM_TYPE_RING = AudioManager.STREAM_RING;
-  /**
+  /** See {@link AudioManager#STREAM_SYSTEM}. */
-   * @see AudioManager#STREAM_SYSTEM
-   */
   @UnstableApi public static final int STREAM_TYPE_SYSTEM = AudioManager.STREAM_SYSTEM;
-  /**
+  /** See {@link AudioManager#STREAM_VOICE_CALL}. */
-   * @see AudioManager#STREAM_VOICE_CALL
-   */
   @UnstableApi public static final int STREAM_TYPE_VOICE_CALL = AudioManager.STREAM_VOICE_CALL;
   /** The default stream type used by audio renderers. Equal to {@link #STREAM_TYPE_MUSIC}. */
   @UnstableApi public static final int STREAM_TYPE_DEFAULT = STREAM_TYPE_MUSIC;
@@ -483,9 +423,7 @@ public final class C {
       flag = true,
       value = {FLAG_AUDIBILITY_ENFORCED})
   public @interface AudioFlags {}
-  /**
+  /** See {@link android.media.AudioAttributes#FLAG_AUDIBILITY_ENFORCED}. */
-   * @see android.media.AudioAttributes#FLAG_AUDIBILITY_ENFORCED
-   */
   public static final int FLAG_AUDIBILITY_ENFORCED =
       android.media.AudioAttributes.FLAG_AUDIBILITY_ENFORCED;
 
@@ -523,78 +461,46 @@ public final class C {
     USAGE_VOICE_COMMUNICATION_SIGNALLING
   })
   public @interface AudioUsage {}
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_ALARM}. */
-   * @see android.media.AudioAttributes#USAGE_ALARM
-   */
   public static final int USAGE_ALARM = android.media.AudioAttributes.USAGE_ALARM;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY}. */
-   * @see android.media.AudioAttributes#USAGE_ASSISTANCE_ACCESSIBILITY
-   */
   public static final int USAGE_ASSISTANCE_ACCESSIBILITY =
       android.media.AudioAttributes.USAGE_ASSISTANCE_ACCESSIBILITY;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE}. */
-   * @see android.media.AudioAttributes#USAGE_ASSISTANCE_NAVIGATION_GUIDANCE
-   */
   public static final int USAGE_ASSISTANCE_NAVIGATION_GUIDANCE =
       android.media.AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_ASSISTANCE_SONIFICATION}. */
-   * @see android.media.AudioAttributes#USAGE_ASSISTANCE_SONIFICATION
-   */
   public static final int USAGE_ASSISTANCE_SONIFICATION =
       android.media.AudioAttributes.USAGE_ASSISTANCE_SONIFICATION;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_ASSISTANT}. */
-   * @see android.media.AudioAttributes#USAGE_ASSISTANT
-   */
   public static final int USAGE_ASSISTANT = android.media.AudioAttributes.USAGE_ASSISTANT;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_GAME}. */
-   * @see android.media.AudioAttributes#USAGE_GAME
-   */
   public static final int USAGE_GAME = android.media.AudioAttributes.USAGE_GAME;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_MEDIA}. */
-   * @see android.media.AudioAttributes#USAGE_MEDIA
-   */
   public static final int USAGE_MEDIA = android.media.AudioAttributes.USAGE_MEDIA;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION
-   */
   public static final int USAGE_NOTIFICATION = android.media.AudioAttributes.USAGE_NOTIFICATION;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_DELAYED
-   */
   public static final int USAGE_NOTIFICATION_COMMUNICATION_DELAYED =
       android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_DELAYED;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_INSTANT
-   */
   public static final int USAGE_NOTIFICATION_COMMUNICATION_INSTANT =
       android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_INSTANT;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION_COMMUNICATION_REQUEST
-   */
   public static final int USAGE_NOTIFICATION_COMMUNICATION_REQUEST =
       android.media.AudioAttributes.USAGE_NOTIFICATION_COMMUNICATION_REQUEST;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION_EVENT}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION_EVENT
-   */
   public static final int USAGE_NOTIFICATION_EVENT =
       android.media.AudioAttributes.USAGE_NOTIFICATION_EVENT;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_NOTIFICATION_RINGTONE}. */
-   * @see android.media.AudioAttributes#USAGE_NOTIFICATION_RINGTONE
-   */
   public static final int USAGE_NOTIFICATION_RINGTONE =
       android.media.AudioAttributes.USAGE_NOTIFICATION_RINGTONE;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_UNKNOWN}. */
-   * @see android.media.AudioAttributes#USAGE_UNKNOWN
-   */
   public static final int USAGE_UNKNOWN = android.media.AudioAttributes.USAGE_UNKNOWN;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION}. */
-   * @see android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION
-   */
   public static final int USAGE_VOICE_COMMUNICATION =
       android.media.AudioAttributes.USAGE_VOICE_COMMUNICATION;
-  /**
+  /** See {@link android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING}. */
-   * @see android.media.AudioAttributes#USAGE_VOICE_COMMUNICATION_SIGNALLING
-   */
   public static final int USAGE_VOICE_COMMUNICATION_SIGNALLING =
       android.media.AudioAttributes.USAGE_VOICE_COMMUNICATION_SIGNALLING;
 
@@ -1066,17 +972,11 @@ public final class C {
   @Target(TYPE_USE)
   @IntDef({Format.NO_VALUE, COLOR_SPACE_BT601, COLOR_SPACE_BT709, COLOR_SPACE_BT2020})
   public @interface ColorSpace {}
-  /**
+  /** See {@link MediaFormat#COLOR_STANDARD_BT601_PAL}. */
-   * @see MediaFormat#COLOR_STANDARD_BT601_PAL
-   */
   @UnstableApi public static final int COLOR_SPACE_BT601 = MediaFormat.COLOR_STANDARD_BT601_PAL;
-  /**
+  /** See {@link MediaFormat#COLOR_STANDARD_BT709}. */
-   * @see MediaFormat#COLOR_STANDARD_BT709
-   */
   @UnstableApi public static final int COLOR_SPACE_BT709 = MediaFormat.COLOR_STANDARD_BT709;
-  /**
+  /** See {@link MediaFormat#COLOR_STANDARD_BT2020}. */
-   * @see MediaFormat#COLOR_STANDARD_BT2020
-   */
   @UnstableApi public static final int COLOR_SPACE_BT2020 = MediaFormat.COLOR_STANDARD_BT2020;
 
   // LINT.IfChange(color_transfer)
@@ -1131,13 +1031,9 @@ public final class C {
   @Target(TYPE_USE)
   @IntDef({Format.NO_VALUE, COLOR_RANGE_LIMITED, COLOR_RANGE_FULL})
   public @interface ColorRange {}
-  /**
+  /** See {@link MediaFormat#COLOR_RANGE_LIMITED}. */
-   * @see MediaFormat#COLOR_RANGE_LIMITED
-   */
   @UnstableApi public static final int COLOR_RANGE_LIMITED = MediaFormat.COLOR_RANGE_LIMITED;
-  /**
+  /** See {@link MediaFormat#COLOR_RANGE_FULL}. */
-   * @see MediaFormat#COLOR_RANGE_FULL
-   */
   @UnstableApi public static final int COLOR_RANGE_FULL = MediaFormat.COLOR_RANGE_FULL;
 
   /**