From 9d6f9441ae32c895a24653f95c080929c00da732 Mon Sep 17 00:00:00 2001 From: Aidan MacDonald Date: Mon, 2 Jan 2023 20:45:14 +0000 Subject: [PATCH] manuals: Update warning on max entries in file browser / playlist 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 --- manual/configure_rockbox/system_options.tex | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/manual/configure_rockbox/system_options.tex b/manual/configure_rockbox/system_options.tex index 85e6a6b7d6..336b0dd84d 100755 --- a/manual/configure_rockbox/system_options.tex +++ b/manual/configure_rockbox/system_options.tex @@ -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 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 - 10,000 files in steps of 50. The default is 400. Higher values will shorten - the music buffer, so you should increase this setting \emph{only} if you have - directories with a large number of files. + 10,000 files in steps of 50. The default is 400. \opt{HAVE_DISK_STORAGE}{ + Higher values will shorten the music buffer, which can negatively affect + 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 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 - music buffer, so you should increase this setting \emph{only} if you - have very large playlists. + in steps of 1,000 (default is 10,000). \opt{HAVE_DISK_STORAGE}{Higher + values will shorten the music buffer, which can negatively affect battery + 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 for fonts in unique glyphs. This should be set to the number of unique