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: https://origsvn.digium.com/svn/asterisk/trunk@278425 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
2010-07-21 13:02:46 +00:00
parent a8c843199c
commit a9e49f4e45
3 changed files with 46 additions and 13 deletions

View File

@@ -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.