[Asterisk-doc] docs extensions.xml,1.31,1.32

websmith asterisk-doc@lists.digium.com
Thu, 29 Jul 2004 04:17:50 +0000


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

Modified Files:
	extensions.xml 
Log Message:
More minor changes, a little more explanation on the first movie theater 
example, and a paragraph leading up to the second movie theater example.
Index: extensions.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/extensions.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -C2 -d -r1.31 -r1.32
*** extensions.xml	27 Jul 2004 13:52:04 -0000	1.31
--- extensions.xml	29 Jul 2004 04:17:44 -0000	1.32
***************
*** 347,351 ****
  			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
  			allow us to create dialplans with much more functionality.
  			</para>
--- 347,351 ----
  			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> applications. These two applications will
  			allow us to create dialplans with much more functionality.
  			</para>
***************
*** 357,361 ****
  			the extension that corresponds with what the caller dialed.
  			</para>
- <!-- continue editing from here -->
  			<para>
  			Another very useful application is called 
--- 357,360 ----
***************
*** 425,429 ****
  -->
  			<para>
! 			Lets step through our example very carefully.  When the call enters the 
  			system, Asterisk executes the 's' extension automatically, starting 
  			with priority one.  You may notice that the 's' extesion looks almost
--- 424,428 ----
  -->
  			<para>
! 			Lets go through this example step by step.  When the call enters the 
  			system, Asterisk executes the 's' extension automatically, starting 
  			with priority one.  You may notice that the 's' extesion looks almost
***************
*** 441,456 ****
  			<para>
  			Now that the user has pressed '1',  Asterisk can perform both 
! 			priorities for extension 1, which end up being lines 4 and 5.  The 
! 			first priority for extension 1 will use the 
! 			<function>Playback()</function> application to play the movie details 
! 			for screen one.  After the file finishes playing, it will execute 
! 			the second priority, which is a call to the <function>Goto()</function> 
! 			application.
  			</para>
  
  			<para>
! 			<function>Goto()</function> allows us to send the caller anywhere in our
! 			dialplan.  The format for <function>Goto()</function> is 
! 			(context,extension,priority).  In our example <command>
  			exten =&gt; 1,2,Goto(incoming,s,1)</command> we will send the user back to
  			the first priority of the 's' extension in our current context.
--- 440,453 ----
  			<para>
  			Now that the user has pressed '1',  Asterisk can perform both 
! 			priorities for extension 1.  The first priority for extension 
! 			1 will use the <function>Playback()</function> application to 
! 			play the movie details for screen one.  After the file finishes 
! 			playing, it will execute the second priority, which is a call 
! 			to the <function>Goto()</function> application.
  			</para>
  
  			<para>
! 			Remember that <function>Goto()</function> allows us to send the 
! 			caller somewhere else in our dialplan. In our example <command>
  			exten =&gt; 1,2,Goto(incoming,s,1)</command> we will send the user back to
  			the first priority of the 's' extension in our current context.
***************
*** 461,469 ****
  			application finishes playing the file, the third priority of our 's' extension
  			will be performed, hanging up the user.  This is probably not the best way
! 			to handle incoming calls, but gives us some fundamentals and gets us 
! 			thinking about how we can move the user around our dialplan.
  			</para>
  		</sect2>
! 		
  		<sect2>
  			<title>The <function>Dial()</function> application</title>
--- 458,477 ----
  			application finishes playing the file, the third priority of our 's' extension
  			will be performed, hanging up the user.  This is probably not the best way
! 			to handle incoming calls, but gives us a good example of how we can
! 			manipulate calls.
! 			</para>
! 			<para>
! 			If the caller presses <keycap>2</keycap>, then the sound file for
! 			movie screen number two is played, and then the caller is sent back
! 			to the 's' extension.
! 			</para>
! 			<para>
! 			As you can see, it's quite simple to create interactive dialplans
! 			(often referred to as auto-attendants or voice menus) in Asterisk.
! 			In less than ten lines, we've been able to create a dialplan that
! 			could really be used.  Now let's add additional functionality.
  			</para>
  		</sect2>
! <!-- continue editing from here -->
  		<sect2>
  			<title>The <function>Dial()</function> application</title>
***************
*** 476,480 ****
  -->
  			<para>
! 			We are going to add to our movie theatre example by showing the use of the
  			<function>Dial()</function> application.  If someone presses 0 during playback
  			it will ring the ticket office.  We are going to assume that the channel for
--- 484,488 ----
  -->
  			<para>
! 			We are going to add to our movie theater example by showing the use of the
  			<function>Dial()</function> application.  If someone presses 0 during playback
  			it will ring the ticket office.  We are going to assume that the channel for