[Asterisk-doc] docs extensions.xml,1.24,1.25

[websmith]

Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv2484

Modified Files:
	extensions.xml 
Log Message:
More work on the dialplan chapter... 
Index: extensions.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/extensions.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -C2 -d -r1.24 -r1.25
*** extensions.xml	15 Jul 2004 04:21:46 -0000	1.24
--- extensions.xml	19 Jul 2004 01:38:22 -0000	1.25
***************
*** 303,309 ****
  			<programlisting>
  			[incoming]
! 			exten=&gt;s,1,Answer()<lineannotation> ; Answer the line</lineannotation>
! 			exten=&gt;s,2,Playback('vm-goodbye')<lineannotation> ; Play back the 'goodbye' sound file</lineannotation>
! 			exten=&gt;s,3,Hangup()<lineannotation> ; Now hangup the line</lineannotation>
  			</programlisting>
  			</informalexample>
--- 303,309 ----
  			<programlisting>
  			[incoming]
! 			exten=&gt;s,1,Answer()<!--<lineannotation> ; Answer the line</lineannotation>-->
! 			exten=&gt;s,2,Playback('vm-goodbye')<!--<lineannotation> ; Play back the 'goodbye' sound file</lineannotation>-->
! 			exten=&gt;s,3,Hangup()<!--<lineannotation> ; Now hangup the line</lineannotation>-->
  			</programlisting>
  			</informalexample>
***************
*** 319,341 ****
  			<para>
  			When a call is sent into this [incoming] context, it will first go to 
! 			's' extension. As we learned earlier, calls usually begin start in the 
! 			's' extension.  We have three priorities in this context, numbered
! 			 1, 2 and 3.  Each priority calls a particular application.
  			</para>
  
  			<para>
! 			Now let's look at what each priority does.  Our first priority 
! 			calls the <function>Answer()</function> application.  Asterisk then 
! 			takes control of the line and sets up the call.  After answering the 
! 			line, Asterisk goes on to the next priority.  In our second
! 			priority, we call the <function>Playback()</function> application.  
! 
! <!-- continue editing from here -->
! 		This will play a
! 			sound file as specified by the filename.  In our example we will play the file
! 			<filename>vm-goodbye</filename>.  The user will hear Allison saying "goodbye".
! 			Notice that there is no filename extension.  Asterisk will determine the type of
! 			file.  For our third and final line, we will perform the <function>Hangup()</function>
! 			function and thus drop the line.
  			</para>
  		</sect2>
--- 319,340 ----
  			<para>
  			When a call is sent into this [incoming] context, it will first go to 
! 			's' extension. As we learned earlier, calls usually begin in the 
! 			's' extension.  We have three priorities in this context, numbered 
! 			1, 2 and 3.  Each priority calls a particular application.  Let's
! 			take a closer look at these three priorities.
  			</para>
  
  			<para>
! 			Our first priority calls the <function>Answer()</function> 
! 			application.  Asterisk then takes control of the line and sets up the 
! 			call.  After answering the line, Asterisk goes on to the next 
! 			priority.  In our second priority, we call the 
! 			<function>Playback()</function> application.  This will play a sound 
! 			file as specified by the filename.  In our example we will play the 
! 			file <filename>vm-goodbye</filename>.  The caller will hear a voice 
! 			say "goodbye".  Notice that there is no filename extension.  
! 			Asterisk will automatically determine the extension of the sound file.  
! 			In our third and final priority line, we call the 
! 			<function>Hangup()</function> function and thus end the call.
  			</para>
  		</sect2>
***************
*** 343,356 ****
  		<sect2>
  			<title>A more useful example</title>
! <!--			<para>
! 			[Here we'll build upon our first example, by explaining the 
! 			<function>Background()</function> and <function>Goto()</function> functions.]
  			</para>
! -->
  			<para>
! 			Here we will build upon our first example and learn the <function>
! 			Background()</function> and <function>Goto()</function> functions.
  			</para>
! 			
  			<informalexample>
  			<programlisting>
--- 342,362 ----
  		<sect2>
  			<title>A more useful example</title>
! 			<para>
! 			Now that we've gone through a simple example, let's build upon it
! 			by learning about the <function>Background()</function> and 
! 			<function>Goto()</function> functions. These two functions will
! 			allows us to create more functional dialplan.
! 			In this example, let's assume we've been asked by a local movie
! 			theater to create a system where callers can dial in and listen
! 			to pre-recorded movie listings.
  			</para>
! <!-- continue editing from here -->
! <!--
  			<para>
! 			[The key any IVR is the background() application.  it gives you the ability to 
! 			play a recorded sound file, but when the caller presses a key it interrupts the
! 			playback and goes to the corresponding extension]
  			</para>
! -->			
  			<informalexample>
  			<programlisting>