Remove @see tags with <a> tags

These are not supported by Dackka

#minor-release

PiperOrigin-RevId: 513176533
(cherry picked from commit ef5a1ce)

library/common/src/main/java/com/google/android/exoplayer2/util/ColorParser.java

@@ -27,8 +27,12 @@
 /**
  * Parser for color expressions found in styling formats, e.g. TTML and CSS.
  *
- * @see <a href="https://w3c.github.io/webvtt/#styling">WebVTT CSS Styling</a>
- * @see <a href="https://www.w3.org/TR/ttml2/">Timed Text Markup Language 2 (TTML2) - 10.3.5</a>
+ * <p>See also:
+ *
+ * <ul>
+ *   <li><a href="https://w3c.github.io/webvtt/#styling">WebVTT CSS Styling</a>
+ *   <li><a href="https://www.w3.org/TR/ttml2/">Timed Text Markup Language 2 (TTML2) - 10.3.5</a>
+ * </ul>
  */
 public final class ColorParser {
 

library/core/src/main/java/com/google/android/exoplayer2/upstream/SlidingPercentile.java

@@ -29,8 +29,12 @@
  * rate observations. This is an alternative to sliding mean and exponential averaging which suffer
  * from susceptibility to outliers and slow adaptation to step functions.
  *
- * @see <a href="http://en.wikipedia.org/wiki/Moving_average">Wiki: Moving average</a>
- * @see <a href="http://en.wikipedia.org/wiki/Selection_algorithm">Wiki: Selection algorithm</a>
+ * <p>See the following Wikipedia articles:
+ *
+ * <ul>
+ *   <li><a href="http://en.wikipedia.org/wiki/Moving_average">Moving average</a>
+ *   <li><a href="http://en.wikipedia.org/wiki/Selection_algorithm">Selection algorithm</a>
+ * </ul>
  */
 public class SlidingPercentile {
 

library/extractor/src/main/java/com/google/android/exoplayer2/extractor/FlacStreamMetadata.java

@@ -32,14 +32,18 @@
 /**
  * Holder for FLAC metadata.
  *
- * @see <a href="https://xiph.org/flac/format.html#metadata_block_streaminfo">FLAC format
- *     METADATA_BLOCK_STREAMINFO</a>
- * @see <a href="https://xiph.org/flac/format.html#metadata_block_seektable">FLAC format
- *     METADATA_BLOCK_SEEKTABLE</a>
- * @see <a href="https://xiph.org/flac/format.html#metadata_block_vorbis_comment">FLAC format
- *     METADATA_BLOCK_VORBIS_COMMENT</a>
- * @see <a href="https://xiph.org/flac/format.html#metadata_block_picture">FLAC format
- *     METADATA_BLOCK_PICTURE</a>
+ * <p>See the following spec references:
+ *
+ * <ul>
+ *   <li><a href="https://xiph.org/flac/format.html#metadata_block_streaminfo">FLAC format
+ *       METADATA_BLOCK_STREAMINFO</a>
+ *   <li><a href="https://xiph.org/flac/format.html#metadata_block_seektable">FLAC format
+ *       METADATA_BLOCK_SEEKTABLE</a>
+ *   <li><a href="https://xiph.org/flac/format.html#metadata_block_vorbis_comment">FLAC format
+ *       METADATA_BLOCK_VORBIS_COMMENT</a>
+ *   <li><a href="https://xiph.org/flac/format.html#metadata_block_picture">FLAC format
+ *       METADATA_BLOCK_PICTURE</a>
+ * </ul>
  */
 public final class FlacStreamMetadata {
 

library/extractor/src/main/java/com/google/android/exoplayer2/extractor/VorbisBitArray.java

@@ -22,8 +22,8 @@
 /**
  * Wraps a byte array, providing methods that allow it to be read as a Vorbis bitstream.
  *
- * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-360002">Vorbis bitpacking
- *     specification</a>
+ * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-360002">Vorbis
+ * bitpacking specification</a>
  */
 public final class VorbisBitArray {
 

library/extractor/src/main/java/com/google/android/exoplayer2/extractor/VorbisUtil.java

@@ -50,8 +50,8 @@ public CommentHeader(String vendor, String[] comments, int length) {
   /**
    * Vorbis identification header.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
-   *     spec/Identification header</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
+   * spec/Identification header</a>
    */
   public static final class VorbisIdHeader {
 
@@ -133,8 +133,9 @@ public Mode(boolean blockFlag, int windowType, int transformType, int mapping) {
   /**
    * Returns ilog(x), which is the index of the highest set bit in {@code x}.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-1190009.2.1">Vorbis
-   *     spec</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-1190009.2.1">Vorbis
+   * spec</a>
+   *
    * @param x the value of which the ilog should be calculated.
    * @return ilog(x)
    */
@@ -150,8 +151,9 @@ public static int iLog(int x) {
   /**
    * Reads a Vorbis identification header from {@code headerData}.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
-   *     spec/Identification header</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
+   * spec/Identification header</a>
+   *
    * @param headerData a {@link ParsableByteArray} wrapping the header data.
    * @return a {@link VorbisUtil.VorbisIdHeader} with meta data.
    * @throws ParserException thrown if invalid capture pattern is detected.
@@ -200,8 +202,9 @@ public static VorbisIdHeader readVorbisIdentificationHeader(ParsableByteArray he
   /**
    * Reads a Vorbis comment header.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
-   *     spec/Comment header</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
+   * spec/Comment header</a>
+   *
    * @param headerData A {@link ParsableByteArray} wrapping the header data.
    * @return A {@link VorbisUtil.CommentHeader} with all the comments.
    * @throws ParserException If an error occurs parsing the comment header.
@@ -217,8 +220,9 @@ public static CommentHeader readVorbisCommentHeader(ParsableByteArray headerData
    *
    * <p>The data provided may not contain the Vorbis metadata common header and the framing bit.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
-   *     spec/Comment header</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
+   * spec/Comment header</a>
+   *
    * @param headerData A {@link ParsableByteArray} wrapping the header data.
    * @param hasMetadataHeader Whether the {@code headerData} contains a Vorbis metadata common
    *     header preceding the comment header.
@@ -347,8 +351,9 @@ public static boolean verifyVorbisHeaderCapturePattern(
    * That's why we need to partially decode or at least read the entire setup header to know where
    * to start reading the modes.
    *
-   * @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-650004.2.4">Vorbis
-   *     spec/Setup header</a>
+   * <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-650004.2.4">Vorbis
+   * spec/Setup header</a>
+   *
    * @param headerData a {@link ParsableByteArray} containing setup header data.
    * @param channels the number of channels.
    * @return an array of {@link Mode}s.
@@ -590,7 +595,8 @@ private static CodeBook readBook(VorbisBitArray bitArray) throws ParserException
   }
 
   /**
-   * @see <a href="http://svn.xiph.org/trunk/vorbis/lib/sharedbook.c">_book_maptype1_quantvals</a>
+   * See the <a
+   * href="http://svn.xiph.org/trunk/vorbis/lib/sharedbook.c">_book_maptype1_quantvals</a>
    */
   private static long mapType1QuantValues(long entries, long dimension) {
     return (long) Math.floor(Math.pow(entries, 1.d / dimension));

library/extractor/src/main/java/com/google/android/exoplayer2/text/ttml/TtmlDecoder.java

@@ -64,7 +64,7 @@
  *   <li>cell-resolution
  * </ul>
  *
- * @see <a href="http://www.w3.org/TR/ttaf1-dfxp/">TTML specification</a>
+ * <p>See the <a href="http://www.w3.org/TR/ttaf1-dfxp/">TTML specification</a>
  */
 public final class TtmlDecoder extends SimpleSubtitleDecoder {
 

library/extractor/src/main/java/com/google/android/exoplayer2/text/webvtt/WebvttCssStyle.java

@@ -35,10 +35,10 @@
 import java.util.Set;
 
 /**
- * Style object of a Css style block in a Webvtt file.
+ * Style object of a CSS style block in a WebVTT file.
  *
- * @see <a href="https://w3c.github.io/webvtt/#applying-css-properties">W3C specification - Apply
- *     CSS properties</a>
+ * <p>See the <a href="https://w3c.github.io/webvtt/#applying-css-properties">Apply CSS properties
+ * section of the W3C specification</a>
  */
 public final class WebvttCssStyle {
 

library/extractor/src/main/java/com/google/android/exoplayer2/text/webvtt/WebvttDecoder.java

@@ -28,7 +28,7 @@
 /**
  * A {@link SimpleSubtitleDecoder} for WebVTT.
  *
- * @see <a href="http://dev.w3.org/html5/webvtt">WebVTT specification</a>
+ * <p>See the <a href="http://dev.w3.org/html5/webvtt">WebVTT specification</a>.
  */
 public final class WebvttDecoder extends SimpleSubtitleDecoder {
 

library/extractor/src/test/java/com/google/android/exoplayer2/text/ttml/TtmlDecoderTest.java

@@ -112,14 +112,11 @@ public void inheritInlineAttributes() throws IOException, SubtitleDecoderExcepti
    * Regression test for devices on JellyBean where some named colors are not correctly defined on
    * framework level. Tests that <i>lime</i> resolves to <code>#FF00FF00</code> not <code>#00FF00
    * </code>.
-   *
-   * @throws IOException thrown if reading subtitle file fails.
-   * @see <a
-   *     href="https://github.com/android/platform_frameworks_base/blob/jb-mr2-release/graphics/java/android/graphics/Color.java#L414">
-   *     JellyBean Color</a> <a
-   *     href="https://github.com/android/platform_frameworks_base/blob/kitkat-mr2.2-release/graphics/java/android/graphics/Color.java#L414">
-   *     Kitkat Color</a>
    */
+  // JellyBean Color:
+  // https://github.com/android/platform_frameworks_base/blob/jb-mr2-release/graphics/java/android/graphics/Color.java#L414
+  // KitKat Color:
+  // https://github.com/android/platform_frameworks_base/blob/kitkat-mr2.2-release/graphics/java/android/graphics/Color.java#L414
   @Test
   public void lime() throws IOException, SubtitleDecoderException {
     TtmlSubtitle subtitle = getSubtitle(INLINE_ATTRIBUTES_TTML_FILE);

library/smoothstreaming/src/main/java/com/google/android/exoplayer2/source/smoothstreaming/manifest/SsManifest.java

@@ -33,8 +33,8 @@
 /**
  * Represents a SmoothStreaming manifest.
  *
- * @see <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
- *     Streaming Client Manifest Format</a>
+ * <p>See the <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
+ * Streaming Client Manifest Format</a>
  */
 public class SsManifest implements FilterableManifest<SsManifest> {
 

library/smoothstreaming/src/main/java/com/google/android/exoplayer2/source/smoothstreaming/manifest/SsManifestParser.java

@@ -50,8 +50,8 @@
 /**
  * Parses SmoothStreaming client manifests.
  *
- * @see <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
- *     Streaming Client Manifest Format</a>
+ * <p>See the <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
+ * Streaming Client Manifest Format</a>
  */
 public class SsManifestParser implements ParsingLoadable.Parser<SsManifest> {
 

library/transformer/src/main/java/com/google/android/exoplayer2/transformer/MssimCalculator.java

@@ -23,7 +23,7 @@
  *
  * <p>MSSIM divides the image into windows, calculates SSIM of each, then returns the average.
  *
- * @see <a href=https://ece.uwaterloo.ca/~z70wang/publications/ssim.pdf>The SSIM paper</a>.
+ * <p>See <a href=https://ece.uwaterloo.ca/~z70wang/publications/ssim.pdf>the SSIM paper</a>.
  */
 /* package */ final class MssimCalculator {
   // Referred to as 'L' in the SSIM paper, this constant defines the maximum pixel values. The