From 546ef9041f681d64b98ebaf81e2846c27ae48c7e 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