devs/foxbox
1
0
Fork 0
forked from len0rd/rockbox
Code Pull requests Activity

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.

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11215 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Nils Wallménius 2006-10-13 16:19:30 +00:00
parent 1c3d89c35e
commit 2239bbab04
3 changed files with 74 additions and 66 deletions
Download patch file Download diff file Expand all files Collapse all files

4
manual/rockbox_interface/main.tex
View file

@ -183,11 +183,11 @@ stopped, so this is not and will not be possible.
\subsubsection{Playlists} \subsubsection{Playlists}
Rockbox is playlist oriented. This means that every time you play an audio file, 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 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 it to a file. If you don't want to use playlists you can simply play your
files folder based. 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} \subsubsection{Menu}
From the menu you can customise Rockbox. Rockbox itself is very customisable. From the menu you can customise Rockbox. Rockbox itself is very customisable.

2
manual/rockbox_interface/playback.tex
View file

@ -188,7 +188,7 @@ before shutdown.
\note{To view, save or reshuffle the current dynamic playlist, use the \note{To view, save or reshuffle the current dynamic playlist, use the
\setting{Playlist Options} setting in the WPS Context Menu.} \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}{} \screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{}
This is the virtual keyboard that is used when entering file names in Rockbox. This is the virtual keyboard that is used when entering file names in Rockbox.

134
manual/working_with_playlists/main.tex
View file

@ -1,52 +1,52 @@
\section{Working with Playlists} \section{\label{ref:working_with_playlists}Working with Playlists}
\fixme{This section is currently in a half written state, with possible errors \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 and a lot of stuff missing. Please help us fix this chapter by submitting
additions/corrections to the tracker} additions/corrections to the tracker}
\subsection{Playlist terminology} \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: playlists:
\begin{description} \begin{description}
\item[Directory.] A playlist! One of the keys to getting the most out of \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 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 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 create a playlist automatically. For example, if you are playing the
contents of a directory, Rockbox will automatically create a playlist contents of a directory, Rockbox will automatically create a playlist
containing the songs in that directory. This means that just about anything 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 that is described in this chapter with respect to playlists also applies to
directories. directories.
\item[Dynamic playlist.] A dynamic playlist is a playlist that is created \item[Dynamic playlist.] A dynamic playlist is a playlist that is created
``On the fly.'' Any time you insert or queue tracks using the ``On the fly.'' Any time you insert or queue tracks using the
\setting{Playlist submenu} (see \reference{playlist_submenu}), you are \setting{Playlist submenu} (see \reference{playlist_submenu}), you are
creating (or adding to) a dynamic playlist. creating (or adding to) a dynamic playlist.
\item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means \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 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} played. As you will see later in this chapter, Rockbox can \setting{Insert}
into a playlist in several places. into a playlist in several places.
\item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song \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 into a playlist and then to remove the song from the playlist once it has
been played. The only difference between \setting{Insert} and been played. The only difference between \setting{Insert} and
\setting{Queue} is that the \setting{Queue} option removes the song from the \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. playlist once it has been played, and the \setting{Insert} option does not.
\end{description} \end{description}
\subsection{Creating playlists} \subsection{Creating playlists}
Rockbox can create playlists in four different ways. Rockbox can create playlists in four different ways.
\subsubsection{By playing a song} \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.
Whenever a song is selected from the \setting{File Browser} using the \note{If you already have already created a dynamic playlist, playing a new
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect} button, Rockbox will automatically create a playlist song will \emph{erase} the current playlist and create a new one. If you
containing all of the songs in the directory in which that song is located. want to add a song to the current playlist rather than erasing the current
\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.''} playlist, see the section below on ``Adding music to playlists.''}
\subsubsection{By using Insert and Queue functions} \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} \subsection{Adding music to playlists}
\subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} \subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist}
\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
The \setting{Playlist Submenu} allows you to put tracks into a The \setting{Playlist Submenu} allows you to put tracks into a
``dynamic playlist''. If there is no music currently playing, Rockbox will ``dynamic playlist''. If there is no music currently playing, Rockbox will
create a new dynamic playlist and put the selected track(s) into the create a new dynamic playlist and put the selected track(s) into the
playlist. If there is music currently playing, Rockbox will put 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 track(s) into the current 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 the following
options: options:
\begin{description} \begin{description}
\item [Insert.] Add track(s) to playlist. If no other tracks have been \item [Insert.] Add track(s) to playlist. If no other tracks have been
inserted then the selected track will be added immediately after current inserted then the selected track will be added immediately after current
playing track, otherwise they will be added to end of insertion list. playing track, otherwise they will be added to end of insertion list.
\item [Insert next.] Add track(s) immediately after current playing \item [Insert next.] Add track(s) immediately after current playing
track, no matter what else has been inserted. 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 \item [Queue.] Queue is the same as Insert except queued tracks are
deleted immediately from the playlist after they've been played. Also, deleted immediately from the playlist after they've been played. Also,
queued tracks are not saved to the playlist file (see queued tracks are not saved to the playlist file (see
\reference{ref:playlistoptions}). \reference{ref:playlistoptions}).
\item [Queue next.] Queue track(s) immediately after current playing track. \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} \end{description}
The \setting{Playlist Submenu} can be used to add either single tracks or The \setting{Playlist Submenu} can be used to add either single tracks or
entire directories to a playlist. If the \setting{Playlist Submenu} is 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. 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 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 directory, Rockbox adds all of the tracks in that directory to the
playlist. 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. were before shutdown.
\subsection{Saving playlists} \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{Loading saved playlists}
\subsection{Helpful Hints} \subsection{Helpful Hints}
\subsubsection{Including subdirectories in playlists} \subsubsection{Including subdirectories in playlists}
You can control whether or not Rockbox includes the contents of You can control whether or not Rockbox includes the contents of
subdirectories when adding an entire directory to a playlists. subdirectories when adding an entire directory to a playlists.
Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$
Recusively Insert Directories} setting to \setting{Yes} if you would like 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. currently selected directory.