From 043e8a0c5ca704f7a9bfa75e9b602d5b154f1bbd Mon Sep 17 00:00:00 2001
From: Christian Soffke <christian.soffke@gmail.com>
Date: Thu, 11 Mar 2021 19:39:32 +0100
Subject: Manual: Updates to Playlist Catalogue menu

Keeping in sync with how Rockbox currently works:
- Context menu doesn't include an option to "View Catalogue" anymore
- What used to be the "Playlists" menu is now the context menu of the "Playlist Catalogue"
- Context menu includes an option to "Reset Playlist Catalogue Directory"

Also updated info regarding the "Create Playlist" option.

Change-Id: I717bab9d26a9a08fb95083b67a779541e00a0fd3
---
 manual/main_menu/main.tex        | 34 ++++++++++++++++++++--------------
 manual/rockbox_interface/wps.tex |  2 --
 2 files changed, 20 insertions(+), 16 deletions(-)

(limited to 'manual')

diff --git a/manual/main_menu/main.tex b/manual/main_menu/main.tex
index 31d1589182..7a83c61935 100644
--- a/manual/main_menu/main.tex
+++ b/manual/main_menu/main.tex
@@ -154,38 +154,44 @@ The details of this menu are covered in
 
 \opt{radio}{\input{main_menu/fmradio.tex}}
 
-\section{\label{ref:playlistoptions}Playlists}
-  This menu allows you to work with playlists. Playlists can be created in 
+\section{\label{ref:playlistoptions}Playlist Catalogue}
+  This menu provides a simple interface to maintain
+  several playlists (see \reference{ref:working_with_playlists}). Playlists can be created in
   three ways. Playing a file in a directory causes all the files in it
   to be placed in a playlist. Playlists can be created manually by
   either using the  \setting{Context Menu} (see \reference{ref:Contextmenu}) or using
   the \setting{Playlist} menu. Both automatically and manually created
   playlists can be edited using this menu.
 
+\subsection{The Playlist Catalogue Context Menu}
+
 \begin{description}
 \item[Create Playlist:]
-  Rockbox will create a playlist with all tracks in the current directory 
-and all sub-directories. The playlist will be created one directory level ``up'' 
-from where you currently are.
-  
+  Rockbox will create a playlist with all tracks from the directory that is
+currently selected in the \setting{File Browser}, including
+all of its sub-directories. If you have selected the root level or your Playlist Catalogue directory,
+Rockbox will instead create a playlist with all tracks from all directories. The playlist
+will be saved in the Playlist Catalogue directory.
+
 \item[View Current Playlist:]
-  Displays the contents of the playlist currently stored in memory.
-  
+  Displays the contents of the current dynamic playlist.
+
 \item[Save Current Playlist:]
-  Saves the current dynamic playlist, excluding queued tracks, to the 
-specified file. If no path is provided then playlist is saved to the current 
+  Saves the current dynamic playlist, excluding queued tracks, to the
+specified file. If no path is provided then playlist is saved to the current
 directory.
 
-\item[View Catalogue:]
-  Provides a simple interface to maintain
-  several playlists (see \reference{ref:working_with_playlists}).
+\item[Reset Playlist Catalogue Directory:]
+  Will reset the default location for playlists to the \fname{/Playlists}
+directory. Playlists stored in other locations are not included in the catalogue.
+
 \end{description}
 
 \section{Plugins}
   With this option you can load and run various plugins that have been
 written for Rockbox. There are a wide variety of these supplied with
 Rockbox, including several games, some impressive demos and a number of
-utilities. A detailed description of the different plugins is to be found in 
+utilities. A detailed description of the different plugins is to be found in
 \reference{ref:plugins}.
 
 \section{\label{ref:Info}System}
diff --git a/manual/rockbox_interface/wps.tex b/manual/rockbox_interface/wps.tex
index e20ed6737d..d52893f55b 100644
--- a/manual/rockbox_interface/wps.tex
+++ b/manual/rockbox_interface/wps.tex
@@ -198,8 +198,6 @@ menu, you can find the \setting{Playlist Viewer Settings}.
 
 \subsubsection{Playlist catalogue}
   \begin{description}
-    \item [View catalogue.] This lists all playlists that are part of the
-    Playlist catalogue. You can load a new playlist directly from this list.
     \item [Add to playlist.] Adds the currently playing file to a playlist.
     Select the playlist you want the file to be added to and it will get
     appended to that playlist.
-- 
cgit v1.2.3