forked from len0rd/rockbox
Opt out some SWCODEC only information from archos manuals and made some small tweaks
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10872 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
parent
630c300660
commit
86171f28cc
1 changed files with 44 additions and 35 deletions
|
|
@ -2,10 +2,11 @@
|
|||
\section{\label{ref:tagcache}Tag Cache}
|
||||
|
||||
\subsection{Introduction}
|
||||
Tag Cache is the Rockbox music database system. Using the information
|
||||
contained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your
|
||||
audio files, Rockbox builds and maintains a database of the music files on
|
||||
your player and allows you to browse them by Artist, Album and Genre.
|
||||
Tag Cache is the Rockbox music database system. Using the information
|
||||
contained in the tags (ID3v1, ID3v2%
|
||||
\opt{SWCODEC}{, Vorbis Comments, Apev2, etc.}%
|
||||
) in your audio files, Rockbox builds and maintains a database of the music
|
||||
files on your player and allows you to browse them by Artist, Album and Genre.
|
||||
|
||||
\subsection{Initializing the Tag Cache}
|
||||
Before you use the Tag Cache for the first time, you must initialize it by using
|
||||
|
|
@ -23,40 +24,49 @@ described in the following section.
|
|||
option to \setting{No} keeps the tagcache on the disk, meaning slower
|
||||
browsing but it does not use extra RAM and saves some battery on boot up.
|
||||
|
||||
\note{If you use TagCache frequently, you should load to RAM, as this
|
||||
will reduce the overall battery consumption because the disk will not
|
||||
need to spin on each search.}
|
||||
\note{If you browse your music frequently using Tag Cache, you should load
|
||||
to RAM, as this will reduce the overall battery consumption because the
|
||||
disk will not need to spin on each search.}
|
||||
}
|
||||
|
||||
\item[Auto Update: ]
|
||||
If \setting{Auto update} is set to \setting{on}, each time the \dap{}
|
||||
boots, Tag Cache will automatically do everything that the
|
||||
\setting{Update now} setting does. Note that the \setting{Auto
|
||||
Update} will only check for deleted files if the Directory Cache
|
||||
(\setting{General Settings $\rightarrow$ System $\rightarrow$
|
||||
Disk $\rightarrow$ Directory Cache}) is enabled.
|
||||
\setting{Update now} includes that check whether dircache has been enabled or
|
||||
not.
|
||||
|
||||
boots, Tag Cache will automatically update the database.
|
||||
\opt{SWCODEC}{
|
||||
\note{The \setting{Auto Update} will only check for deleted files if the
|
||||
\setting{Directory Cache} (\setting{General Settings $\rightarrow$ System
|
||||
$\rightarrow$ Disk $\rightarrow$ Directory Cache}) is enabled.
|
||||
\setting{Update now} includes that check whether dircache has been
|
||||
enabled or not.}
|
||||
}%
|
||||
\opt{MASCODEC}{\setting{Auto Update} does not detect deleted files. To remove
|
||||
deleted files from the database you need to run \setting{Update Now}.}%
|
||||
|
||||
\item[Initialize Now: ]
|
||||
Before you use the Tag Cache for the first time, you must initialize it by
|
||||
using the \setting{Initialize Now} function in the \setting{Tag Cache
|
||||
Menu}. \setting{Initialize Now} removes all database files (removing
|
||||
runtimedb data also) and rebuilds the database from scratch. This takes
|
||||
approximately 5 to 10 minutes, and may require a restart to allow the
|
||||
files to be committed to the cache.
|
||||
|
||||
The Tag Cache initialization happens in the background, so you can continue
|
||||
to listen to music while the Tag Cache is being initialized. If you shut
|
||||
down your player during initialization, the database building process will
|
||||
Before you use the Tag Cache for the first time, you must initialize it by
|
||||
using the \setting{Initialize Now} function in the \setting{Tag Cache
|
||||
Menu}.
|
||||
\warn{\setting{Initialize Now} removes all database files (removing
|
||||
runtimedb data also) and rebuilds the database from scratch.}
|
||||
This can take quite a while depending on the number of music files on your
|
||||
\dap{}, and may require a restart to allow the files to be committed to the
|
||||
cache.
|
||||
|
||||
The Tag Cache initialization happens in the background, so you can continue
|
||||
to listen to music while the Tag Cache is being initialized. If you shut
|
||||
down your player during initialization, the database building process will
|
||||
continue next time you turn it on.
|
||||
|
||||
\item[Update Now: ]
|
||||
\setting{Update now} causes Tag Cache to detect new and deleted files
|
||||
Note that unlike the \setting{Auto Update} function, \setting{Update Now}
|
||||
will update the database regardless of whether the \setting{Directory Cache}
|
||||
is enabled. Thus, an update using \setting{Update now} may take a long
|
||||
time. Unlike \setting{Initialize Now}, the \setting{Update Now} function
|
||||
\setting{Update now} causes Tag Cache to detect new and deleted files
|
||||
\opt{SWCODEC}{
|
||||
\note{Unlike the \setting{Auto Update} function, \setting{Update Now}
|
||||
will update the database regardless of whether the \setting{Directory Cache}
|
||||
is enabled. Thus, an update using \setting{Update now} may take a long
|
||||
time.
|
||||
}
|
||||
}
|
||||
Unlike \setting{Initialize Now}, the \setting{Update Now} function
|
||||
does not remove runtime database information.
|
||||
|
||||
\item[Gather Runtime Data (Experimental): ]
|
||||
|
|
@ -66,8 +76,8 @@ described in the following section.
|
|||
\item[Export modifications: ]
|
||||
This allows for the runtime data to be exported into \\
|
||||
\fname{/.rockbox/tagcache\_changelog.txt}, which backs up the runtime data in
|
||||
ASCII format. This is needed when Tag Cache structures change, because new
|
||||
code cannot read old Tag Cache database code. But, all modifications
|
||||
ASCII format. This is needed when Tag Cache structures change, because new
|
||||
code cannot read old Tag Cache database code. But, all modifications
|
||||
exported to ASCII format should be readable by all Tag Cache versions.
|
||||
|
||||
\item[Import modifications: ]
|
||||
|
|
@ -79,10 +89,10 @@ described in the following section.
|
|||
|
||||
\subsection{Using the Tag Cache}
|
||||
Once the Tag Cache has been initialized, you can browse your music by Artist,
|
||||
Album, Genre and Song Name. To use the Tag Cache, change the
|
||||
Album, Genre and Song Name. To use the Tag Cache, change the
|
||||
\setting{Show Files} show mode by changing the \setting{General Settings
|
||||
$\rightarrow$ File View $\rightarrow$ Show files} option to
|
||||
\setting{ID3 database}. This disables the \setting{File Browser} and instead
|
||||
\setting{ID3 database}. This disables the \setting{File Browser} and instead
|
||||
allows you to view files using the information in the Tag Cache database.\\
|
||||
|
||||
\note{You may need to increase the value of the \setting{Max files in dir
|
||||
|
|
@ -111,4 +121,3 @@ to RAM.}
|
|||
\end{tabularx}
|
||||
\end{center}
|
||||
\end{table}
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue