manual/configure_rockbox/bookmarking.tex

% $Id$ %
\section{\label{ref:Bookmarkconfigactual}Bookmarking}
  Bookmarks allow you to save your current position within a track so that 
  you can return to it at a later time. Bookmarks are saved on a per folder
  basis. In other words, all of the files in the same folder have their
  bookmarks stored together in the folder where the files are located. You
  can store multiple bookmarks for the same track.
  \begin{description}
  \item [Bookmark on Stop. ]This option controls whether Rockbox writes a
    bookmark to the disk when playback is stopped. Setting this to
    \setting{No} turns automatic bookmarking completely off. In contrast
    \setting{Yes} turns automatic bookmarking on while \setting{Ask} 
    asks on stopping the track if a bookmark should be created.
    With the above options \setting{Yes} and \setting{Ask} if there is an existing 
    \fname{.bmark} file the current position information will be added to the
    front of the existing list, up to the maximum number of allowed bookmarks
    per file (currently 10). If no \fname{.bmark} file exists, one will be
    created with the new bookmark information. Finally, if the 
    \setting{Maintain a list of Recently Used Bookmarks}
     option is enabled, the bookmarking
    information will be added to recent bookmarks list.
    \begin{description}    
      \item[Yes -- Recent Only.]
            Turns on automatic bookmarking -- One bookmark only
      \item[Ask -- Recent Only.]
            Asks if a bookmark should be created when stopping track -- 
            One bookmark only
    \end{description}
    With the two \setting{Recent Only} options, nothing is written to the 
    \fname{.bmark} file. If the \setting{Maintain a list of Recently Used Bookmarks}
    option is enabled, the bookmarking information will however be added to
    recent bookmarks list. 
    \note{The \setting{Resume} function remembers your position in the most
      recently accessed track regardless of how the \setting{Bookmark on Stop}
      option is set.}
    
  \item [Load Last Bookmark. ]

  When the \setting{Load Last Bookmark} option is set to \setting{Yes}, Rockbox
  automatically returns to the position of the last bookmark within a file
  when that file is played. 

  When the \setting{Load Last Bookmark} option is set to \setting{Ask}, Rockbox will
  give the user the option of starting from the beginning of the track
  of or from the bookmark. 

  When the \setting{Load Last Bookmark} option is set to \setting{No}, playback always
  starts from the beginning of the track, and the user must play the bookmark
  or use the \setting{Load Bookmark} function in the Main Menu, while the file
  is playing, to resume at the bookmarked location.
    
  \item [Maintain a list of Recently Used Bookmarks. ]

  This list of Most Recent Bookmarks (MRB's) may be accessed through the
  \setting{Recent Bookmarks} option of the \setting{Bookmarks} submenu of the 
  Main Menu. When set to \setting{Yes} each new bookmark will be added to the
  MRB list. Setting this to \setting{No} disables the addition of bookmarks to
  the MRB list. \setting{Unique Only} will remove an old bookmark for the current
  track from the MRB list and replace it with the new one if a bookmark in the
  MRB list already existed. Otherwise this will behave like the 
  \setting{Yes} setting.
  \fixme{The above information was obtained by reading the source code, but my C is rather rusty...}
  \end{description}