2008-08-21 Dermot McCluskey <[email protected]>
authordermot
Thu, 21 Aug 2008 17:53:58 +0000
changeset 13238 d8d961a1a3fd
parent 13237 348a2b00940b
child 13239 03278cc95f44
2008-08-21 Dermot McCluskey <[email protected]> * SUNWespeak.spec: * manpages/Makefile: * manpages/man1/espeak.1: * manpages/man3/libespeak.3: add manpages to package
ChangeLog
SUNWespeak.spec
manpages/Makefile
manpages/man1/espeak.1
manpages/man3/libespeak.3
--- a/ChangeLog	Thu Aug 21 17:52:03 2008 +0000
+++ b/ChangeLog	Thu Aug 21 17:53:58 2008 +0000
@@ -1,3 +1,11 @@
+2008-08-21  Dermot McCluskey  <[email protected]>
+
+	* SUNWespeak.spec:
+	* manpages/Makefile:
+	* manpages/man1/espeak.1:
+	* manpages/man3/libespeak.3:
+	  add manpages to package
+
 2008-08-21  Dermot McCluskey  <[email protected]>
 
 	* SUNWgnome-config.spec: remove /usr/lib/ST/64 refs.
--- a/SUNWespeak.spec	Thu Aug 21 17:52:03 2008 +0000
+++ b/SUNWespeak.spec	Thu Aug 21 17:53:58 2008 +0000
@@ -1,3 +1,13 @@
+#
+# spec file for package SUNWespeak
+#
+# Copyright (c) 2008 Sun Microsystems, Inc.
+# This file and all modifications and additions to the pristine
+# package are under the same license as the package itself.
+#
+# Owner: ww36193
+#
+
 %include Solaris.inc
 
 %define src_name espeak
@@ -7,6 +17,7 @@
 Summary:	eSpeak - compact open source software speech synthesizer
 Version:	1.37
 Source:		%{src_url}/%{src_name}-%{version}-source.zip
+Source1:        %{name}-manpages-0.1.tar.gz
 Patch1:         espeak-01-makefile.diff
 SUNW_BaseDir:	%{_basedir}
 SUNW_Copyright: %{name}.copyright
@@ -22,6 +33,7 @@
 %prep
 %setup -q -n %{src_name}-%{version}-source
 %patch1 -p1
+gzcat %SOURCE1 | tar xf -
 
 %build
 CPUS=`/usr/sbin/psrinfo | grep on-line | wc -l | tr -d ' '`
@@ -33,6 +45,13 @@
 make install EXTRA_LIBS=-lm AUDIO=sada DESTDIR=$RPM_BUILD_ROOT
 rm $RPM_BUILD_ROOT/%{_libdir}/lib*.a
 
+%install
+#Install manpages
+rm -rf $RPM_BUILD_ROOT%{_mandir}
+cd %{_builddir}/%src_name-%version-source/sun-manpages
+make install DESTDIR=$RPM_BUILD_ROOT
+
+
 %clean
 rm -rf $RPM_BUILD_ROOT
 
@@ -50,6 +69,8 @@
 %{_includedir}
 
 %changelog
+* Thu Aug 21 2008 - Dermot McCluskey
+- added manpages and file header
 * Wed Aug 20 2008 - Willie Walker
 - Migrate to JDS (SFEespeak.spec to SUNWespeak.spec)
 * Tue Aug 12 2008 - Willie Walker
--- a/manpages/Makefile	Thu Aug 21 17:52:03 2008 +0000
+++ b/manpages/Makefile	Thu Aug 21 17:53:58 2008 +0000
@@ -160,7 +160,8 @@
 	SUNWgnome-camera	\
 	SUNWgtkspell			\
 	SUNWgtkmm			\
-	SUNWpangomm		
+	SUNWpangomm			\
+	SUNWespeak
 
 all: TARBALLS
 
@@ -895,6 +896,11 @@
 		man3/libpangomm-1.4.3
 SUNWpangomm.PAGES: $(SUNWpangomm_PAGES)
 
+SUNWespeak_PAGES =	\
+		man1/espeak.1		\
+		man3/libespeak.3
+SUNWespeak.PAGES: $(SUNWespeak_PAGES)
+
 .SUFFIXES: -manpages-$(MANPAGE_VERSION).tar.gz .PAGES
 .SUFFIXES: .check-used .PAGES
 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/manpages/man1/espeak.1	Thu Aug 21 17:53:58 2008 +0000
