Updated to GNOME Speech-0.3.5

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3067 af4574ff-66df-0310-9fd7-8a98e5e911e0

gnome/add/gnome-speech.xml

@@ -6,10 +6,10 @@
 
 <!ENTITY gnome-speech-download-http "http://ftp.gnome.org/pub/GNOME/sources/gnome-speech/0.3/gnome-speech-&gnome-speech-version;.tar.bz2">
 <!ENTITY gnome-speech-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/gnome-speech/0.3/gnome-speech-&gnome-speech-version;.tar.bz2">
-<!ENTITY gnome-speech-size "220 KB">
+<!ENTITY gnome-speech-md5sum "34382d0b33146b1f8fc5239895471369">
-<!ENTITY gnome-speech-buildsize "4.5 MB">
+<!ENTITY gnome-speech-size "255 KB">
-<!ENTITY gnome-speech-time "0.10 SBU">
+<!ENTITY gnome-speech-buildsize "4.6 MB">
-
+<!ENTITY gnome-speech-time "0.15 SBU">
 ]>
 
 <sect1 id="gnome-speech" xreflabel="GNOME Speech-&gnome-speech-version;">
@@ -21,15 +21,16 @@
 <title>GNOME Speech-&gnome-speech-version;</title>
 
 <sect2>
-<title>Introduction to <application><acronym>GNOME</acronym> Speech</application></title>
+<title>Introduction to <application><acronym>GNOME</acronym> 
+Speech</application></title>
 
 <para>
-The <application><acronym>GNOME</acronym> Speech</application> gives a
+The <application><acronym>GNOME</acronym> Speech</application> package 
-simple general <acronym>API</acronym> for producing text-to-speech
+provides a simple general <acronym>API</acronym> for producing text-to-speech 
 output. Multiple backends are supported by the
 <application><acronym>GNOME</acronym> Speech</application> library, but
-currently only the Festival backend is enabled in this package; the other
+currently only the <application>Festival</application> backend is built by 
-backends require either Java or proprietary software.
+default; the other backends require either Java or proprietary software.
 </para>
 
 <sect3><title>Package information</title>
@@ -45,30 +46,38 @@ url="&gnome-speech-download-ftp;"/></para></listitem>
 &gnome-speech-time;</para></listitem></itemizedlist>
 </sect3>
                                                                                 
-<sect3><title><application><acronym>GNOME</acronym> Speech</application> dependencies</title>
+<sect3><title><application><acronym>GNOME</acronym> Speech</application> 
+dependencies</title>
 <sect4><title>Required</title>
-<para>
+<para><xref linkend="libbonobo"/></para>
-<xref linkend="libbonobo"/>
+</sect4>
-</para></sect4>
+
 <sect4><title>Optional</title>
-<para>
+<para><xref linkend="java-access-bridge"/>, 
-<xref linkend="gtk-doc"/>,
+<ulink url="http://www.cstr.ed.ac.uk/projects/festival/">Festival</ulink>, 
-<xref linkend="j2sdk"/>,
+<ulink url="http://freetts.sourceforge.net/">FreeTTS</ulink>, 
-<ulink url="http://www.cstr.ed.ac.uk/projects/festival/">Festival</ulink>,
+<ulink url="http://www.ibm.com/software/voice/viavoice/">ViaVoice</ulink>, 
-<ulink url="http://freetts.sourceforge.net/">FreeTTS</ulink>,
+<ulink url="http://www.scansoft.com/">Eloquence</ulink>, 
-<ulink url="http://www.ibm.com/software/voice/viavoice/">ViaVoice</ulink>,
+<ulink url="http://www.fonix.com/">DECTalk</ulink> and 
-<ulink url="http://www.scansoft.com/">Eloquence</ulink>,
+<ulink url="http://www.cepstral.com/">Theta</ulink></para>
-<ulink url="http://www.fonix.com/">DECTalk</ulink> and
+</sect4>
-<ulink url="http://www.cepstral.com/">Theta</ulink>
-</para></sect4>
 </sect3>
 
 </sect2>
 
 <sect2>
-<title>Installation of <application><acronym>GNOME</acronym> Speech</application></title>
+<title>Installation of <application><acronym>GNOME</acronym> 
+Speech</application></title>
 
-<para>Install <application><acronym>GNOME</acronym> Speech</application> by running the following commands:</para>
+<note><para>You must install at least one of the backend drivers for 
+<application><acronym>GNOME</acronym> Speech</application> to render speech 
+through the audio hardware. Testing the installation of the backend driver 
+to ensure it produces desired results before installing 
+<application><acronym>GNOME</acronym> Speech</application> is 
+recommended.</para></note>
+
+<para>Install <application><acronym>GNOME</acronym> Speech</application> by 
+running the following commands:</para>
 
 <screen><userinput><command>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` &amp;&amp;
 make &amp;&amp;
@@ -76,6 +85,33 @@ make install</command></userinput></screen>
 
 </sect2>
 
+<sect2>
+<title>Command explanations</title>
+
+<para><option>--with-jab-dir=`pkg-config 
+--variable=prefix ORBit-2.0`/share/jar</option>: Use this option if you 
+have installed the <application>Java Access Bridge</application> package and
+wish to have <application><acronym>GNOME</acronym> Speech</application> build 
+in Java support.</para>
+
+<para>Note: see the <filename>README</filename> and 
+<filename>INSTALL</filename> files in the package source tree for the correct 
+parameters to pass to <command>configure</command> to enable the desired 
+backends.</para>
+
+</sect2>
+
+<sect2>
+<title>Testing the installation</title>
+
+<para>You can test all the available backend drivers, voices and audio 
+hardware using the <command>test-speech</command> command. Invoking 
+<command>test-speech</command> produces a menu allowing you to select 
+a backend driver, then prompts you (with on-screen prompts and text-to-speech 
+audio) for additional information.</para>
+
+</sect2>
+
 <sect2>
 <title>Contents</title>
 
@@ -83,17 +119,24 @@ make install</command></userinput></screen>
 package contains
 <command>festival-synthesis-driver</command>,
 <command>test-speech</command> and
-<filename class="libraryfile">libgnomespeech</filename>.
+<filename class="libraryfile">libgnomespeech</filename>. Other drivers 
-</para>
+and libraries are also installed if you have enabled additional 
+backends.</para>
 
 </sect2>
 
 <sect2><title>Description</title>
 
+<sect3><title>test-speech</title>
+<para><command>test-speech</command> is used to test the various backend 
+drivers and voices installed on the system.</para>
+</sect3>
+
 <sect3><title>libgnomespeech</title>
 <para><filename class="libraryfile">libgnomespeech</filename> provides 
 the <acronym>API</acronym> for programs to convert text into
-speech.</para></sect3>
+speech.</para>
+</sect3>
 
 </sect2>
 

introduction/welcome/changelog.xml

@@ -24,7 +24,8 @@ who wrote what.</para>
 
 <listitem><para>December 2nd, 2004 [randy]: Added new package 
 Java Access Bridge-1.4.2; added --disable-gtk-doc to the librsvg build 
-instructions which was inadvertently removed.</para></listitem>
+instructions which was inadvertently removed; updated to 
+GNOME Speech-0.3.5.</para></listitem>
 
 <listitem><para>December 1st, 2004 [randy]: Added a note to the 
 Apache Ant instructions to optionally build the Junit testing library