Nyaaori/rockbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

manuals: Update warning on max entries in file browser / playlist

Browse source 
These settings have a warning that increasing them will shorten the
audio buffer. This is not very useful, because users might not know
what "shortening the music buffer" implies.

Since the size of the audio buffer is probably irrelevant for flash
based storage, display the warning only for HDD-based targets, and
explain what the drawbacks may be if the settings are set too high.

Change-Id: Ie9eb4907c67e20695bfa083e1c2a29385e66afcf
This commit is contained in:
Aidan MacDonald 2023-01-02 20:45:14 +00:00
parent e8e781b006
commit 9d6f9441ae
1 changed files with 8 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
manual/configure_rockbox/system_options.tex
View file

@ -103,15 +103,17 @@ This sub menu relates to limits in the Rockbox operating system.
\item [Max Entries in File Browser.] This setting controls the limit on \item [Max Entries in File Browser.] This setting controls the limit on
the number of files that you can see in any particular directory in the the number of files that you can see in any particular directory in the
file browser. You can configure the size to be between 50 and file browser. You can configure the size to be between 50 and
10,000 files in steps of 50. The default is 400. Higher values will shorten 10,000 files in steps of 50. The default is 400. \opt{HAVE_DISK_STORAGE}{
the music buffer, so you should increase this setting \emph{only} if you have Higher values will shorten the music buffer, which can negatively affect
directories with a large number of files. battery life by forcing the disk to spin up more often. Increase this
setting \emph{only} if you need to.}
\item [Max Playlist Size.] This setting controls the maximum size of \item [Max Playlist Size.] This setting controls the maximum size of
a playlist. The playlist size can be between 1,000 and 32,000 files, a playlist. The playlist size can be between 1,000 and 32,000 files,
in steps of 1,000 (default is 10,000). Higher values will shorten the in steps of 1,000 (default is 10,000). \opt{HAVE_DISK_STORAGE}{Higher
music buffer, so you should increase this setting \emph{only} if you values will shorten the music buffer, which can negatively affect battery
have very large playlists. life by forcing the disk to spin up more often. Increase this setting
\emph{only} if you use very large playlists.}
\item [Glyphs To Cache.] This sets the default memory allocation size \item [Glyphs To Cache.] This sets the default memory allocation size
for fonts in unique glyphs. This should be set to the number of unique for fonts in unique glyphs. This should be set to the number of unique