summaryrefslogtreecommitdiff
path: root/manual/configure_rockbox/bookmarking.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/configure_rockbox/bookmarking.tex')
-rwxr-xr-xmanual/configure_rockbox/bookmarking.tex54
1 files changed, 28 insertions, 26 deletions
diff --git a/manual/configure_rockbox/bookmarking.tex b/manual/configure_rockbox/bookmarking.tex
index 8681fdd727..b3976fd13a 100755
--- a/manual/configure_rockbox/bookmarking.tex
+++ b/manual/configure_rockbox/bookmarking.tex
@@ -1,3 +1,4 @@
1% $Id$ %
1\section{\label{ref:Bookmarkconfigactual}Bookmarking} 2\section{\label{ref:Bookmarkconfigactual}Bookmarking}
2 Bookmarks allow you to save your current position within a track so that 3 Bookmarks allow you to save your current position within a track so that
3 you can return to it at a later time. Bookmarks are saved on a per folder 4 you can return to it at a later time. Bookmarks are saved on a per folder
@@ -5,57 +6,58 @@
5 bookmarks stored together in the folder where the files are located. You 6 bookmarks stored together in the folder where the files are located. You
6 can store multiple bookmarks for the same track. 7 can store multiple bookmarks for the same track.
7 \begin{description} 8 \begin{description}
8 \item [Bookmark on Stop: ]This option controls whether Rockbox writes a 9 \item [Bookmark on Stop. ]This option controls whether Rockbox writes a
9 bookmark to the disk when the STOP button is pressed. 10 bookmark to the disk when playback is stopped. Setting this to
10 \emph{No} turns automatic bookmarking completely off. In contrast 11 \setting{No} turns automatic bookmarking completely off. In contrast
11 \emph{Yes} turns automatic bookmarking on while \emph{Ask} asks on stopping 12 \setting{Yes} turns automatic bookmarking on while \setting{Ask}
12 the track if a bookmark should be created. 13 asks on stopping the track if a bookmark should be created.
13 With the above options ``Yes'' and ``Ask'' if there is an existing 14 With the above options \setting{Yes} and \setting{Ask} if there is an existing
14 \fname{.bmark} file the current position information will be added to the 15 \fname{.bmark} file the current position information will be added to the
15 front of the existing list, up to the maximum number of allowed bookmarks 16 front of the existing list, up to the maximum number of allowed bookmarks
16 per file (currently 10). If no \fname{.bmark} file exists, one will be 17 per file (currently 10). If no \fname{.bmark} file exists, one will be
17 created with the new bookmark information. Finally, if the ``Maintain 18 created with the new bookmark information. Finally, if the
18 a list of Recently Used Bookmarks'' option is enabled, the bookmarking 19 \setting{Maintain a list of Recently Used Bookmarks}
20 option is enabled, the bookmarking
19 information will be added to recent bookmarks list. 21 information will be added to recent bookmarks list.
20 \begin{description} 22 \begin{description}
21 \item[Yes -- Recent Only:] 23 \item[Yes -- Recent Only.]
22 Turns on automatic bookmarking - One bookmark only 24 Turns on automatic bookmarking -- One bookmark only
23 \item[Ask -- Recent Only:] 25 \item[Ask -- Recent Only.]
24 Asks if a bookmark should be created when stopping track -- 26 Asks if a bookmark should be created when stopping track --
25 One bookmark only 27 One bookmark only
26 \end{description} 28 \end{description}
27 With the two ``Recent Only'' options, nothing is written to the 29 With the two \setting{Recent Only} options, nothing is written to the
28 \fname{.bmark} file. if the ``Maintain a list of Recently Used Bookmarks'' 30 \fname{.bmark} file. If the \setting{Maintain a list of Recently Used Bookmarks}
29 option is enabled, the bookmarking information will however be added to 31 option is enabled, the bookmarking information will however be added to
30 recent bookmarks list. 32 recent bookmarks list.
31 \note{The \emph{Resume} function remembers your position in the most 33 \note{The \setting{Resume} function remembers your position in the most
32 recently accessed track regardless of how the \emph{Bookmark on Stop} 34 recently accessed track regardless of how the \setting{Bookmark on Stop}
33 option is set.} 35 option is set.}
34 36
35 \item [Load Last Bookmark: ] 37 \item [Load Last Bookmark. ]
36 38
37 When the \emph{Load Last Bookmark} option is set to YES, Rockbox 39 When the \setting{Load Last Bookmark} option is set to \setting{Yes}, Rockbox
38 automatically returns to the position of the last bookmark within a file 40 automatically returns to the position of the last bookmark within a file
39 when that file is played. 41 when that file is played.
40 42
41 When the \emph{Load Last Bookmark} option is set to ASK, Rockbox will 43 When the \setting{Load Last Bookmark} option is set to \setting{Ask}, Rockbox will
42 give the user the option of starting from the beginning of the track 44 give the user the option of starting from the beginning of the track
43 of or from the bookmark. 45 of or from the bookmark.
44 46
45 When the \emph{Load Last Bookmark} option is set to NO, playback always 47 When the \setting{Load Last Bookmark} option is set to \setting{No}, playback always
46 starts from the beginning of the track, and the user must play the bookmark 48 starts from the beginning of the track, and the user must play the bookmark
47 or use the \emph{Load Bookmark} function in the Main Menu, while the file 49 or use the \setting{Load Bookmark} function in the Main Menu, while the file
48 is playing, to resume at the bookmarked location. 50 is playing, to resume at the bookmarked location.
49 51
50 \item [Maintain a list of Recently Used Bookmarks: ] 52 \item [Maintain a list of Recently Used Bookmarks. ]
51 53
52 This list of Most Recent Bookmarks (MRB's) may be accessed through the 54 This list of Most Recent Bookmarks (MRB's) may be accessed through the
53 \emph{Recent Bookmarks} option of the \emph{Bookmarks} submenu of the 55 \setting{Recent Bookmarks} option of the \setting{Bookmarks} submenu of the
54 Main Menu. When set to \emph{Yes} each new bookmark will be added to the 56 Main Menu. When set to \setting{Yes} each new bookmark will be added to the
55 MRB list. Setting this to \emph{No} disables the addition of bookmarks to 57 MRB list. Setting this to \setting{No} disables the addition of bookmarks to
56 the MRB list. \emph{Unique Only} will remove an old bookmark for the current 58 the MRB list. \setting{Unique Only} will remove an old bookmark for the current
57 track from the MRB list and replace it with the new one if a bookmark in the 59 track from the MRB list and replace it with the new one if a bookmark in the
58 MRB list already existed. Otherwise this will behave like the 60 MRB list already existed. Otherwise this will behave like the
59 \emph{Yes} setting. 61 \setting{Yes} setting.
60 \fixme{The above information was obtained by reading the source code, but my C is rather rusty...} 62 \fixme{The above information was obtained by reading the source code, but my C is rather rusty...}
61 \end{description} 63 \end{description}