'\" t
.\"	recite - english text speech synthesizer
.\"	Copyright (C) 1993 Peter Miller.
.\"	All rights reserved.
.\"
.\"	This program is free software; you can redistribute it and/or modify
.\"	it under the terms of the GNU General Public License as published by
.\"	the Free Software Foundation; either version 1, or (at your option)
.\"	any later version.
.\"
.\"	This program is distributed in the hope that it will be useful,
.\"	but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"	GNU General Public License for more details.
.\"
.\"	You should have received a copy of the GNU General Public License
.\"	along with this program; if not, write to the Free Software
.\"	Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\" MANIFEST: manual page describing recite command
.\"
.TH recite 1
.if n .ad l
.if n .hy 0
.if n .nr IN 8n
.SH NAME
recite \- english text speech synthesizer
.SH SYNOPSIS
.B recite
[
.IR option \&...
][
.IR infile
[
.I outfile
]]
.br
.B recite
.B -Help
.br
.B recite
.B -VERSion
.SH DESCRIPTION
The
.I recite
program is used to read english text and speak the words
from the workstation's speaker.
.PP
By default,
the standard input is read and the english text is spoken from the speaker.
If a file name is given on the command line,
the text is taken from the file
rather than the standard input.
If a second file is named,
a
.I ulaw
encoded file is written to the named file,
rather then emitting it from the speaker.
This file will be compatible with Sun's
.IR audiotool (1).
.SH OPTIONS
The following options are understood:
.TP 8n
.B -Write_Phonemes
.br
The option may be used to cause the translation process to cease
after the text has been translated into phonemes.
The phonemes will be emitted on the standard output,
or to the appropriate file if an output file has been specified.
.TP 8n
.B -Help
.br
Provide some help with using the
.I recite
program.
.TP 8n
.B -VERSion
.br
Print the version of the
.I recite
program being executed.
.PP
All other options will produce a diagnostic error.
Options may be abbreviated,
the minimum abbreviation is shown in upper-case.
Options are case insensitive.
Options and file names may be mixed arbitrarily on the command line.
.br
.ne 1i
.SH EXIT STATUS
The
.I recite
program will exit with a status of 1 on any error.
The
.I recite
program will only exit with a status of 0 if there are no errors.
.br
.ne 2i
.SH COPYRIGHT
.if t .ds C) \(co
.if n .ds C) (C)
The
.I recite
program is
.br
Copyright \*(C) 1993 Peter Miller.
.br
All rights reserved.
.PP
The
.I recite
program comes with ABSOLUTELY NO WARRANTY;
for details use the '\fIrecite \-VERSion Warranty\fP' command.
This is free software
and you are welcome to redistribute it under certain conditions;
for details use the '\fIrecite \-VERSion Redistribution\fP' command.
.br
.ne 1i
.SH AUTHOR
.TS
tab(;);
l l l.
Peter Miller;UUCP;uunet!munnari!bmr.gov.au!pmiller
/\e/\e*;Internet;pmiller@bmr.gov.au
.TE