Here is a patch with a bit more doc.
I think it describes it reasonably well.
Thank you.
Envoyé avec la messagerie sécurisée [Proton Mail.](https://proton.me/mail/home)
Le lundi 16 décembre 2024 à 9:59 PM, Erica Qi via <emms-help@gnu.org> a écrit :
>
From 58072aaad4e396bae5c640146ba592ec2e4d98e5 Mon Sep 17 00:00:00 2001
From: EricaLinaQi <ericalin...@proton.me>
Date: Tue, 17 Dec 2024 16:38:24 +0000
Subject: [PATCH] Better doc for playlist queue locking.
---
doc/emms.texinfo | 10 ++++++++--
emms.el | 9 +++++----
2 files changed, 13 insertions(+), 6 deletions(-)
diff --git a/doc/emms.texinfo b/doc/emms.texinfo
index d650338..c8ab359 100644
--- a/doc/emms.texinfo
+++ b/doc/emms.texinfo
@@ -522,6 +522,12 @@ the playlist but do not start playing it immediately. Conversely, the
commands with the ``emms-play-'' prefix begin playing the track
immediately.
+This creates the active playlist and queue as needed. The active queue will automatically switch to any playlists that are browsed to such that the next song played will come from the currently viewed playlist.
+
+Locking the active playlist queue to its playlist will prevent it from changing, allowing for browsing other playlists and sending songs to the current active playlist from them.
+
+Locking the queue to its playlist allows for live creation of a curated playlist by browsing other playlists as well as the music database and files.
+
@defun emms-play-file file
A source for a single file - either @var{file}, or queried from the
user. If called with a prefix the file will be added like
@@ -600,11 +606,11 @@ Sort the current playlist. This uses
@var{emms-playlist-sort-function}.
@end defun
@defun emms-lock-queue
-Lock the current active playlist to its playlist.
+Lock the current active playlist queue to its playlist.
@var{emms-playlist-sort-function}.
@end defun
@defun emms-unlock-queue
-Unlock the current active playlist from its playlist.
+Unlock the current active playlist queue from its playlist.
@var{emms-playlist-sort-function}.
@end defun
@defun emms-show &optional insertp
diff --git a/emms.el b/emms.el
index ad6e985..ebd0b88 100644
--- a/emms.el
+++ b/emms.el
@@ -840,16 +840,17 @@ for that purpose.")
(error "Not an EMMS playlist buffer")))
(defun emms-lock-queue ()
- "Lock the current active playlist."
+ "Lock the current active playlist queue to it's playlist.
+This allows for uninterrupted playlist playback while browsing other playlists."
(interactive)
(setq emms-queue-lock (buffer-name emms-playlist-buffer))
- (message (concat "Active queue playlist is locked to " emms-queue-lock)))
+ (message (concat "Active playlist queue is locked to " emms-queue-lock)))
(defun emms-unlock-queue ()
- "Unlock the current active playlist."
+ "Unlock the current active playlist queue from its playlist."
(interactive)
(setq emms-queue-lock nil)
- (message "Active queue playlist is unlocked."))
+ (message "Active playlist queue is unlocked."))
(defun emms-playlist-set-playlist-buffer (&optional buffer)
"Set the current playlist buffer if the queue is not locked to it's playlist."
--
2.47.0
