Index: manual/working_with_playlists/main.tex
===================================================================
--- manual/working_with_playlists/main.tex (revision 14604)
+++ manual/working_with_playlists/main.tex (working copy)
@@ -151,7 +151,7 @@
the track to be moved and confirm with \ActionStdOk. To remove a track, simply
select \setting{Remove} in the context menu.
-\subsection{Saving playlists}
+\subsection{\label{ref:saving_playlists}Saving playlists}
To save the current playlist either enter the \setting{Playlist} submenu
in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and
select \setting{Save Current Playlist} or enter the
Index: manual/rockbox_interface/main.tex
===================================================================
--- manual/rockbox_interface/main.tex (revision 14604)
+++ manual/rockbox_interface/main.tex (working copy)
@@ -12,11 +12,9 @@
\end{center}
-Throughout this manual, the buttons on the \dap{} are labelled according to the
-picture above. When a table of button actions says ``Long'' before the button it
-means that you should make a long press on that button, in other words, press it
-for approximately 1 second. In detail the buttons are described in the following
-paragraph.
+This manual refers to the buttons using the names shown in the picture
+above. When a button name is preceded by``Long'' it means that you
+should press it for approximately 1 second.
\blind{
Additional information is available for blind users on the Rockbox website at
@@ -342,72 +340,144 @@
}
}
-\subsection{The first contact}
+\subsection{Loading music onto the \dap{}}
-After you have first started the \dap{} you'll be presented by the
-\setting{Main Menu}. From this menu you can reach every function of Rockbox,
-for more information (see \reference{ref:main_menu}). To browse the files
-on you \dap{} select \setting{Files} (see \reference{ref:file_browser}), and to
-browse in a view that is based on the meta-data\footnote{ID3 Tags, Vorbis
-comments, etc.} of your audio files, select \setting{Database} (see
-\reference{ref:database}).
+To copy music to your \dap{} you have to boot the
+manufacturer's firmware as described in \reference{ref:Dualboot} (as
+Rockbox does not currently have a USB driver). Rockbox plays many
+formats including mp3, aac, flac and ogg (REF??). You can put the files
+anywhere you like. For example you could make a top level folder
+called "Tunes" and inside that have a folder for each artist, then
+inside those a folder for each album which contains all the files for
+that album. Finally unplug your player and reboot
+to get back to Rockbox.
-\subsection{Basic controls}
-When browsing files and moving through menus you usually get a list view
-presented. The navigation in these lists are usually the same and should be
-pretty intuitive.
-In the tree view use \ActionStdNext{} and \ActionStdPrev{} to move around
-the selection. Use \ActionStdOk{} to select an item. When browsing the file
-system selecting an audio file plays it. The view switches to the ``While
-playing screen'', usually abbreviated as ``WPS'' (see \reference{ref:WPS}. The
-dynamic playlist gets replaced with the contents of the current folder. This
-way you can easily treat folders as playlists. The created dynamic playlist can
-be extended or modified while playing. This is also known as
-``on-the-fly playlist''.
-To go back to the \setting{File Browser} stop the playback with the
-\ActionWpsStop{} button or return to the file browser while keeping playback
-running using \ActionWpsBrowse{}.
-In list views you can go back one step with \ActionTreeParentDirectory.
+\opt{h10,h10_5gb}{\note{
+If your \dap{} is a MTP model, the Music folder where all your music is stored
+may be hidden in the \setting{File Browser}. This may be fixed by either
+either changing it's properties (on a computer) to not hidden, or by changing
+the \setting{Show Files} setting to all (\reference{ref:ShowFiles}).
+}}
-\subsection{Basic concepts}
-\subsubsection{Playlists}
-Rockbox is playlist oriented. This means that every time you play an audio file,
-a so-called ``dynamic playlist'' is generated, unless you play a saved
-playlist. You can modify the dynamic playlist while playing and also save
-it to a file. If you don't want to use playlists you can simply play your
-files folder based.
-Playlists are covered in detail in \reference{ref:working_with_playlists}.
+\opt{e200}{\note{
+The \playerman{} firmware always sets the \fname{/MUSIC} folder
+to hidden. To see this folder you have to change the \setting{Show Files}
+setting to all (\reference{ref:ShowFiles}).
+}}
-\subsubsection{Menu}
-From the menu you can customise Rockbox. Rockbox itself is very customisable.
-Also there are some special menus for quick access to frequently used
-functions.
-\subsubsection{Context Menu}
-Some views, especially the file browser and the WPS have a context menu.
-From the file browser this can be accessed with \ActionStdContext{}.
-The contents of the context menu vary, depending on the situation it gets
-called. The context menu itself presents you with some operations you can
-perform with the currently highlighted file. In the file browser this is
-the file (or folder) that is highlighted by the cursor. From the WPS this is
-the currently playing file. Also there are some actions that don't apply
-to the current file but refer to the screen from which the context menu
-gets called. One example is the playback menu, which can be called using
-the context menu from within the WPS.
+\subsection{A quick tour}
-\section{Customising Rockbox}
-Rockbox' User Interface can be customised using ``Themes''. Themes usually
-only affect the visual appearance, but an advanced user can create a theme
-that also changes various other settings like file view, LCD settings and
-all other settings that can be modified using \fname{.cfg} files. This topic
-is discussed in more detail in \reference{ref:manage_settings}.
-The Rockbox distribution comes with some themes that should look nice on
-your \dap{}. \note{Some of the themes shipped with Rockbox need additional
-fonts from the fonts package, so make sure you installed them.
-Also, if you downloaded additional themes from the Internet make sure you
-have the needed fonts installed as otherwise the theme may get displayed
-garbled.}
+\subsubsection{Main Menu and File Browser}
+The first screen you will see is the \setting{Main Menu}. Move through
+the items on the menu using \ActionStdNext{} and \ActionStdPrev{}. Then
+use \ActionStdOk{} to select an item. The simplest way to play a file
+is to use the \setting{File Browser} by selecting \setting{Files} in the
+\setting{Main Menu}, then use \ActionStdOk{} to enter a folder
+(\ActionTreeParentDirectory{} goes back to the previous folder or menu). When
+you have found the file you want to play, use \ActionStdOk{} to play it.
+\subsubsection{WPS}
+Once you have selected a file for playing the view switches to the
+``While playing screen'' (``WPS'') showing information about the file
+and your \dap{}. Use \ActionWpsVolUp{} / \ActionWpsVolDown{} to adjust
+the volume and \ActionWpsPlay{} to toggle pause. To go back to the
+\setting{File Browser} use \ActionWpsBrowse{} (\ActionWpsStop{} does
+the same but also stops playback). Return to the WPS using
+\ActionTreeWps{} or by selecting \setting{Now Playing} from the
+\setting{Main Menu}.
+
+\subsubsection{Themes}
+Rockbox's default WPS is not very pretty but can be changed easily.
+Use \ActionStdMenu{} to get back to the \setting{Main Menu}
+and then select \setting{Settings} then \setting{Browse Themes}.
+Choose a theme and then use \ActionTreeWps{} to return to the
+WPS. There are many more themes on the Internet. \note{Some of the
+themes shipped with Rockbox need additional fonts from the fonts
+package, so make sure you installed them.}
+
+\subsubsection{Playlists and Context Menus}
+After the file you first selected has finished playing, Rockbox will start
+playing the next file in the folder. This happens because when you
+select a file to play Rockbox creates a playlist containing all the
+files in the folder (called a dynamic playlist). To see the current
+playlist go to the \setting{Main Menu} and then select
+\setting{Playlists} then \setting{View Current Playlist}. The
+playlist can be edited from here. For instance, to remove a song
+move down to it and then use \ActionStdContext{} to access the
+\setting{Context Menu} and then select \setting{Remove}.
+
+\note{
+A \emph{context menu} is a menu containing actions that relate to
+the highlighted item. So, for an item in a playlist the \setting{Context Menu}
+has Remove, Move etc., whereas for a file the \setting{Context Menu} has
+Rename, Cut, Paste, Delete etc.
+}
+\note{
+The WPS also has a context menu (also accessed with \ActionStdContext{})
+which contains shortcuts to frequently
+used functions, such as \setting{Sound Settings} (Bass, Treble, EQ etc.)
+and \setting{Playlist} functions.
+}
+
+You can add songs to the Current Playlist in many ways. For instance,
+to add all the files in a folder you can highlight the folder in the
+\setting{File Browser}, use \ActionStdContext{} to access the
+\setting{Context Menu} then \setting{Playlist} and \setting{Insert
+last}. If you do this while the the \dap{} is playing, the files will
+be added onto the end of the dynamic playlist. However, if the \dap{}
+is stopped, the new files will replace the dynamic playlist. The
+current playlist can also be saved and loaded again later see
+\reference{ref:saving_playlists}.
+
+\subsubsection{Database}
+Although you can select music using only the \setting{File Browser},
+you can also browse by categories such as Artist,
+Album and Title. To access the categories select \setting{Database} from
+the \setting{Main Menu}. The first time you do this Rockbox
+will scan your disk for audio files (which can take some time). After
+the scan is finished you may be prompted to restart your \dap{} before
+you can use the database (see \reference{ref:database}).
+
+\subsubsection{Other features}
+
+Rockbox has many other features, a few are:
+
+\begin{itemize}
+\item Playlists can be played shuffled. The quickest way to turn shuffling
+on is to access the \setting{Quick Menu} using \ActionStdQuickScreen{} from
+the WPS, File or Database Browser (\reference{ref:quick_menu}).
+
+\item There are many games and applications. These are called Rockbox
+``Plugins''. They can be accessed by selecting
+\setting{Plugins} from the \setting{Main Menu} (\reference{ref:plugins}).
+
+\item There is a Sleep timer, from the \setting{Main Menu} select
+\setting{System} then \setting{Sleep Timer}.
+
+\item Playlists saved in the \fname{/PLAYLISTS} folder can be loaded
+quickly using the \setting{Playlist Catalog} menu which can be accessed
+from the \setting{Playlists} menu or the WPS context menu
+(\reference{ref:playlist_catalog}).
+
+\item Settings can be saved and restored, highlight \setting{Settings}
+in the \setting{Main Menu} and use \ActionStdContext{} to access the
+\setting{Context Menu}. The settings files are simple text files
+and can be edited to include only the particular settings you
+need. For instance you could have a settings file for night use
+called \fname{night.cfg} containing just:
+
+\begin{example}
+ # volume: -45
+ # invert: on
+ # brightness: 1
+\end{example}
+
+Which lowers the volume and sets the LCD for comfortable night viewing.
+See \reference{ref:manage_settings} for more on using \fname{.cfg} files.
+
+\end{itemize}
+
\section{Menu overview}
\fixme{include an overview of the menu structure here}
%\input{rockbox_interface/menu_structure.tex}
Index: manual/main_menu/main.tex
===================================================================
--- manual/main_menu/main.tex (revision 14604)
+++ manual/main_menu/main.tex (working copy)
@@ -219,7 +219,7 @@
\nopt{PLAYER_PAD,ONDIO_PAD}
{
-\section{Quick Menu}
+\section{\label{ref:quick_menu}Quick Menu}
Whilst not strictly part of the \setting{Main Menu}, it is worth noting that
a few of the more commonly used settings are available from the
\setting{Quick Menu}.