From 97ba12e3360c14f3764b18fa0af2722dbcb4edca Mon Sep 17 00:00:00 2001 From: Michael Hohmuth Date: Fri, 11 Feb 2011 17:17:39 +0000 Subject: [PATCH] Describe autoresume in the manual. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@29284 a1c6a512-1295-4272-9138-f99709370657 --- manual/configure_rockbox/autoresume.tex | 55 +++++++++++++++++++++++++ manual/configure_rockbox/main.tex | 3 ++ 2 files changed, 58 insertions(+) create mode 100644 manual/configure_rockbox/autoresume.tex diff --git a/manual/configure_rockbox/autoresume.tex b/manual/configure_rockbox/autoresume.tex new file mode 100644 index 0000000000..a253a88bcd --- /dev/null +++ b/manual/configure_rockbox/autoresume.tex @@ -0,0 +1,55 @@ +% $Id$ % +\section{\label{ref:Autoresumeconfigactual}Automatic resume} + +The automatic resume feature stores and recalls resume positions for +all tracks without user intervention. These resume points are stored +in the database, and thus automatic resume only works when the +database has been initialized. + +When automatic resume is enabled, manually selected tracks resume +playback at their last playback position. It does not matter in which +way you start the track; tracks are resumed whether they are navigated +to through the database browser or file browser, from a playlist or +bookmark, or by skipping through tracks in a playlist. + +Optionally, you can also enable automatic resume for automatic track +transitions. In this case, the next track will be resumed as well +instead of starting playback at its beginning. This is most useful +for podcasts, and can be enabled on a per-directory basis. + +A track's resume position is updated whenever playback of that track +stops, including when explicitly stopping the track, powering off the +\dap{}, or starting playback of another track. + +If you intend to start a track from its beginning but notice that it +was resumed, you can press the \ButtonLeft{} button to skip back to +its beginning. When pressing \ButtonLeft{} again in the first few +seconds of a track to go to the previous track, the previously (on +first button press) saved resume position is retained. Therefore, you +can also use the \ButtonLeft{} and \ButtonRight{} buttons to skip +across tracks in a playlist without losing their resume position. + +\begin{description} +\item[Automatic resume.] This option enables or disables automatic + resume globally. When Rockbox detects that the database (which is + needed for this feature) has not been initialized yet, it asks + whether it should be initialized right away. + +\item[Resume on automatic track change.] Controls whether the next + track in an automatic track transition should be resumed at its last + playback position as well. + \begin{description} + \item[No.] Automatic resume works only for manual track selection. + \item[Yes.] Always attempt to resume -- for both manual and + automatic track changes. + \item[In custom directories only.] Configure directories in which to + enable resume on automatic track change. Selecting this option + starts the text editor, in which you can enter the (absolute, + case-insensitive) directory names separated by colons (``:''). + + A typical value is ``/podcast'', which matches all files in + directories \fname{/PODCAST}, \fname{/Podcast} or \fname{/podcast} + and their subdirectories, but not in directories \fname{/podcasts} + (mind the trailing ``s'') or \fname{/audio/podcast}. + \end{description} +\end{description} diff --git a/manual/configure_rockbox/main.tex b/manual/configure_rockbox/main.tex index ef26c7c23f..3176c93b59 100644 --- a/manual/configure_rockbox/main.tex +++ b/manual/configure_rockbox/main.tex @@ -15,6 +15,9 @@ \input{configure_rockbox/display_options.tex} \input{configure_rockbox/system_options.tex} \input{configure_rockbox/bookmarking.tex} +\opt{tagcache}{\opt{swcodec}{ + \input{configure_rockbox/autoresume.tex} +}} \input{configure_rockbox/language.tex} \input{configure_rockbox/voice.tex} \input{configure_rockbox/hotkey_settings.tex}