From 6a82f4c39059e776b2fec6170c24e328c19247b8 Mon Sep 17 00:00:00 2001
From: Naveen Albert <asterisk@phreaknet.org>
Date: Mon, 6 Oct 2025 16:38:35 -0400
Subject: [PATCH] func_callerid: Document limitation of DNID fields.

The Dial() application does not propagate DNID fields, which is counter
to the behavior of the other Caller ID fields. This behavior is likely
intentional since the use of Dial theoretically suggests a new dialed
number, but document this caveat to inform users of it.

Resolves: #1519
---
 funcs/func_callerid.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/funcs/func_callerid.c b/funcs/func_callerid.c
index 0f4399fc46..36d4bf068a 100644
--- a/funcs/func_callerid.c
+++ b/funcs/func_callerid.c
@@ -127,6 +127,9 @@
 					<enum name = "dnid-subaddr-type" />
 					<enum name = "dnid-subaddr-odd" />
 				</enumlist>
+				<para>Note that unlike other Caller ID fields, DNID information is not propagated
+				by the <literal>Dial</literal> application, with the exception of
+				Transmit Network Select (which is not currently used for anything).</para>
 			</parameter>
 			<parameter name="CID">
 				<para>Optional Caller*ID to parse instead of using the Caller*ID from the
-- 
2.47.3