From 224b0bf1ffe3d5ec0f61dd2df20c13c48d1644b4 Mon Sep 17 00:00:00 2001
From: Michael DiFebbo <medifebbo@rockbox.org>
Date: Wed, 3 May 2006 00:42:44 +0000
Subject: Improvements to the sections regarding the File Menu and the Playlist
 Submenu.  Restructured File Menu section to track actual Rockbox menu order. 
 Rewrote some portions of the Playlist Submenu section to make it more
 user-friendly.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9864 a1c6a512-1295-4272-9138-f99709370657
---
 manual/rockbox_interface/main.tex | 121 ++++++++++++++++++++++++++------------
 1 file changed, 85 insertions(+), 36 deletions(-)

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

diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index 0804c5590c..2dea78089d 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -9,7 +9,7 @@
 \end{center}
 
 Throughout this manual, the buttons on the \dap\ are labelled according to the
-picture above. To turn on and shutdown your \dap, the following keys are used:
+picture above. To turn on and shut down your \dap, the following keys are used:
 
 \begin{table}
     \begin{btnmap}{}{}
@@ -40,15 +40,23 @@ picture above. To turn on and shutdown your \dap, the following keys are used:
 
 \section{\label{ref:file_browser}File Browser}
 \screenshot{rockbox_interface/images/ss-file-browser}{The file browser}{}
-The file browser helps you navigate through the files on your \dap, entering
-folders and executing the default action on each file. To help us differentiate
-files, each file format is displayed with an icon. You can select which file
-types are displayed (see page \pageref{ref:ShowFiles}).
-\note{When Tag Cache is enabled you will access the Tag Cache browser instead
-  of the File Browser. With Tag Cache you will be able accessing your music 
-  using a database but won't be able doing any file manipulations.
-  Read more about Tag Cache in Section \ref{ref:tagcache}.
-}
+Rockbox lets you browse your music in either of two ways. The ``File Browser'' 
+lets you navigate through the files and folders on your \dap, entering folders
+and executing the default action on each file. To help differentiate files,
+each file format is displayed with an icon. 
+
+The ``Tag Cache Browser,'' on the other hand, allows you to navigate through 
+the music on your player using categories like album, artist, genre, etc.  
+
+You can select whether to browse using the File Browser or the Tag Cache Browser by
+adjusting the \setting{Show Files} setting.  If you choose the File Browser, the 
+\setting{Show Files} setting also lets you select what types of files you wish to 
+view.  See page \pageref{ref:ShowFiles} for more information on the \setting{Show 
+Files} setting.
+
+\note{The File Browser allows you to manipulate your files in ways that are not
+available within the Tag Cache Browser.  Read more about Tag Cache in Section 
+\ref{ref:tagcache}.  The remainder of this section deals with the File Browser.}
 
 \subsection{\label{ref:controls}Controls}
 \begin{table}
@@ -111,21 +119,27 @@ types are displayed (see page \pageref{ref:ShowFiles}).
 }
 
 \subsection{\label{ref:Filemenu}\label{ref:PartIISectionFM}File Menu}
-\screenshot{rockbox_interface/images/ss-file-menu}{The file menu}{}
+\screenshot{rockbox_interface/images/ss-file-menu}{The File Menu}{}
 
-This menu operates on the file that was selected in the browser. It offers the
-following options:
+The File Menu allows you to perform certain operations on files or folders.
+To access the File Menu, position the selector over a file or folder and 
+	\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}
+		{hold the \ButtonSelect\ button.}
+	\opt{RECORDER_PAD,PLAYER_PAD}{press the \ButtonPlay/\ButtonOn+\ButtonPlay\ 
+	  buttons.}
+  \opt{ONDIO_PAD}{hold the \ButtonRight\ button.}
+  
+\note{The File Menu is a context sensitive menu.  If the File Menu is 
+invoked on a file, it will display options available for files.  If the 
+File Menu is invoked on a folder or directory, it will display options
+for directories.}
+
+The File Menu contains the following options (unless otherwise noted, each
+option pertains both to files and directories):
 
 \begin{description}
-\item [Open with:] 
-  Runs a viewer plugin on the file. Normally the filetype of a file is detected
-  and the appropriate plugin is run automatically when you press play on it.
-  Use this menu if for some reason you want to override the default action and
-  select a viewer by hand.  See page \textmd{\pageref{ref:Viewersplugins}} for
-  more details on viewers. For example, this would be used to view a text file
-  with a non-standard extension, i.e. not ending with .txt.
 \item [Playlist:]
