From aec6db77faba617dc2ab225b72c9bc3350c5b5c3 Mon Sep 17 00:00:00 2001
From: ibaker <ibaker@google.com>
Date: Wed, 18 Oct 2023 10:15:11 -0700
Subject: [PATCH] Add formatting to `scheme` list in `DefaultDataSource`
 javadoc

The current formatting makes the 'scheme' part of the list blend into
the definition, especially when the definition is multi-line.

https://developer.android.com/reference/androidx/media3/datasource/DefaultDataSource

I considered adding another level of nesting, but I think bold will
help distinguish the structure of the list without adding too much HTML
or visual whitespace.

#minor-release

PiperOrigin-RevId: 574514208
---
 .../media3/datasource/DefaultDataSource.java  | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/libraries/datasource/src/main/java/androidx/media3/datasource/DefaultDataSource.java b/libraries/datasource/src/main/java/androidx/media3/datasource/DefaultDataSource.java
index 83de6a66e2..379a77fbc8 100644
--- a/libraries/datasource/src/main/java/androidx/media3/datasource/DefaultDataSource.java
+++ b/libraries/datasource/src/main/java/androidx/media3/datasource/DefaultDataSource.java
@@ -34,24 +34,24 @@ import java.util.Map;
  * A {@link DataSource} that supports multiple URI schemes. The supported schemes are:
  *
  * <ul>
- *   <li>{@code file}: For fetching data from a local file (e.g. {@code
+ *   <li><b>{@code file}</b>: For fetching data from a local file (e.g. {@code
  *       file:///path/to/media/media.mp4}, or just {@code /path/to/media/media.mp4} because the
  *       implementation assumes that a URI without a scheme is a local file URI).
- *   <li>{@code asset}: For fetching data from an asset in the application's APK (e.g. {@code
+ *   <li><b>{@code asset}</b>: For fetching data from an asset in the application's APK (e.g. {@code
  *       asset:///media.mp4}).
- *   <li>{@code rawresource}: For fetching data from a raw resource in the application's APK (e.g.
- *       {@code rawresource:///resourceId}, where {@code rawResourceId} is the integer identifier of
- *       the raw resource).
- *   <li>{@code android.resource}: For fetching data in the application's APK (e.g. {@code
+ *   <li><b>{@code rawresource}</b>: For fetching data from a raw resource in the application's APK
+ *       (e.g. {@code rawresource:///resourceId}, where {@code rawResourceId} is the integer
+ *       identifier of the raw resource).
+ *   <li><b>{@code android.resource}</b>: For fetching data in the application's APK (e.g. {@code
  *       android.resource:///resourceId} or {@code android.resource://resourceType/resourceName}).
  *       See {@link RawResourceDataSource} for more information about the URI form.
- *   <li>{@code content}: For fetching data from a content URI (e.g. {@code
+ *   <li><b>{@code content}</b>: For fetching data from a content URI (e.g. {@code
  *       content://authority/path/123}).
- *   <li>{@code rtmp}: For fetching data over RTMP. Only supported if the project using ExoPlayer
- *       has an explicit dependency on ExoPlayer's RTMP extension.
- *   <li>{@code data}: For parsing data inlined in the URI as defined in RFC 2397.
- *   <li>{@code udp}: For fetching data over UDP (e.g. {@code udp://something.com/media}).
- *   <li>{@code http(s)}: For fetching data over HTTP and HTTPS (e.g. {@code
+ *   <li><b>{@code rtmp}</b>: For fetching data over RTMP. Only supported if the project using
+ *       ExoPlayer has an explicit dependency on ExoPlayer's RTMP extension.
+ *   <li><b>{@code data}</b>: For parsing data inlined in the URI as defined in RFC 2397.
+ *   <li><b>{@code udp}</b>: For fetching data over UDP (e.g. {@code udp://something.com/media}).
+ *   <li><b>{@code http(s)}</b>: For fetching data over HTTP and HTTPS (e.g. {@code
  *       https://www.something.com/media.mp4}), if constructed using {@link
  *       #DefaultDataSource(Context, String, boolean)}, or any other schemes supported by a base
  *       data source if constructed using {@link #DefaultDataSource(Context, DataSource)}.