summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNils Wallménius <nils@rockbox.org>2006-10-13 16:19:30 +0000
committerNils Wallménius <nils@rockbox.org>2006-10-13 16:19:30 +0000
commit2239bbab047d294cce7b9f44db19a77a3ab4dc0d (patch)
treeb8db7d800f70c822ad091dae6e966c4063fa4045
parent1c3d89c35ea711a2347ebdce65d7e3a0e870367e (diff)
downloadrockbox-2239bbab047d294cce7b9f44db19a77a3ab4dc0d.tar.gz
rockbox-2239bbab047d294cce7b9f44db19a77a3ab4dc0d.zip
Added instructions on how to save a playlist in the new working with playlists section and made some minor cleanup (removed trailing spaces and tabs, broke long lines etc.) fixed a reference in the quickstart.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11215 a1c6a512-1295-4272-9138-f99709370657
-rw-r--r--manual/rockbox_interface/main.tex4
-rw-r--r--manual/rockbox_interface/playback.tex2
-rwxr-xr-xmanual/working_with_playlists/main.tex136
3 files changed, 75 insertions, 67 deletions
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index bd4bca22ef..ccc1940e65 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -183,11 +183,11 @@ stopped, so this is not and will not be possible.
\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
+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 \ref{ref:working_with_playlists}.
+Playlists are covered in detail in \reference{ref:working_with_playlists}.
\subsubsection{Menu}
From the menu you can customise Rockbox. Rockbox itself is very customisable.
diff --git a/manual/rockbox_interface/playback.tex b/manual/rockbox_interface/playback.tex
index cc54da0853..57c023a0ca 100644
--- a/manual/rockbox_interface/playback.tex
+++ b/manual/rockbox_interface/playback.tex
@@ -188,7 +188,7 @@ 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}
+\subsection{\label{sec:virtual_keyboard}Virtual Keyboard}
\screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{}
This is the virtual keyboard that is used when entering file names in Rockbox.
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index 45579ec275..fdc94eff1f 100755
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -1,52 +1,52 @@
-\section{Working with Playlists}
-\fixme{This section is currently in a half written state, with possible errors
- and a lot of stuff missing. Please help us fix this chapter by submitting
+\section{\label{ref:working_with_playlists}Working with Playlists}
+\fixme{This section is currently in a half written state, with possible errors
+ and a lot of stuff missing. Please help us fix this chapter by submitting
additions/corrections to the tracker}
\subsection{Playlist terminology}
-Some common terms that are used in Rockbox when referring to
+Some common terms that are used in Rockbox when referring to
playlists:
\begin{description}
-\item[Directory.] A playlist! One of the keys to getting the most out of
- Rockbox is understanding that Rockbox \emph{always} considers the song that
- it is playing to be part of a playlist, and in some situations, Rockbox will
- create a playlist automatically. For example, if you are playing the
- contents of a directory, Rockbox will automatically create a playlist
- containing the songs in that directory. This means that just about anything
- that is described in this chapter with respect to playlists also applies to
+\item[Directory.] A playlist! One of the keys to getting the most out of
+ Rockbox is understanding that Rockbox \emph{always} considers the song that
+ it is playing to be part of a playlist, and in some situations, Rockbox will
+ create a playlist automatically. For example, if you are playing the
+ contents of a directory, Rockbox will automatically create a playlist
+ containing the songs in that directory. This means that just about anything
+ that is described in this chapter with respect to playlists also applies to
directories.
-
-\item[Dynamic playlist.] A dynamic playlist is a playlist that is created
- ``On the fly.'' Any time you insert or queue tracks using the
- \setting{Playlist submenu} (see \reference{playlist_submenu}), you are
+
+\item[Dynamic playlist.] A dynamic playlist is a playlist that is created
+ ``On the fly.'' Any time you insert or queue tracks using the
+ \setting{Playlist submenu} (see \reference{playlist_submenu}), you are
creating (or adding to) a dynamic playlist.
-
-\item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means
- putting an item into a playlist and leaving it there, even after it is
- played. As you will see later in this chapter, Rockbox can \setting{Insert}
+
+\item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means
+ putting an item into a playlist and leaving it there, even after it is
+ played. As you will see later in this chapter, Rockbox can \setting{Insert}
into a playlist in several places.
-
-\item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song
- into a playlist and then to remove the song from the playlist once it has
- been played. The only difference between \setting{Insert} and
- \setting{Queue} is that the \setting{Queue} option removes the song from the
+
+\item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song
+ into a playlist and then to remove the song from the playlist once it has
+ been played. The only difference between \setting{Insert} and
+ \setting{Queue} is that the \setting{Queue} option removes the song from the
playlist once it has been played, and the \setting{Insert} option does not.
-\end{description}
+\end{description}
\subsection{Creating playlists}
-Rockbox can create playlists in four different ways.
+Rockbox can create playlists in four different ways.
\subsubsection{By playing a song}
-
-Whenever a song is selected from the \setting{File Browser} using the
-\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect} button, Rockbox will automatically create a playlist
-containing all of the songs in the directory in which that song is located.
-
-\note{If you already have already created a dynamic playlist, playing a new
- song will \emph{erase} the current playlist and create a new one. If you
- want to add a song to the current playlist rather than erasing the current
+Whenever a song is selected from the \setting{File Browser} using the
+\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect} button, Rockbox will
+automatically create a playlist containing all of the songs in the directory
+in which that song is located.
+
+\note{If you already have already created a dynamic playlist, playing a new
+ song will \emph{erase} the current playlist and create a new one. If you
+ want to add a song to the current playlist rather than erasing the current
playlist, see the section below on ``Adding music to playlists.''}
\subsubsection{By using Insert and Queue functions}
@@ -57,56 +57,64 @@ containing all of the songs in the directory in which that song is located.
\subsection{Adding music to playlists}
-\subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist}
-\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
-The \setting{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
+\subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist}
+\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
+The \setting{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.] Add track(s) to playlist. If no other tracks have been
- inserted then the selected track will be added immediately after current
- playing track, otherwise they will be added to end of insertion list.
+\item [Insert.] Add track(s) to playlist. If no other tracks have been
+ inserted then the selected track will be added immediately after current
+ playing track, otherwise they will be added to end of insertion list.
-\item [Insert next.] Add track(s) immediately after current playing
- track, no matter what else has been inserted.
+\item [Insert next.] Add track(s) immediately after current playing
+ track, no matter what else has been inserted.
-\item [Insert last.] Add track(s) to end of playlist.
+\item [Insert last.] Add track(s) to end of playlist.
-\item [Queue.] Queue is the same as Insert except queued tracks are
- deleted immediately from the playlist after they've been played. Also,
- queued tracks are not saved to the playlist file (see
- \reference{ref:playlistoptions}).
+\item [Queue.] Queue is the same as Insert except queued tracks are
+ deleted immediately from the playlist after they've been played. Also,
+ queued tracks are not saved to the playlist file (see
+ \reference{ref:playlistoptions}).
\item [Queue next.] Queue track(s) immediately after current playing track.
-\item [Queue last.] Queue track(s) at end of playlist.
+\item [Queue last.] Queue track(s) at end of playlist.
\end{description}
-The \setting{Playlist Submenu} can be used to add either single tracks or
-entire directories to a playlist. If the \setting{Playlist Submenu} is
-invoked on a single track, it will put only that track into the playlist.
-On the other hand, if the \setting{Playlist Submenu} is invoked on a
-directory, Rockbox adds all of the tracks in that directory to the
+The \setting{Playlist Submenu} can be used to add either single tracks or
+entire directories to a playlist. If the \setting{Playlist Submenu} is
+invoked on a single track, it will put only that track into the playlist.
+On the other hand, if the \setting{Playlist Submenu} is invoked on a
+directory, Rockbox adds all of the tracks in that directory to the
playlist.
-Dynamic playlists are saved so resume will restore them exactly as they
+Dynamic playlists are saved so resume will restore them exactly as they
were before shutdown.
\subsection{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
+\setting{Playlist Options} menu in the \setting{Main Menu} and select
+\setting{Save Current Playlist}.
+Either method will bring you to the \setting{Virtual Keyboard} (see
+\reference{sec:virtual_keyboard}), enter a filename for your playlist and
+accept it and you're done.
\subsection{Loading saved playlists}
\subsection{Helpful Hints}
-\subsubsection{Including subdirectories in playlists}
-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$
+\subsubsection{Including subdirectories in playlists}
+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
+Rockbox to include tracks in subdirectories as well as tracks in the
currently selected directory.