From 2de9cd0d38b2da1876c09fd1a7ea302bd3012bb0 Mon Sep 17 00:00:00 2001
From: Leif Madsen <leif@leifmadsen.com>
Date: Wed, 31 Mar 2010 17:48:09 +0000
Subject: [PATCH] Add documentation clarifying when 't' and 'T' can be used.

(closes issue #17021)
Reported by: kovzol
Tested by: lmadsen, kovzol, davidw, ebroad

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@255504 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 apps/app_dial.c         | 6 ++++--
 configs/sip.conf.sample | 3 ++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/apps/app_dial.c b/apps/app_dial.c
index d6430bebad..612efcc649 100644
--- a/apps/app_dial.c
+++ b/apps/app_dial.c
@@ -336,11 +336,13 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
 				</option>
 				<option name="t">
 					<para>Allow the called party to transfer the calling party by sending the
-					DTMF sequence defined in <filename>features.conf</filename>.</para>
+					DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
+					transfers initiated by other methods.</para>
 				</option>
 				<option name="T">
 					<para>Allow the calling party to transfer the called party by sending the
-					DTMF sequence defined in <filename>features.conf</filename>.</para>
+					DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
+					transfers initiated by other methods.</para>
 				</option>
 				<option name="U" argsep="^">
 					<argument name="x" required="true">
diff --git a/configs/sip.conf.sample b/configs/sip.conf.sample
index ce1a8b6971..e2df554a29 100644
--- a/configs/sip.conf.sample
+++ b/configs/sip.conf.sample
@@ -108,7 +108,8 @@ context=default                 ; Default context for incoming calls
                                 ; instead of the From: field.
 allowoverlap=no                 ; Disable overlap dialing support. (Default is yes)
 ;allowtransfer=no               ; Disable all transfers (unless enabled in peers or users)
-                                ; Default is enabled
+                                ; Default is enabled. The Dial() options 't' and 'T' are not
+                                ; related as to whether SIP transfers are allowed or not.
 ;realm=mydomain.tld             ; Realm for digest authentication
                                 ; defaults to "asterisk". If you set a system name in
                                 ; asterisk.conf, it defaults to that system name
-- 
2.47.2