@@ -1,6 +1,6 @@

 <!-- $Id$ -->

 <!-- DOCTYPE Book SYSTEM "/usr/share/sgml/docbook/dtd-4.2/docbook.dtd" [ -->

-<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [ 

+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ 

 <!ENTITY execexample SYSTEM "../../examples/exec.cfg">

@@ -4602,10 +4602,10 @@ Domain Registered Expired

 	    <itemizedlist id="routeblocks">

 		<title>Route Blocks and Process Control</title>

-		<para>

+		<!--<para>

 		    Route block and process control keywords determine

 		    the order in which SIP requests are processed.

-		</para>

+		</para>-->

 		<listitem>

 		    <para>

 			<command>route[number]{...}</command> - This marks a "route block" in configuration files.

@@ -1,3 +1,6 @@

+<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ ]>

+<section>

+<title>Introduction</title>

 <para>

 	The voicemail system provides <application>ser</application>

 	with voice announcement and recording capabilities. Voice

@@ -8,127 +11,160 @@

 	handling as described in RFC 3264 (An Offer/Answer Model with

 	the Session Description Protocol) and RFC 1889 (Real time

 	transport protocol) to realize its goal.

-

 </para>

+</section>

 <section>

+

 <title>Advantages</title>

-	<para>

-            Anyone deploying <application>ser</application> and

-	    <acronym>VoIP</acronym> should profit from this 'ready-to-run'

-	    application. It plugs into <application>ser</application> as

-	    easy as configuring the database location, announce file path

-	    and SMTP server address. 

-	</para>

-	<para>

-	    Further,

-	    <application>voicemail</application>

-	    integrates the most popular free codecs

-	    (G.711ulaw, G.711alaw and GSM 06.10) and

-	    its own SMTP client, which means that you

-	    don't need to install anything else as

-	    <application>ser</application> and

-	    <application>voicemail</application>. 

-	</para>

-	<para>

-	    If you want your voicemail system to support

-	    other codecs, a simple plugin system with

-	    SDK alows you to integrate them fast and

-	    simply (see the basis plugins for examples). 

-	</para>

+<para>

+	<itemizedlist>

+		<listitem>

+			<para>

+		            Anyone deploying <application>ser</application> and

+			    <acronym>VoIP</acronym> should profit from this 'ready-to-run'

+			    application. It plugs into <application>ser</application> as

+			    easy as configuring the database location, announce file path

+			    and SMTP server address. 

+			</para>

+	        </listitem>

+	        <listitem>

+			<para>

+			    Further,

+			    <application>voicemail</application>

+			    integrates the most popular free codecs

+			    (G.711ulaw, G.711alaw and GSM 06.10) and

+			    its own SMTP client, which means that you

+			    don't need to install anything else as

+			    <application>ser</application> and

+			    <application>voicemail</application>. 

+			</para>

+	        </listitem>

+	        <listitem>

+			<para>

+			    If you want your voicemail system to support

+			    other codecs, a simple plugin system with

+			    SDK alows you to integrate them fast and

+			    simply (see the basis plugins for examples). 

+			</para>

+	        </listitem>

+	</itemizedlist>

+</para>

 </section>

 <section>

+

 <title>Technical limitations</title>

-	<para>

-	    The sound conversion engine doesn't

-	    support yet resampling. It means that

-	    input and output files have to be

-	    compatible with the sampling rate of the

-	    codec. All codecs included with the

-	    distribution work at 8kHz, which means

-	    that all the input and output files MUST

-	    be sampled at the rate of 8kHz.

-	</para>

-	<para>

-	    At the moment, voicemail only support the

-	    Microsoft Wav file format with PCM 16 bit,

-	    Mu-law and A-law 8 bit encoding.

-	</para>

+<para>

+	<itemizedlist>

+		<listitem>

+		    <para>

+		            The sound conversion engine doesn't

+			    support yet resampling. It means that

+			    input and ouput files have to be

+			    compatible with the sampling rate of the

+			    codec. All codecs included with the

+			    distribution work at 8kHz, which means

+			    that all the input and output files MUST

+			    be sampled at the rate of 8kHz.

+		    </para>

+		</listitem>

+		<listitem>

+		    <para>

+		            At the moment, voicemail only support the

+			    Microsoft Wav file format with PCM 16 bit,

+			    Mu-law and A-law 8 bit encoding.

+		    </para>

+		</listitem>

+	</itemizedlist>

+</para>

 </section>

+<section>

+<title>Compilation and installation</title>

+<para>

+        <itemizedlist>

+		<listitem>

+			<para>

+			First, you need to compile Ser with voicemail

+			support. Thatfor, you must edit Ser's

+			Makefile.defs file and uncomment the line with

+			'-DVOICE_MAIL' and '-D_TOTAG'.

+			</para>

+		</listitem>

+		<listitem>

+			<para>

+			Then do 'make all' in Ser's root directory.

+			</para>

+		</listitem>

+		<listitem>

+			<para>

+			Configure Ser to fit your needs. You can

+			report to voicemail example config file to

+			know what your configuration file should

+			include. Note that voicemail

+			only needs to know the user database location

+			in order to work. Report to the README file in

+			the vm module directory for description of the

+			functions and variable that are used by

+			voicemail and how they work.

+			</para>

+		</listitem>

+		<listitem>

+			<para>

+			Finally, compile the voicemail application:

+

+			<programlisting>

+			[~/voicemail]$ cd ortp-0.5.0

+			[~/voicemail/ortp-0.5.0]$ ./configure

+			[~/voicemail/ortp-0.5.0]$ make all

+			[~/voicemail/ortp-0.5.0]$ cd ..

+			[~/voicemail]$ cd plug-in/gsm/gsm-????

+			[~/voicemail/plug-in/gsm/gsm-????]$ make all

+			[~/voicemail/plug-in/gsm/gsm-????]$ cd ../..

+			[~/voicemail]$ make all

+			</programlisting>

+

+			You can then start voicemail with following

+			command <command>ans_machine</command> and

+			look if the default fit your needs. If not,

+			type <command>ans_machine -h</command> to see

+			how to change the default parameters.

+

+			  <!--<note>-->

+			  If <application>ans_machine</application> is

+			  not started or can't be joined while

+			  <application>ser</application> tries to

+			  communicate with it, the caller will become

+			  a '500 internal server error' with a comment

+			  saying what the trouble is.

+			  <!--</note>-->

+			</para>

+		</listitem>

+	</itemizedlist>

+</para>

+</section>

 <section>

-<title>Compilation and installation</title>

-	<para>

-	    First, you need to compile Ser with voicemail

-	    support. Therefore, you must edit Ser's

-	    Makefile.defs file and uncomment the line with

-	    '-DVOICE_MAIL' and '-D_TOTAG'.

-	</para>

-	<para>

-	    Then do 'make all' in Ser's root directory.

-	</para>

-	<para>

-	    Configure Ser to fit your needs. You can

-	    report to voicemail example config file to

-	    know what your configuration file should

-	    include. Note that voicemail

-	    only needs to know the user database location

-	    in order to work. Report to the README file in

-	    the vm module directory for description of the

-	    functions and variable that are used by

-	    voicemail and how they work.

-	</para>

-	<para>

-	    Finally, compile the voicemail application:

-	</para>

-	<para>

-	    <programlisting>

-		[~/voicemail]$ cd ortp-0.5.0

-		[~/voicemail/ortp-0.5.0]$ ./configure

-		[~/voicemail/ortp-0.5.0]$ make all

-		[~/voicemail/ortp-0.5.0]$ cd ..

-		[~/voicemail]$ cd plug-in/gsm/gsm-????

-		[~/voicemail/plug-in/gsm/gsm-????]$ make all

-		[~/voicemail/plug-in/gsm/gsm-????]$ cd ../..

-		[~/voicemail]$ make all

-	    </programlisting>

-	</para>

-	<para>

-		You can then start voicemail with following

-		command <command>ans_machine</command> and

-		look if the default fit your needs. If not,

-		type <command>ans_machine -h</command> to see

-		how to change the default parameters.

-	</para>

-	<para>

-		If <application>ans_machine</application> is

-		not started or can't be joined while

-		<application>ser</application> tries to

-		communicate with it, the caller will become

-		a '500 internal server error' with a comment

-		saying what the trouble is.

-	</para>

+<title>Example ser Config File</title>

+<para>

 	<example>

                 <title>Example ser Config File</title>

 		<programlisting>

 &voicemailcfg;

 		</programlisting>

 	</example>

+</para>

 </section>

 <section>

-<title>Availability, report bugs, contact the author</title>

-<para>

-        Ser's Voicemail is hosted at

-	<ulink

-	url="http://developer.berlios.de/projects/sems">http://developer.berlios.de/projects/sems</ulink>.

-	A snapshot may be downloaded directly from the CVS tree. A

-	pre-configured version of <application>ser</application>

-	including <application>voicemail</application> will be soon

-	available (starting from version 0.8.11). 

-</para>

+

+<title>Availabilty, report bugs, contact the author</title>

 <para>

-        Bugs can be directly reported at the voicemail's project page. If you

-        want to contact the author, use the contact email at the

-        project's web page.

+        Ser's Voicemail's home page is hosted at

+	http://sems.berlios.de. A snapshot may be downloaded directly

+	from the CVS tree. A pre-configured version of 

+	<application>ser</application> including

+	<application>voicemail</application> will be soon available

+	(from version 0.8.11). Bugs can be reported at the voicemail's

+	home page. If you want to contact the author, use the contact

+	email at the home page.

 </para>

 </section>