@@ -0,0 +1,235 @@
+<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
+<!-- ARC : LSARC 2008/536 espeak for OpenSolaris-->
+<!ENTITY cmd "espeak">
+<!ENTITY % commonents SYSTEM "smancommon.ent">
+%commonents;
+<!ENTITY % booktitles SYSTEM "booktitles.ent">
+%booktitles;
+<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">
+]>
+<?Pub UDT _bookmark _target>
+<?Pub Inc>
+<refentry id="espeak-1">
+<!-- %Z%%M% %I% %E% SMI; --> 
+<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">20 Aug 2008</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
+</refmeta>
+
+<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>a compact open source software speech synthesizer</primary></indexterm>
+
+<refnamediv id="espeak-1-name"><refname>&cmd;</refname><refpurpose>a compact open source software speech synthesizer</refpurpose></refnamediv>
+
+<refsynopsisdiv id="espeak-1-synp"><title>&synp-tt;</title>
+<cmdsynopsis><command>&cmd;</command>
+<arg choice="opt"><option role="nodash"><replaceable>option...</replaceable></option></arg>
+<arg choice="opt"><option role="nodash"><replaceable>"words"</replaceable></option></arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1 id="espeak-1-desc"><title>&desc-tt;</title>
+<para><command>&cmd;</command> is a compact open source software speech synthesizer.
+It can run as a command line program to speak text from a file or from stdin.</para>
+<para>Main features of <command>&cmd;</command>:</para>
+<para>
+<screen>
+    * Includes different Voices, whose characteristics
+      can be altered.
+    * Can produce speech output as a WAV file.
+    * Supports SSML (Speech Synthesis Markup Language
+      - not complete)
+    * Supports HTML.
+    * Is compact in size.
+    * Can translate text to phoneme codes, so it could
+      be adapted as a front end for another speech
+      synthesis engine.
+    * Is written in C++.
+</screen>
+</para>
+<para>
+Additional  information  is  also  available  from  the following site:
+</para>
+<para>
+http://espeak.sourceforge.net/
+</para>
+</refsect1>
+
+<refsect1 id="espeak-1-opts"><title>&opts-tt;</title>
+<para>The following options are supported:</para>
+<variablelist termlength="medium">
+
+<varlistentry>
+<term><option>a <replaceable>integer</replaceable></option></term>
+<listitem><para>Amplitude, 0 to 200, default is 100</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>b</option></term>
+<listitem><para>Input text is 8-bit encoding</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>f <replaceable>text file</replaceable></option></term>
+<listitem><para>Speak text from <replaceable>text file</replaceable>.  If neither 
+<option>f</option> nor <option>-stdin</option>, <replaceable>words</replaceable>
+are spoken, or if none then text is spoken from
+stdin, each line separately.</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>g <replaceable>integer</replaceable></option></term>
+<listitem><para>Word gap. Pause between words, units of 10mS at the
+default speed</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>k <replaceable>integer</replaceable></option></term>
+<listitem><para>Indicate capital letters with: 1=sound, 2=the word "capitals",
+higher values = a pitch increase (try -k20).</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>l <replaceable>integer</replaceable></option></term>
+<listitem><para>Line length. If not zero (which is the default), consider
+lines less than this length as end-of-clause</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>m</option></term>
+<listitem><para>Interpret SSML markup, and ignore other < > tags</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>p <replaceable>integer</replaceable></option></term>
+<listitem><para>Pitch adjustment, 0 to 99, default is 50</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>q</option></term>
+<listitem><para>Quiet, don't produce any speech (may be useful with <option>x</option>)</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>s <replaceable>integer</replaceable></option></term>
+<listitem><para>Speed in words per minute, 80 to 370, default is 170</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>v <replaceable>voice name</replaceable></option></term>
+<listitem><para>Use voice file of this name from espeak-data/voices</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>w <replaceable>wave file name</replaceable></option></term>
+<listitem><para>Write output to this WAV file, rather than speaking it
+directly</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>x</option></term>
+<listitem><para>Write phoneme mnemonics to stdout</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>X</option></term>
+<listitem><para>Write phonemes mnemonics and translation trace to stdout</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>z</option></term>
+<listitem><para>No final sentence pause at the end of the text</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-compile=<replaceable>voice name</replaceable></option></term>
+<listitem><para>Compile the pronunciation rules and dictionary in the
+current directory. =<replaceable>voice name</replaceable> is optional and
+specifies which language</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-punct="<replaceable>characters</replaceable>"</option></term>
+<listitem><para>Speak the names of punctuation characters during speaking.
+If =<replaceable>characters</replaceable> is omitted, all punctuation is spoken.</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-split="<replaceable>minutes</replaceable>"</option></term>
+<listitem><para>Starts a new WAV file every <replaceable>minutes<replaceable>.  Used with <option>w</option></para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-stdin</option></term>
+<listitem><para>Read text input from stdin instead of a file</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-stdout</option></term>
+<listitem><para>Write speech output to stdout</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><option>-voices=<replaceable>language</replaceable></option></term>
+<listitem><para>List the available voices for the specified language.
+If <replaceable>language</replaceable> is omitted, then list all voices.</para>
+</listitem></varlistentry>
+</variablelist></refsect1>
+
+
+<refsect1 id="espeak-1-file"><title>&file-tt;</title>
+<para>The following files are used by &cmd;:</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><filename>/usr/lib/libespeak.so</filename></term>
+<listitem><para>
+Library for &cmd; speech synthesis
+</para>
+</listitem></varlistentry>
+<varlistentry>
+<term><filename>/usr/share/espeak-data</filename></term>
+<listitem><para>
+Directory of voice language and data files
+</para>
+</listitem></varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1 id="espeak-1-attr"><title>&attr-tt;</title>
+<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
+<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
+for descriptions of the following attributes:</para>
+<informaltable frame="all">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
+<colspec colname="COLSPEC1" colwidth="1*">
+<thead>
+<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
+valign="middle">ATTRIBUTE VALUE</entry></row>
+</thead>
+<tbody>
+<row><entry><para>Availability</para></entry><entry><para>SUNWespeak</para></entry>
+</row>
+<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
+colname="COLSPEC1"><para>Volatile</para></entry></row>
+</tbody>
+</tgroup>
+</informaltable>
+</refsect1>
+
+<refsect1 id="espeak-1-note"><title>&note-tt;</title>
+<para>
+&cmd; was written by Jonathan Duddington.
+</para>
+</refsect1>
+
+<refsect1 id="espeak-1-also"><title>&also-tt;</title>
+<para>
+<citerefentry><refentrytitle>orca</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>libespeak</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>libgnomespeech</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+</para>
+</refsect1>
+
+</refentry>
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/manpages/man3/libespeak.3	Thu Aug 21 17:53:58 2008 +0000
@@ -0,0 +1,86 @@
+<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
+<!-- ARC : LSARC 2008/536 espeak for OpenSolaris-->
+<!ENTITY cmd "libespeak">
+<!ENTITY % commonents SYSTEM "smancommon.ent">
+%commonents;
+<!ENTITY % booktitles SYSTEM "booktitles.ent">
+%booktitles;
+<!ENTITY suncopy "Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.">
+]>
+<?Pub UDT _bookmark _target>
+<?Pub Inc>
+
+<refentry id="libespeak-3">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>3</manvolnum>
+<refmiscinfo class="date">21 Aug 2008</refmiscinfo>
+<refmiscinfo class="sectdesc">&man3;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
+</refmeta>
+<indexterm><primary>&cmd;</primary></indexterm><indexterm><primary>C++ bindings
+for espeak speech synthesis</primary></indexterm>
+<refnamediv id="libespeak-3-name"><refname>&cmd;</refname><refpurpose>C++ bindings
+for espeak speech synthesis</refpurpose></refnamediv>
+
+<refsect1 id="libespeak-3-desc"><title>&desc-tt;</title>
+<para>&cmd;  is a set of C++ bindings to speech synthesis
+services for use by client applications and assistive
+technologies.</para>
+<para>Additional  information  is  also  available  from  the following
+site:</para>
+<para>http://espeak.sourceforge.net/</para>
+<para>Please note that these C++ interfaces are built with the Sun
+Studio C++ Compiler.  The SUNWespeak-devel package must be
+installed to develop against libespeak.</para>
+</refsect1>
+
+<refsect1 id="libespeak-3-file"><title>&file-tt;</title>
+<para>The following files are used by this library:</para>
+<variablelist termlength="medium">
+<varlistentry><term><filename>/usr/lib/&cmd;.so</filename> </term><listitem>
+<para>Library for espeak speech synthesis</para>
+</listitem></varlistentry>
+
+<variablelist termlength="medium">
+<varlistentry><term><filename>/usr/share/espeak-data</filename> </term><listitem>
+<para>Directory of voice language and data files</para>
+</listitem></varlistentry>
+
+<variablelist termlength="medium">
+<varlistentry><term><filename>/usr/include/espeak/speak_lib.h</filename> </term><listitem>
+<para>Header file for development purposes</para>
+</listitem></varlistentry>
+</variablelist></refsect1>
+
+<refsect1 id="libespeak-3-attr"><title>&attr-tt;</title>
+<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
+<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
+for descriptions of the following attributes:</para>
+<informaltable frame="all">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
+<colspec colname="COLSPEC1" colwidth="1*">
+<thead>
+<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
+valign="middle">ATTRIBUTE VALUE</entry></row>
+</thead>
+<tbody>
+<row><entry><para>Availability</para></entry><entry><para>SUNWespeak</para></entry>
+</row>
+<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
+colname="COLSPEC1"><para>Volatile</para></entry></row>
+</tbody>
+</tgroup>
+</informaltable>
+</refsect1>
+
+<refsect1 id="libespeak-3-also"><title>&also-tt;</title>
+<para>
+<citerefentry><refentrytitle>espeak</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>orca</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>libgnomespeech</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+</para>
+</refsect1>
+
+</refentry>