[Asterisk-doc] docs extensions.xml,1.14,1.15

[websmith]

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

Modified Files:
	extensions.xml 
Log Message:
Added a few more notes, and changed some formatting and wording
Index: extensions.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/extensions.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** extensions.xml	26 May 2004 03:47:37 -0000	1.14
--- extensions.xml	28 May 2004 04:04:12 -0000	1.15
***************
*** 6,18 ****
  	extension is dialed.  The dialplan consists of a list of instuctions or steps 
  	that Asterisk should follow.  It is <emphasis>absolutely vital</emphasis> that
! 	 you understand dialplans if you want to setup an Asterisk system.  
  	</para>
  	
  	<sect1>
! 		<title>Introduction to <filename>extensions.conf</filename></title>
  		<para>
  		The majority of the dialplan is specified in the file 
  		<filename>extension.conf</filename>.  This file is made up of three main 
! 		parts: contexts, extensions, and priorities.
  		</para>
  		
--- 6,33 ----
  	extension is dialed.  The dialplan consists of a list of instuctions or steps 
  	that Asterisk should follow.  It is <emphasis>absolutely vital</emphasis> that
! 	you understand dialplans if you want to setup an Asterisk system.  
! 	</para>
! 	<para>
! 	[Explain that the dial plan is a road map]
  	</para>
  	
  	<sect1>
! 		<title>Introduction to creating dialplans</title>
  		<para>
  		The majority of the dialplan is specified in the file 
  		<filename>extension.conf</filename>.  This file is made up of three main 
! 		parts: contexts, extensions, and priorities.  In most Asterisk installations,
! 		the <filename>extensions.conf</filename> file is located in either 
! 		<filename class="directory">/etc/asterisk</filename> or 
! 		<filename class="directory">/usr/local/asterisk/etc</filename>.  The location
! 		of your <filename>extensions.conf</filename> may vary, depending on how you
! 		installed Asterisk.
! 		</para>
! 		<para>
! 		If you installed the Asterisk sample files, you probably have an existing
! 		<filename>extensions.conf</filename> file.  Instead of explaining or
! 		modifying the existing file, we'll start from scratch in creating an
! 		<filename>extensions.conf</filename> file, so that you can learn about
! 		how each part of the file plays a role in the dialplan.
  		</para>
  		
***************
*** 387,391 ****
  			and we'll show them how to do that in a different section of the book.]
  			</para>
! 			
  			<para>
  			[By this section of the chapter, the reader should understand Answer(), 
--- 402,418 ----
  			and we'll show them how to do that in a different section of the book.]
  			</para>
! 			<informalexample>
! 			<programlisting>
! 			[incoming]
! 			exten=&gt;s,1,Answer()<lineannotation> ; Answer the line</lineannotation>
! 			exten=&gt;s,2,Background('current-movies')<lineannotation> ; Play back the 'current movies' sound file</lineannotation>
! 			exten=&gt;s,3,Hangup()<lineannotation> ; Now hangup the line if the caller doesn't press a key</lineannotation>
! 			exten=&gt;1,1,Playback('movie1')<lineannotation> ; Now hangup the line if the caller doesn't press a key</lineannotation>
! 			exten=&gt;1,2,Goto(incoming,s,1)<lineannotation> ; Now go back to the beginning</lineannotation>
! 			exten=&gt;2,1,Playback('movie2')<lineannotation> ; Now hangup the line if the caller doesn't press a key</lineannotation>
! 			exten=&gt;2,2,Goto(incoming,s,1)<lineannotation> ; Now go back to the beginning</lineannotation>
! 			exten=&gt;0,1,Dial(Zap/1)
! 			</programlisting>
! 			</informalexample>	
  			<para>
  			[By this section of the chapter, the reader should understand Answer(),