path: root/manual
diff options
authorMichael Hohmuth <>2011-02-11 17:17:39 +0000
committerMichael Hohmuth <>2011-02-11 17:17:39 +0000
commit97ba12e3360c14f3764b18fa0af2722dbcb4edca (patch)
tree4fd06b38dc5a6db9a6e720d2be188dda17454c0d /manual
parent3f377e568e29165509b9b1e2dd71ca14acde8759 (diff)
Describe autoresume in the manual.
git-svn-id: svn:// a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
2 files changed, 58 insertions, 0 deletions
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.
+\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}
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/autoresume.tex}