manual: Mention [lack of] unicode normalization in the manual

rockbox-gerrit-noreply--- via rockbox-cvs <[email protected]> Sun, 3 May 2026 08:08:57 -0400
Newsgroups gmane.comp.systems.archos.rockbox.cvs
Message-ID <[email protected]>
commit 30ad7f4ee84f4d95ddf3d437871cb1bd792f0d17
Author: Solomon Peachy <[email protected]>
Date:   Sun May 3 08:07:51 2026 -0400

    manual:  Mention [lack of] unicode normalization in the manual
    
    Change-Id: Icdb19a47367fbe7b2fd32679885a26669a799612

diff --git a/manual/appendix/file_formats.tex b/manual/appendix/file_formats.tex
index cb37d9b532..32e4ddbd8b 100644
--- a/manual/appendix/file_formats.tex
+++ b/manual/appendix/file_formats.tex
@@ -89,7 +89,7 @@
         & \fname{.aac}, \fname{.m4a}, \fname{.m4b}, \fname{.mp4}, \fname{.rm}, \fname{.ra}, \fname{.rmvb}
         \opt{codec_aac_he}{
             & Supports AAC-LC, -HEv1, and -HEv2 profiles\\}
-        \nopt{codec_aac_he}{ % low memory (CODEC_SIZE <= 512 KB) or slow cpu targets 
+        \nopt{codec_aac_he}{ % low memory (CODEC_SIZE <= 512 KB) or slow cpu targets
             & Supports AAC-LC profile\\}
     MPEG audio
         & \fname{.mpa}, \fname{.mpga}, \fname{.mp1}, \fname{.mp2}, \fname{.mp3}
@@ -146,7 +146,7 @@
         & Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 a-law/$\mu$-law\\
     Free Lossless Audio
         & \fname{.flac}
-        & Multichannel and/or high-resolution files will be downmixed to 16-bit stereo. 
+        & Multichannel and/or high-resolution files will be downmixed to 16-bit stereo.
 	\opt{ipod,iriverh10,sansaclip,sansam200v4,sansac200v2,iriverh100,iriverh300,iaudiox5,iaudiom5,iaudiom3,mpiohd200,mpiphd300,cowond2}{
 	    \nopt{ipodnano2g,ipod6g}{Due to resource constraints, files with large block sizes are not supported, and realtime playback may not be possible where downmixing is necessary.}}
 	\\
@@ -377,4 +377,14 @@
         \item The maximum size of each metadata item (e.g. Artists) is limited
               to 90 bytes.
     }
+    \opt{utf8proc}{
+        \item All textual metadata is normalized into most compact Unicode
+              NFC form. This simplifies font/glpyh rendering, and makes
+              it possible to compare/sort strings that use different
+              normalization forms.
+    }
+    \nopt{utf8proc}{
+        \item Due to RAM limitations, the \playertype does not process or
+              normalize textual metadata in any way.
+    }
     \end{enumerate}
-- 
rockbox-cvs mailing list
[email protected]
https://lists.haxx.se/mailman/listinfo/rockbox-cvs