.\" 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 SPEECH-DISPATCHER "1" "March 2011" "speech-dispatcher 0.7.1" "User Commands"
.SH NAME
speech-dispatcher \- server process managing speech requests in Speech Dispatcher
.SH SYNOPSIS
.B speech-dispatcher
[\fI-{d|s}\fR] [\fI-l {1|2|3|4|5}\fR] [\fI-c com_method\fR] [\fI-S socket_path\fR] [\fI-p port\fR] \fI| \fR[\fI-v\fR] \fI| \fR[\fI-h\fR]
.SH DESCRIPTION
.B speech-dispatcher
is a server process that is responsible for transforming requests for text-to-speech output into actual speech hearable in the speakers. It arbitrates concurrent speech requests based on message priorities, and abstracts different speech synthesizers. Client programs, like screen readers or navigation software, send speech requests to
.B speech-dispatcher
using TCP protocol (with the help of client libraries).
.B speech-dispatcher
is usually started automatically by client libraries (i.e. autospawn), so you only need to run it manually if testing/debugging, or when in other explicit need for a special setup.
.SH OPTIONS
.TP
.B \-d, \-\-run\-daemon
Run as a daemon
.TP
.B \-s, \-\-run\-single
Run as single application
.TP
.B \-a, \-\-spawn
Start only if autospawn is not disabled
.TP
.B \-l, \-\-log\-level
Set log level (1..5)
.TP
.B \-c, \-\-communication\-method
Communication method to use (unix_socket or inet_socket)
\-S, \-\-socket\-path
Socket path to use for 'unix_socket' method (filesystem path or 'default')
.TP
.B -p, \-\-port
Specify a port number for 'inet_socket' method
.TP
.B \-P, \-\-pid\-file
Set path to pid file
.TP
.B -C, \-\-config\-dir
Set path to configuration
.TP
.B \-v, \-\-version
Report version of this program
.TP
.B \-D, \-\-debug
Output debugging information into /tmp/.speech\-dispatcher
.TP
.B \-h, \-\-help
Print this info
.SH BUGS
Please report bugs to <speechd\-bugs@freebsoft.org>
.PP
.SH "SEE ALSO"
.BR spd\-say(1)

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