-  Change to the Playlist submenu (see below).
+  Enters to the Playlist Submenu (see below).
 \item [Rename:]
   This function lets the user modify a file name.
 \item [Cut:]
@@ -138,23 +152,38 @@ following options:
   Only visible if a file or directory name is on the clipboard. When selected
   it will move or copy the clipboard to the current directory.
 \item [Delete:]
-  Only files can be deleted, not folders. Rockbox will ask for confirmation
-  before deleting a file. Press PLAY to confirm deletion or any other key to
-  cancel.
+  Deletes the currently selected file.  This option applies only to files, and
+  not to directories.  Rockbox will ask for confirmation before deleting a file.
+  Press
+  	\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD,IPOD_VIDEO_PAD}
+      {\ButtonSelect}
+    \opt{PLAYER_PAD,RECORDER_PAD}{\ButtonPlay}
+    \opt{ONDIO_PAD}{\ButtonRight}
+ to confirm deletion or any other key to cancel.
 \item [Delete Directory:]
-  Deletes the folder pointed to by the cursor and all the files and folders
-  contained in it.  Use with caution.
+  Deletes the currently selected directory and all of the files and folders
+  contained in the selected directory.  Deleted directories cannot be recovered.
+  Use this feature with caution!
+\item [Open with:] 
+  Runs a viewer plugin on the file. Normally, when a file is selected in Rockbox,
+  Rockbox automatically detects the file type and runs the appropriate plugin.
+  The ``Open With'' function can be used to override the default action and
+  select a viewer by hand.  For example, this function can be used to view a text file
+  even if the file has a non-standard extension (i.e., the file has an extension
+  of something other than ``.txt'').  See page \textmd{\pageref{ref:Viewersplugins}} 
+  for more details on viewers.
 \item [Create Directory:]
   Makes a new folder in the current folder on the disk.
 \end{description}
 
 \subsection{\label{ref:Playlistsubmenu}Playlist Submenu}
-\screenshot{rockbox_interface/images/ss-playlist-menu}{The playlist menu}{}
-If the playlist submenu is invoked on a directory, it will act on all the files
-within that directory.  If invoked on a playlist it will act on all the files
-in that playlist. Otherwise it acts only on the current file.
-
-This menu provides the following options:
+\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
+The Playlist Submenu allows you to put tracks into a ``dynamic playlist''.
+If there is no music currently playing, Rockbox will create a new dynamic playlist
+and put the selected track(s) into the playlist.  If there is music currently playing,
+Rockbox will put the selected track(s) into the current playlist.  The place in which
+the newly selected tracks are added to the playlist is determined by the following
+options:
 
 \begin{description}
 \item [Insert:]
@@ -176,10 +205,30 @@ This menu provides the following options:
   Queue track(s) at end of playlist.
 \end{description}
 
-You can insert a track, directory or playlist even if nothing is currently
-playing. In this case, a new playlist is created with only the selected tracks
-and then play is started.\\
-\note{The dynamic playlist is saved so resume will restore it exactly as before shutdown.}
+The Playlist Submenu can be used to add either single tracks or entire directories
+to a playlist. If the Playlist Submenu is invoked on a single track, it will put 
+only that track into the playlist.  On the other hand, if the Playlist Submenu 
+is invoked on a directory, Rockbox adds all of the tracks in that directory to 
+the playlist.  
+
+\note{You can control whether or not Rockbox includes the contents of subdirectories
+when adding an entire directory to a playlists.   Set the \setting{Main Menu 
+$\rightarrow$ Playlist Options $\rightarrow$ Recusively Insert Directories} setting to 
+\setting{Yes} if you would like Rockbox to include tracks in subdirectories as well as tracks
+in the currently-selected directory.}
+
+If you want to have Rockbox create a playlist of a whole folder (to play an entire 
+album, for example), use the File Browser to select the song. When a single song is 
+selected from the File Browser, Rockbox will automatically create a playlist with all
+songs in the current folder. However, if you want to play only a single song and then
+stop, stop playback, navigate to the song you want to play, and use the \setting{Playlist
+$\rightarrow$ Insert} function to select the song.
+
+Dynamic playlists are saved so resume will restore them exactly as they were before
+shutdown.
+
+\note{To view, save or reshuffle the current dynamic playlist, use the 
+\setting{Playlist Options} setting in the WPS Context Menu.}
 
 \subsection{Virtual Keyboard}
 \screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{}
-- 
cgit v1.2.3

