From 06cf5111885204b39686d7601c4815f92b5c7c70 Mon Sep 17 00:00:00 2001
From: Profpatsch <mail@profpatsch.de>
Date: Wed, 1 Jan 2025 14:28:37 +0100
Subject: [PATCH] PlayerHolder: improve interface docstrings

---
 .../org/schabi/newpipe/player/helper/PlayerHolder.java    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/app/src/main/java/org/schabi/newpipe/player/helper/PlayerHolder.java b/app/src/main/java/org/schabi/newpipe/player/helper/PlayerHolder.java
index 331ea71c0..22540a138 100644
--- a/app/src/main/java/org/schabi/newpipe/player/helper/PlayerHolder.java
+++ b/app/src/main/java/org/schabi/newpipe/player/helper/PlayerHolder.java
@@ -120,6 +120,14 @@ public final class PlayerHolder {
         return App.getInstance();
     }
 
+    /**
+     * Connect to (and if needed start) the {@link PlayerService}
+     * and bind {@link PlayerServiceConnection} to it.
+     * If the service is already started, only set the listener.
+     * @param playAfterConnect If this holder’s service was already started,
+     *                         start playing immediately
+     * @param newListener set this listener
+     * */
     public void startService(final boolean playAfterConnect,
                              final PlayerServiceExtendedEventListener newListener) {
         if (DEBUG) {