--- a/doc/Codec-utils	Thu Dec 15 01:42:31 2022 +0000
+++ b/doc/Codec-utils	Thu Dec 15 02:08:55 2022 +0000
@@ -35,14 +35,14 @@
 		and feeds all frames and BFIs to our EFR decoder.  The decoded
 		output is written as WAV.
 
-WAV reading and writing functions used by the above utilities have been lifted
-out of opencore-amrnb test code.
+The above are original programs that read WAV input for encoding and write WAV
+output from decoding.  We now also have raw versions that read and write our
+"robe" (raw big-endian) format instead:
 
-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.
+gsmfr-encode-r	Just like gsm[e]fr-encode, but reading "robe" instead of WAV.
+gsmefr-encode-r
+
+gsmfr-decode-r	Just like gsm[e]fr-decode, but writing "robe" instead of WAV.
+gsmefr-decode-r
+
+Please see PCM-file-formats article for the rationale.