[Asterisk-doc] docs conf-files.xml,1.4,1.5

[blitzrage]

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

Modified Files:
	conf-files.xml 
Log Message:
Mike Preston
- basic voicemail configuration example in chapter 3.  More to follow.
Index: conf-files.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/conf-files.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** conf-files.xml	31 May 2004 13:36:00 -0000	1.4
--- conf-files.xml	31 May 2004 17:12:48 -0000	1.5
***************
*** 221,225 ****
  		<sect2>
  			<title>voicemail.conf</title>
! 			<para/>
  		</sect2>
  		<sect2>
--- 221,329 ----
  		<sect2>
  			<title>voicemail.conf</title>
! 			<para>
! 			The voicemail subsystem of asterisk is a powerful tool, able to send emails 
! 			on the receipt of voicemail, cope with different timezone for different 
! 			users and even do voicemail virtual hosting.			
! 			</para>
! 
! 			<para>
! 			Voicemail is configured using the voicemail.conf file in the 
! 			<filename class='directory'>/etc/asterisk</filename> directory by default. 
! 			A simple example is shown below.
! 			</para>
! 
! 			<para>
! 			voicemail.conf
! 			</para>
! 
! 			<informalexample>
! 			<programlisting>
! 			general]
! 			format=wav|wav49|gsm
! 			serveremail=root@localhost
! 			attach=yes
! 			maxmessage=180
! 			maxgreet=60
! 
! 			[default]
! 			2000 => 4321,Jeffery Alterton,jeff@example.com
! 			</programlisting>
! 			</informalexample>
! 
! 			<para>
! 			This is about as simple as you can get for the voicemail system, setting up 
! 			a single mailbox and sending an email with the message attached when a 
! 			voicemail is left.			
! 			</para>
! 
! 			<para>
! 			In the dial plan voicemail would be ran using something like one of the 
! 			following examples.			
! 			</para>
! 
! 			<para>
! 			extensions.conf
! 			</para>
! 
! 			<informalexample>
! 			<programlisting>
! 			[default]
! 			exten => 2000,1,Answer  <lineannotation>; answer the channel</lineannotation>
! 			exten => 2000,2,Dial(SIP/2000,16,tr)  <lineannotation>; dial channel supplied by ${ARG1}</lineannotation>
! 			exten => 2000,3,Voicemail(u2000) <lineannotation>; if no answer, goto unavailable vm</lineannotation>
! 			exten => 2000,4,Hangup  <lineannotation>; hangup the channel</lineannotation>
! 			exten => 2000,103,Voicemail(b2000)  <lineannotation>; if the channel is busy, goto busy vm</lineannotation>
! 			exten => 2000,104,Hangup  <lineannotation>; hangup the channel</lineannotation>
! 			</programlisting>
! 			</informalexample>
! 
! 			<para>
! 			In this example if extension 2000 is dialled then the call is answered and 
! 			extension 2000 is dialed over sip (see the [2000] section of sip.conf) if 
! 			the call fails due to being unavailible then it continues running at the 
! 			next step which in this example is the voicemail system with an unavailible 
! 			message. If the call fails due to being busy the flow jumps to priority 
! 			n+101 (2+101 in this example see the section on the extensions.conf file 
! 			for more details) and starts running from there. Which in this example is 
! 			voicemail with a busy anouncement. In both cases after voicemail is finished 
! 			the call is hung up.
! 			</para>
! 
! 			<para>
! 			To access your voicemail you need a different application. This application 
! 			is called <function>VoicemailMain</function> and is shown in the example below.
! 			</para>
! 
! 			<informalexample>
! 			<programlisting>
! 			exten => 1000,1,Answer
! 			exten => 1000,2,VoicemailMain()
! 			exten => 1000,3,HangUp
! 			</programlisting>
! 			</informalexample>
! 
! 			<para>
! 			Now when the user dials extension 1000 they will be prompted to enter their 
! 			voicemailbox and pin and dropped into the voicemail system to listen to messages.
! 			</para>
! 
! 			<para>
! 			VoicemailMain can also take the mailbox number to drop them into requesting 
! 			only a pin in this case.
! 			</para>
! 
! 			<informalexample>
! 			<programlisting>
! 			exten => 1000,1,Answer
! 			exten => 1000,2,VoicemailMain(${CALLERIDNUM})
! 			exten => 1000,3,HangUp
! 			</programlisting>
! 			</informalexample>
! 
! 			<para>
! 			This example would detect the extension the caller is coming from and drop 
! 			them into the voicemail system.
! 			</para>
! 			
  		</sect2>
  		<sect2>