manual: update "Load to RAM" setting, Shortcuts

Change-Id: I5ba4b6207913375d35a68061422085255190b413
This commit is contained in:
Christian Soffke 2024-04-27 11:41:49 +02:00
parent 0dd5df4060
commit 3ae48284c1
2 changed files with 19 additions and 15 deletions

View file

@ -284,7 +284,7 @@ settings. With a shortcut,
a \fname{.cfg} loaded) a \fname{.cfg} loaded)
\item The file browser can be opened with the cursor positioned at \item The file browser can be opened with the cursor positioned at
a specified file or folder a specified file or folder
\item A file's or folder's ``Current Playlist'' context menu item can \item A file's or folder's ``Playing Next...'' context menu item can
be displayed be displayed
\item A setting can be configured (any which can be added to the \item A setting can be configured (any which can be added to the
\setting{Quick Screen}) \setting{Quick Screen})

View file

@ -47,30 +47,34 @@ with logging
\item[Load To RAM] \item[Load To RAM]
The database can either be kept on \disk{} (to save memory), or The database can either be kept on \disk{} (to save memory), or
loaded into RAM (for fast browsing). Setting this to \setting{Yes} loads loaded into RAM (for fast browsing). Setting this to \setting{Yes} loads
the database to RAM, allowing faster browsing and searching. Setting this the database to RAM, beginning with the next reboot, allowing faster browsing and
option to \setting{No} keeps the database on the \disk{}, meaning slower searching. Setting this option to \setting{No} keeps the database on the \disk{},
browsing but it does not use extra RAM and saves some battery on boot up. meaning slower browsing but it does not use extra RAM and saves some battery on
boot up.
\opt{HAVE_DISK_STORAGE}{ \opt{HAVE_DISK_STORAGE}{
If you browse your music frequently using the database, you should If you browse your music frequently using the database, you should
load to RAM, as this will reduce the overall battery consumption because load to RAM, as this will reduce the overall battery consumption because
the disk will not need to spin on each search. the disk will not need to spin on each search.
} }
\note{When Load to RAM is turned on, and the directory cache is enabled as well, \note{When Load to RAM is turned on, and the directory cache (see
it may take an unexpectedly long amount of time for disk activity to \reference{ref:dircache}) is enabled as well, it may take an unexpectedly long amount
wind down after booting, depending on your library size and player. of time for disk activity to wind down after booting, depending on your library size
and player.
This can be mitigated by choosing the \setting{Quick} option instead, which causes This can be mitigated by choosing the \setting{Quick} option instead, which causes
the database to ignore cached file references. In that case, you may notice brief the database to ignore cached file references. In that case, you should expect brief
moments of disk activity once the path for a database entry has to be retrieved. moments of disk activity whenever the path for a database entry has to be retrieved.
Set to \setting{On}, if you plan to take advantage the database's Update function, Setting this to \setting{On} may be preferable for reducing disk accesses if you plan to
or use a WPS that displays multiple upcoming tracks from the current playlist. take advantage of \setting{Auto Update}, have enabled \setting{Gather Runtime Data}
Otherwise, you may notice file names instead of metadata being displayed for those (see below for both), enabled \setting{Automatic resume} (see
tracks.} \reference{ref:Autoresumeconfigactual}), or use a WPS that displays multiple upcoming
tracks from the current playlist. In the latter case, metadata will not be displayed
for those tracks otherwise.}
} }
\item[Auto Update] \item[Auto Update]
If \setting{Auto update} is set to \setting{on}, each time the \dap{} If \setting{Auto update} is set to \setting{on}, each time the \dap{}
boots, the database will automatically be updated. boots, the database will automatically be updated.