# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1671002746 0
# Node ID 30c7bc0642182dd370f7af133b0c2f8ef2ebd02d
# Parent  195911f2211c3bfd172bba3f4353a446187883b2
doc/Codec-utils: add note about PCM file format issue

diff -r 195911f2211c -r 30c7bc064218 doc/Codec-utils
--- a/doc/Codec-utils	Wed Dec 14 07:04:59 2022 +0000
+++ b/doc/Codec-utils	Wed Dec 14 07:25:46 2022 +0000
@@ -37,3 +37,12 @@
 
 WAV reading and writing functions used by the above utilities have been lifted
 out of opencore-amrnb test code.
+
+Now that we are starting to encounter use cases that involve more than feeding
+a PC microphone recording to test encoders and playing decoder output on PC
+speakers, many of those other use cases call for using raw format instead of WAV
+for 16-bit linear PCM.  While it would be philosophically most proper to add an
+option to gsm[e]fr-encode and gsm[e]fr-decode utilities to read/write raw PCM
+files instead of WAV, doing so would complicate the code too much.  As a
+compromise between code simplicity and functionality, we provide lossless
+conversion utilities - see PCM-file-formats article.