From d3125d0e90ad1d95be79fc01b4acf6b13b62af24 Mon Sep 17 00:00:00 2001
From: olly <olly@google.com>
Date: Wed, 21 Jul 2021 18:56:20 +0100
Subject: [PATCH] Cleanup some RTSP documentation

#minor-release

PiperOrigin-RevId: 386048024
---
 .../_page_fragments/supported-formats-rtsp.md | 20 ++++++++++---------
 docs/rtsp.md                                  | 13 +++++-------
 2 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/docs/_page_fragments/supported-formats-rtsp.md b/docs/_page_fragments/supported-formats-rtsp.md
index f6f1481c82..36a3d0351f 100644
--- a/docs/_page_fragments/supported-formats-rtsp.md
+++ b/docs/_page_fragments/supported-formats-rtsp.md
@@ -1,16 +1,18 @@
-ExoPlayer supports both live and on demand RTSP. Supported formats and network
-types are listed below.
+ExoPlayer supports both live and on demand RTSP. Supported sample formats and
+network types are listed below.
 
-**Supported formats**
-> Please comment on
-[this issue](https://github.com/google/ExoPlayer/issues/9210) to request for
-more format support.
+### Supported sample formats ###
 
-* H264. The SDP media description must include SPS/PPS data in the fmtp
-  attribute for decoder initialization.
+* H264 (the SDP media description must include SPS/PPS data in the fmtp
+  attribute for decoder initialization).
 * AAC (with ADTS bitstream).
 * AC3.
 
-**Supported network types**
+Please comment on [this issue](https://github.com/google/ExoPlayer/issues/9210)
+to request support for additional sample formats.
+{:.info}
+
+### Supported network types ###
+
 * RTP over UDP unicast (multicast is not supported).
 * Interleaved RTSP, RTP over RTSP using TCP.
diff --git a/docs/rtsp.md b/docs/rtsp.md
index b2d041e525..9c56cc9614 100644
--- a/docs/rtsp.md
+++ b/docs/rtsp.md
@@ -25,12 +25,11 @@ player.prepare();
 ~~~
 {: .language-java}
 
-
-### Play authentication-enabled RTSP content ###
+### Authentication ###
 
 ExoPlayer supports playback with RTSP BASIC and DIGEST authentication. To play
 protected RTSP content, the `MediaItem`'s URI must be configured with the
-authtication info. Specifically, the URI should follow the format
+authentication info. Specifically, the URI should be of the form
 `rtsp://<username>:<password>@<host address>`.
 
 ## Using RtspMediaSource ##
@@ -73,8 +72,6 @@ ExoPlayer will report the playback has ended if nothing is received for the
 duration of the set timeout. Setting this value too small may lead to an early
 end-of-stream signal under poor network conditions.
 
-### Force using RTP/TCP ###
-ExoPlayer can also be configured to play with RTP/TCP by default. To do so,
-use method `RtspMediaSource.Factory.setForceUseRtpTcp()`.
-
-
+RTP/TCP offers better compatibility under some network setups. You can configure
+ExoPlayer to use RTP/TCP by default with
+`RtspMediaSource.Factory.setForceUseRtpTcp()`.