From 6a527db3c4a3d33460a0930a28c31825d3bcdf0b Mon Sep 17 00:00:00 2001
From: George Joseph <gjoseph@sangoma.com>
Date: Wed, 16 Jul 2025 09:49:22 -0600
Subject: [PATCH] app_mixmonitor:  Update the documentation concerning the "D"
 option.

When using the "D" option to output interleaved audio, the file extension
must be ".raw".  That info wasn't being properly rendered in the markdown
and HTML on the documentation site.  The XML was updated to move the
note in the option section to a warning in the description.

Resolves: #1269
(cherry picked from commit 55fb2f4de47e2578ff0e6e154e08d1748fd99a30)
---
 apps/app_mixmonitor.c | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/apps/app_mixmonitor.c b/apps/app_mixmonitor.c
index 6cf61fa7b2..011b46a251 100644
--- a/apps/app_mixmonitor.c
+++ b/apps/app_mixmonitor.c
@@ -131,9 +131,11 @@
 						the file in the configured monitoring directory.</para>
 					</option>
 					<option name="D">
-						<para>Interleave the audio coming from the channel and the audio coming to the channel in
-						the output audio as a dual channel stream, rather than mix it.</para>
-						<note><para>Use .raw as the extension.</para></note>
+						<para>Interleave the audio coming from the channel and the audio
+						going to the channel and output it as a 2 channel (stereo)
+						raw stream rather than mixing it. You must use the
+						<literal>.raw</literal> file extension. Any other extension
+						will produce a corrupted file.</para>
 					</option>
 					<option name="n">
 						<para>When the <replaceable>r</replaceable> or <replaceable>t</replaceable> option is
@@ -189,6 +191,9 @@
 			parameters.  You risk a command injection attack executing arbitrary commands
 			if the untrusted strings aren't filtered to remove dangerous characters.  See
 			function <variable>FILTER()</variable>.</para></warning>
+			<warning><para>When using the <literal>D</literal> option to save
+			interleaved audio, you MUST use <literal>.raw</literal> as the
+			file extension.  Any other extension will produce a corrupted file.</para></warning>
 		</description>
 		<see-also>
 			<ref type="application">StopMixMonitor</ref>
-- 
2.47.3