From 28c5043dc113cc5e47fb6e9cedc08ce979fc58e5 Mon Sep 17 00:00:00 2001
From: Pierre-Hugues Husson <pierre-hugues.husson@softathome.com>
Date: Tue, 18 Feb 2020 13:45:14 +0100
Subject: [PATCH] Comment SectionPassthrough

---
 .../extractor/ts/DefaultTsPayloadReaderFactory.java      | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/ts/DefaultTsPayloadReaderFactory.java b/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/ts/DefaultTsPayloadReaderFactory.java
index 2c8db491b6..7ca35bea71 100644
--- a/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/ts/DefaultTsPayloadReaderFactory.java
+++ b/library/extractor/src/main/java/com/google/android/exoplayer2/extractor/ts/DefaultTsPayloadReaderFactory.java
@@ -190,6 +190,15 @@ public final class DefaultTsPayloadReaderFactory implements TsPayloadReader.Fact
     }
   }
 
+  /*
+   * This is a special Section Reader that blindly forwards the sections to the decoder
+   * There are many simple DVB-SI features that have their own dedicated track, and thus doesn't need
+   * additional pre-processing before actual decoding.
+   * Examples of such simple packets:
+   * - TDT/TOT (current time)
+   * - EIT (Name of the current and future programs)
+   * - AIT (used for interactive web browser on top of the broadcast)
+   */
   public class SectionPassthrough implements SectionPayloadReader {
     private TimestampAdjuster timestampAdjuster = null;
     private final String mimeType;