From ed200ae888d270810e3bb8ce5698197049f3d02a Mon Sep 17 00:00:00 2001 From: russell Date: Wed, 21 Jul 2010 13:02:46 +0000 Subject: Update documentation for 'comebacktoorigin' in featuers.conf. The documentation for this option did not match the code. Fix that along with some minor cleanups to the code along the way. Document a slight change in behavior (to something that was previously undocumented) in UPGRADE.txt. git-svn-id: http://svn.digium.com/svn/asterisk/trunk@278425 f38db490-d61c-443f-a65b-d21fe96a405b --- configs/features.conf.sample | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) (limited to 'configs') diff --git a/configs/features.conf.sample b/configs/features.conf.sample index 84a0ee06c..eb04c3c41 100644 --- a/configs/features.conf.sample +++ b/configs/features.conf.sample @@ -11,9 +11,33 @@ context => parkedcalls ; Which context parked calls are in (default parking lot ;parkinghints = no ; Add hints priorities automatically for parking slots (default is no). ;parkingtime => 45 ; Number of seconds a call can be parked for ; (default is 45 seconds) -;comebacktoorigin = yes ; Whether to return to the original calling extension upon parking - ; timeout or to send the call to context 'parkedcallstimeout' at - ; extension 's', priority '1' (default is yes). + +;comebacktoorigin = yes ; Setting this option configures the behavior of call parking when the + ; parked call times out (See the parkingtime option). The default value is 'yes'. + ; + ; 'yes' - When the parked call times out, attempt to send the call back to the peer + ; that parked this call. This is done by saving off the name of the channel + ; that parked the call. + ; + ; 'no' - This option is useful for performing custom dialplan functionality prior to + ; sending the call back to the extension that initially parked the call, or to + ; an entirely different destination. + ; + ; When the parked call times out, send it back to the dialplan. The location + ; will be the 'parkedcallstimeout' context. The extension will be built from + ; the saved channel name that parked the call. For example, if a SIP peer named + ; '0004F2040001' parked this call, the extension will be 'SIP_0004F2040001'. + ; (Note that an underscore is used here because the '/' character has a special + ; meaning in extension names for CallerID matching.) If this extension does not + ; exist, the call will be sent to the 's' extension, instead. Finally, if the 's' + ; extension of 'parkedcallstimeout' does not exist, the call will fall back to the + ; 's' extension of the 'default' context. + ; + ; Additionally, in this example an extension of 'SIP_0004F2040001' will be + ; created in the 'park-dial' context. This extension will be set up to do a + ; Dial() to 'SIP/0004F2040001'. + ; + ;courtesytone = beep ; Sound file to play to the parked caller ; when someone dials a parked call ; or the Touch Monitor is activated/deactivated. -- cgit v1.2.3