[Asterisk-doc] docs bookinfo.xml,1.6,1.7 chapter07.xml,1.6,1.7

blitzrage asterisk-doc@lists.digium.com
Mon, 29 Dec 2003 16:28:34 +0000


Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1:/tmp/cvs-serv21883/docs

Modified Files:
	bookinfo.xml chapter07.xml 
Log Message:
blitzrage
- fix some minor typos and docbook formatting in Nick Bachmann's excellent
	chapter 7 submission
- added Nick Bachmann to the authors listing on the cover in bookinfo.xml
Index: bookinfo.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/bookinfo.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** bookinfo.xml	22 Dec 2003 07:10:17 -0000	1.6
--- bookinfo.xml	29 Dec 2003 16:28:28 -0000	1.7
***************
*** 29,32 ****
--- 29,36 ----
  			<surname>Grace</surname>
  		</author>
+ 		<author>
+ 			<firstname>Nick</firstname>
+ 			<surname>Bachmann</surname>
+ 		</author>
  	</authorgroup>
  	<copyright>
***************
*** 43,47 ****
  			and conditions set forth in the Open Publication License, v1.0 or later
  			(the latest version is presently available at
! 			<ulink url=" http://www.opencontent.org/openpub/" type="http">http://www.opencontent.org/openpub/</ulink> )
  		</para>
  	</legalnotice>
--- 47,51 ----
  			and conditions set forth in the Open Publication License, v1.0 or later
  			(the latest version is presently available at
! 			<ulink url=" http://www.opencontent.org/openpub/" type="url">http://www.opencontent.org/openpub/</ulink> )
  		</para>
  	</legalnotice>
Index: chapter07.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/chapter07.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** chapter07.xml	29 Dec 2003 15:47:17 -0000	1.6
--- chapter07.xml	29 Dec 2003 16:28:28 -0000	1.7
***************
*** 9,17 ****
  			<title>Proper Version of MPG123</title>
  			<para>
! 			Music on Hold requires mpg123. Note that mpg321, which is often is often linked to /usr/bin/mpg123,
  			will not work. Additionally, mpg123 must be installed in /usr/bin. 
  			</para>
  			<para>
! 			mpg134 can be downloaded from <ulink url="http://www.mpg123.de" type="http">http://www.mpg123.de</ulink>.
  			Before compiling mpg123, change the line in the Makefile that reads
  			<programlisting>
--- 9,17 ----
  			<title>Proper Version of MPG123</title>
  			<para>
! 			Music on Hold requires mpg123. Note that mpg321, which is often linked to /usr/bin/mpg123,
  			will not work. Additionally, mpg123 must be installed in /usr/bin. 
  			</para>
  			<para>
! 			mpg123 can be downloaded from <ulink url="http://www.mpg123.de" type="url">http://www.mpg123.de</ulink>.
  			Before compiling mpg123, change the line in the Makefile that reads
  			<programlisting>
***************
*** 20,24 ****
  			to
  			<programlisting>
!                                 PREFIX=/usr
  			</programlisting>
  			After making the change, mpg123 can be compiled as described in its documentation.
--- 20,24 ----
  			to
  			<programlisting>
! 				PREFIX=/usr
  			</programlisting>
  			After making the change, mpg123 can be compiled as described in its documentation.
***************
*** 40,44 ****
  				in this guide.
  				</para>
! 			</sect3><sect3>
  				<title>ztdummy</title>
  				<para>
--- 40,45 ----
  				in this guide.
  				</para>
! 			</sect3>
! 			<sect3>
  				<title>ztdummy</title>
  				<para>
***************
*** 49,62 ****
  				Makefile in zaptel source directory for editing.  Find the line that reads
  				<programlisting>
- 					<literallayout>
  					MODULES=zaptel.o tor2.o torisa.o wcusb.o wcfxo.o wcfxs.o \
  					        ztdynamic.o ztd-eth.o wct1xxp.o wct4xxp.o # ztdummy.o
- 					</literallayout>
  				</programlisting>
  				and remove the # before 'ztdummy.o'.  From there, run <command>make</command> and
  				<command>make install</command> as usual.  Before running Asterisk, you'll need to
! 				load the ztdummy driver by running <command>modproble ztdummy</command>. 
  				</para>
! 			</sect3><sect3>
  				<title>zaprtc</title>
  				<para>
--- 50,62 ----
  				Makefile in zaptel source directory for editing.  Find the line that reads
  				<programlisting>
  					MODULES=zaptel.o tor2.o torisa.o wcusb.o wcfxo.o wcfxs.o \
  					        ztdynamic.o ztd-eth.o wct1xxp.o wct4xxp.o # ztdummy.o
  				</programlisting>
  				and remove the # before 'ztdummy.o'.  From there, run <command>make</command> and
  				<command>make install</command> as usual.  Before running Asterisk, you'll need to
! 				load the ztdummy driver by running <command>modprobe ztdummy</command>. 
  				</para>
! 			</sect3>
! 			<sect3>
  				<title>zaprtc</title>
  				<para>
***************
*** 64,68 ****
  				Note, however, that ztrtc does not work on multiprocessor systems.  ztrtc does not
  				come with Asterisk but is available from 
! 				<ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>.
  				</para>
  			</sect3>
--- 64,68 ----
  				Note, however, that ztrtc does not work on multiprocessor systems.  ztrtc does not
  				come with Asterisk but is available from 
! 				<ulink url="http://www.junghanns.net/asterisk/" type="url">http://www.junghanns.net/asterisk/</ulink>.
  				</para>
  			</sect3>
***************
*** 74,78 ****
  			configuration file:
  			<programlisting>
- 				<literallayout>
  				[classes]
  				default => quietmp3:/var/lib/asterisk/mohmp3
--- 74,77 ----
***************
*** 80,84 ****
  				random-nirvana => quietmp3:/usr/share/mp3/nirvana-music,-z
  				loud-nirvana => mp3:/usr/share/mp3/nirvana-music
- 				</literallayout>
  			</programlisting>
  			In this example, the class <command>default</command> plays MP3s from the directory 
--- 79,82 ----
***************
*** 98,105 ****
  			<command>MusicOnHold(class)</command> as you would Dial() or Voicemail(). For example:
  			<programlisting>
- 				<literallayout>
  				exten => 6789,1,Answer()
  				exten => 6789,2,MusicOnHold(nirvana)
- 				</literallayout>
  			</programlisting>
  			</para>
--- 96,101 ----
***************
*** 111,115 ****
  			PBX (without a proper license) is illegal. However, high-quality, royalty free music does exist.  
  			An excellent source for it is 
! 			 <ulink url="http://www.openmusicregistry.org" type="http">http://www.openmusicregistry.org</ulink>.
  			</para>
  			<para>
--- 107,111 ----
  			PBX (without a proper license) is illegal. However, high-quality, royalty free music does exist.  
  			An excellent source for it is 
! 			<ulink url="http://www.openmusicregistry.org" type="url">http://www.openmusicregistry.org</ulink>.
  			</para>
  			<para>
***************
*** 118,122 ****
  			for a little less than $200 per annum. With this license, you may use any of BMI's 4.4 million 
  			songs for a Music on Hold application. More details are available at 
! 			<ulink url="http://www.bmi.com" type="http">http://www.bmi.com</ulink>.
  			</para>
  		</sect2>
--- 114,118 ----
  			for a little less than $200 per annum. With this license, you may use any of BMI's 4.4 million 
  			songs for a Music on Hold application. More details are available at 
! 			<ulink url="http://www.bmi.com" type="url">http://www.bmi.com</ulink>.
  			</para>
  		</sect2>
***************
*** 127,136 ****
  		DTMF (Dial Tone Multi-Frequency) is the name for the specific sounds ("dial tones") made by the keys
  		on a telephone keypad. The choice of which method to use for DTMF over SIP is made in Asterisk's 
! 		/etc/asterisk/sip.conf. Carying DTMF over SIP can be done in one of three ways:
  		</para>
  		<sect2>
  			<title>Inband</title>
  			<para>
! 			Inband DTMF is just as it sounds: the sound made by the key press is sent in the audio channel 
  			where it is decoded by Asterisk (or whatever the termination point of the call is).  
  			Inband is only available on A-Law and Mu-Law codecs; it is generally bad practice to use Inband DTMF.
--- 123,132 ----
  		DTMF (Dial Tone Multi-Frequency) is the name for the specific sounds ("dial tones") made by the keys
  		on a telephone keypad. The choice of which method to use for DTMF over SIP is made in Asterisk's 
! 		/etc/asterisk/sip.conf. Carrying DTMF over SIP can be done in one of three ways:
  		</para>
  		<sect2>
  			<title>Inband</title>
  			<para>
! 			Inband DTMF is just as it sounds: the sound made by the key press sent in the audio channel 
  			where it is decoded by Asterisk (or whatever the termination point of the call is).  
  			Inband is only available on A-Law and Mu-Law codecs; it is generally bad practice to use Inband DTMF.
***************
*** 142,146 ****
  			The Info method sends SIP Info messages from phone to Asterisk with the text of the buttons
  			pressed on the phone. SIP Info tends to be a better choice than Inband because the key-presses are
! 			send textually, independent of the audio codec.
  			Users of Grandstream phones should use Info for the Asterisk voicemail; the other methods won't work.
  			</para>
--- 138,142 ----
  			The Info method sends SIP Info messages from phone to Asterisk with the text of the buttons
  			pressed on the phone. SIP Info tends to be a better choice than Inband because the key-presses are
! 			sent textually, independent of the audio codec.
  			Users of Grandstream phones should use Info for the Asterisk voicemail; the other methods won't work.
  			</para>
***************
*** 255,267 ****
  		<para>
  		SIP phones that support a message waiting indicator (such as a stuttered dial tone or a flashing light)
! 		can be associated with a voice mail box.  In /etc/asterisk/sip.conf, just add a line like
! 		<programsegment>
  		mailbox=1234
! 		</programsegment>
  		You can associate more than one mailbox with a SIP phone for a message waiting indication by seperating
  		the voice mail box numbers with commas:
! 		<programsegment>
  		mailbox=1234,9999
! 		</programsegment> 
  		</para>
  	</sect1>
--- 251,263 ----
  		<para>
  		SIP phones that support a message waiting indicator (such as a stuttered dial tone or a flashing light)
! 		can be associated with a voicemail box.  In /etc/asterisk/sip.conf, just add a line like
! 		<programlisting>
  		mailbox=1234
! 		</programlisting>
  		You can associate more than one mailbox with a SIP phone for a message waiting indication by seperating
  		the voice mail box numbers with commas:
! 		<programlisting>
  		mailbox=1234,9999
! 		</programlisting> 
  		</para>
  	</sect1>