From cdf99f8564e7d938ea4d56b604e49f3c2d2afb73 Mon Sep 17 00:00:00 2001
From: Christian Soffke <christian.soffke@gmail.com>
Date: Wed, 17 Mar 2021 12:27:57 +0100
Subject: Manual: update description of Current Playlist menu options

- note that availability of options depends on player state
- present options that only insert tracks separately from those that also remove tracks
- add short intro for the latter.

Change-Id: Ie99ef7dff77da0cb136c761da1c11f83936f86f5
---
 manual/working_with_playlists/main.tex | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

(limited to 'manual/working_with_playlists/main.tex')

diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index 4a8a0174ab..9d7bcd5336 100644
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -80,7 +80,7 @@ To create a playlist containing some or all of the music on your \dap{}, you can
 The \setting{Current Playlist Submenu} is a submenu in the \setting{Context Menu} (see
 \reference{ref:Contextmenu}), it allows you to put tracks into a
 ``dynamic playlist''. The place in which the newly
-selected tracks are added to the playlist is determined by the following
+selected tracks are added to the playlist is determined by these
 options:
 
 \begin{description}
@@ -94,15 +94,23 @@ have not been added yet, immediately after the currently playing track.
 \item [Insert Shuffled.] Add track(s) to the playlist at random positions.
 
 \item [Insert Last Shuffled.] Add tracks in a random order to the end of the playlist.
+\end{description}
+
+If you want the existing playlist entries to first be removed before
+selected tracks are inserted, the following two options will achieve that effect.
+They are also available when playback is stopped, whereas the rest of the options
+require music to be playing or paused.
 
-\item [Clear List \& Play Next.] Replace all tracks in the dynamic playlist.
-If a track is currently playing, it is only removed once it’s finished playing.
+\begin{description}
+\item [Clear List \& Play Next.] Replace all entries in the dynamic playlist with
+selected tracks. If a track is currently playing, it will be removed once it’s
+finished playing.
 
-\item [Clear List \& Play Shuffled.] Replace dynamic playlist with selected tracks
-in random order. Available, if playback is stopped.
+\item [Clear List \& Play Shuffled.] Similar, except tracks are added in random order.
+Only available when playback is stopped.
 \end{description}
 
-There are also options for adding tracks only temporarily to the dynamic playlist.
+Another possibility is to add tracks \emph{temporarily} to the dynamic playlist.
 In Rockbox’s parlance, this is called queuing. Queued tracks are automatically
 removed from the playlist after they have been played. They are also not saved
 to the playlist file (see \reference{ref:playlistoptions}).
-- 
cgit v1.2.3

