diff options
Diffstat (limited to 'manual/configure_rockbox/bookmarking.tex')
-rwxr-xr-x | manual/configure_rockbox/bookmarking.tex | 54 |
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} |