.\" Copyright (C) 2011 Brailcom, o.p.s.
.\"
.\" This 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 2, or (at your option) any later
.\" version.
.\" 
.\" This 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 with
.\" your Debian GNU/Linux system, in /usr/share/common-licenses/GPL, or with
.\" the dpkg source package as the file COPYING.  If not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.2.
.TH SPD-SAY "1" "March 2011" "spd-say 0.7.1" "User Commands"
.SH NAME
spd-say \- send text-to-speech output request to speech-dispatcher
.SH SYNOPSIS
.B spd-say
[\fIoptions\fR] \fI"some text"\fR
.SH DESCRIPTION
.B spd-say
sends text-to-speech output request to
.B speech-dispatcher
process which handles it and ideally outputs the result to the audio system.
.SH OPTIONS
.TP
\fB\-r\fR, \fB\-\-rate\fR
Set the rate of the speech (between \-100 and +100, default: 0)
.TP
\fB\-p\fR, \fB\-\-pitch\fR
Set the pitch of the speech (between \-100 and +100, default: 0)
.TP
\fB\-i\fR, \fB\-\-volume\fR
Set the volume (intensity) of the speech (between \-100 and +100, default: 0)
.TP
\fB\-o\fR, \fB\-\-output\-module\fR
Set the output module
.TP
\fB\-l\fR, \fB\-\-language\fR
Set the language (iso code)
.TP
\fB\-t\fR, \fB\-\-voice\-type\fR
Set the preferred voice type (male1, male2, male3, female1, female2, female3, child_male, child_female)
.TP
\fB\-m\fR, \fB\-\-punctuation\-mode\fR
Set the punctuation mode (none, some, all)
.TP
\fB\-s\fR, \fB\-\-spelling\fR
Spell the message
.TP
\fB\-x\fR, \fB\-\-ssml\fR
Set SSML mode on (default: off)
.TP
\fB\-e\fR, \fB\-\-pipe\-mode\fR
Pipe from stdin to stdout plus Speech Dispatcher
.TP
\fB\-P\fR, \fB\-\-priority\fR
Set priority of the message (important, message, text, notification, progress; default: text)
.TP
\fB\-N\fR, \fB\-\-application\-name\fR
Set the application name used to establish the connection to specified string value (default: spd\-say)
.TP
\fB\-n\fR, \fB\-\-connection\-name\fR
Set the connection name used to establish the connection to specified string value (default: main)
.TP
\fB\-w\fR, \fB\-\-wait\fR
Wait till the message is spoken or discarded
.TP
\fB\-S\fR, \fB\-\-stop\fR
Stop speaking the message being spoken in Speech Dispatcher
.TP
\fB\-C\fR, \fB\-\-cancel\fR
Cancel all messages in Speech Dispatcher
.TP
\fB\-v\fR, \fB\-\-version\fR
Print version and copyright info
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this info
.SH ENVIRONMENT
.TP
.B SPEECHD_ADDRESS
specifies TCP endpoint where
.B speech-dispatcher
is listening and to which spd-say should connect. Has form of <method>:<address>, where <method> is one of
.B unix_socket
and
.B inet_socket.
The <address> is either path to Unix domain socket if method is unix_socket, of IP address if method is inet_socket.
.SH "SEE ALSO"
.BR speech\-dispatcher(1)

The full documentation for
.B spd-say
is maintained as a Texinfo manual.  If the
.B info
and
.B spd-say
programs are properly installed at your site, the command
.IP
.B info spd-say
.PP
should give you access to the complete manual.