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

[drunken_critch]

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