[Asterisk-doc] docs extensions.xml,1.2,1.3

Jared Smith asterisk-doc@lists.digium.com
Sun, 11 Jan 2004 23:13:21 -0700


Thanks critch!

Jared

On Sun, 2004-01-11 at 21:42, drunken_critch wrote:
> Comments:
> Update of /cvsroot/asterisk/docs
> In directory sc8-pr-cvs1:/tmp/cvs-serv21690
> 
> Modified Files:
> 	extensions.xml 
> Log Message:
> Added some changes that had been suggested since last time the list saw this
> file. Also added the Absolute Timeout special extension mentioned on the user
> list fairly recently.
> Index: extensions.xml
> ===================================================================
> RCS file: /cvsroot/asterisk/docs/extensions.xml,v
> retrieving revision 1.2
> retrieving revision 1.3
> diff -C2 -d -r1.2 -r1.3
> *** extensions.xml	11 Jan 2004 08:43:28 -0000	1.2
> --- extensions.xml	12 Jan 2004 04:42:27 -0000	1.3
> ***************
> *** 68,72 ****
>   			</programlisting>
>   			<para>
> ! 			From this example you should be able to notice that contexts can be
>   			used to reduce retyping sections as in the worker_extensions being
>   			included in all the example contexts.
> --- 68,72 ----
>   			</programlisting>
>   			<para>
> ! 			From this example you should notice that contexts can be
>   			used to reduce retyping sections as in the worker_extensions being
>   			included in all the example contexts.
> ***************
> *** 108,111 ****
> --- 108,112 ----
>   			<member>'t' - timeout</member>
>   			<member>'h' - hangup</member>
> + 			<member>'T' - Absolute Timeout</member>
>   			</simplelist>
>   			<para>
> ***************
> *** 116,120 ****
>   			<para>
>   			Hangup is where calls will go to when hangup is detected, or where
> ! 			you can send calls that you want to hangup on.
>   			</para>
>   			<para>
> --- 117,124 ----
>   			<para>
>   			Hangup is where calls will go to when hangup is detected, or where
> ! 			you can send calls that you want to hangup on. There are
> ! 			currently some problems to be aware of. Specifically the
> ! 			variables about the call are lost as the information is
> ! 			destroyed with the channel. 
>   			</para>
>   			<para>
> ***************
> *** 130,133 ****
> --- 134,145 ----
>   			back to the extension that contains the menu prompts.
>   			</para>
> + 			Absolute Timeout is a used when a call is being terminated for
> + 			exceeding a Absolute Timeout variable set. Be aware of the case
> + 			difference from the normal timeout. This can be used to warn
> + 			a user that they exceeded some allowable limit. Or it could be used
> + 			to request someone to try calling back later if they waited in a
> + 			queue too long. Essentially it should notify the caller that they
> + 			are being disconnected so as not to leave them with the impression
> + 			they had been cut off unintendedly.
>   			<programlisting>
>   			[My_home_incoming_context]
> ***************
> *** 214,218 ****
>   
>   		<lineannotation>; This is where the user can't decide who to call, so we ring everyone</lineannotation>
> ! 		exten =&gt; t,1,Dial(${ALL)
>   		</programlisting>
>   		<para>
> --- 226,230 ----
>   
>   		<lineannotation>; This is where the user can't decide who to call, so we ring everyone</lineannotation>
> ! 		exten =&gt; t,1,Dial(${ALL})
>   		</programlisting>
>   		<para>
> ***************
> *** 230,233 ****
> --- 242,268 ----
>   		use with a GotoIf function for call flow.
>   		</para>
> + 		<programlisting>
> + 		[incoming]
> + 		include =&gt; extensions
> + 
> + 		exten =&gt; s,1,Wait(1)
> + 		exten =&gt; s,2,SetVar(counter=0)
> + 		exten =&gt; s,3,Answer()
> + 		exten =&gt; s,4,DigitTimeout(15)
> + 		exten =&gt; s,5,ResponseTimeout(10)
> + 		exten =&gt; s,6,Background(hello)
> + 		
> + 		exten =&gt; t,1,SetVar(counter=[${counter}+1])
> + 		exten =&gt; t,2,Gotoif([${counter}&lt;3]?s,6:h,1)
> + 
> + 		exten =&gt; h,1,hangup() 
> + 		</programlisting>
> + 		<para>
> + 		This example shows using the timeout to force the call to continue
> + 		moving. In this case, we add 1 to the counter variable and decide if we
> + 		exceeded an acceptable number of prompt repeats. If it exceeds this
> + 		limit, then we push the call to the hangup extension and let it clean
> + 		things up. 
> + 		</para>
>   	</sect1>
>   	<sect1>
> ***************
> *** 290,294 ****
>   		<para>
>   		You may be used to noticing that 9 is associated with dialing
> ! 		an outside line. This is due to the fact that in a local
>   		calling area, the exchanges could over lap other sections of
>   		your dialplan. Similarly you may have noticed that with in
> --- 325,330 ----
>   		<para>
>   		You may be used to noticing that 9 is associated with dialing
> ! 		an outside line, at least in the USA. Others may be used to seeing 
> ! 		other digits such as 0. This is due to the fact that in a local
>   		calling area, the exchanges could over lap other sections of
>   		your dialplan. Similarly you may have noticed that with in
> _______________________________________________
> Asterisk-Doc mailing list
> Asterisk-Doc@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-doc