aboutsummaryrefslogtreecommitdiffstats
path: root/spo256/speak.conf.7
blob: ccc3e578349054d5f0ff70a50230847bbe4b5eb0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
.TH "speak.conf" "7" "January 1997" "Speak 0.2" "Text-to-Speech" 
.PP 
.SH NAME 
.PP
\fBspeak.conf\fP - configuration file for text-to-speech services.
.PP 
.SH SYNOPSIS 
.PP 
\fBspeak.conf\fP
.PP 
.SH DESCRIPTION 
.PP
The \fBspeak.conf\fP file is a text edit-able configuration file used by the
text-to-speech server and various text-to-speech utilities.  
.PP
\fBspeak.conf\fP is divided into sections, donated with "[]"'s.  These
sections include hardware parameters for the text-to-speech server used on the
local machine, translation tables used for phonetic dictionaries by text-to-
speech servers, and runtime default information for specific programs.  On
machines that do not run their own text-to-speech server, \fBspeak.conf\fP
will still be used to specify runtime defaults for utility programs that are
present.
.PP
.SH FILE FORMAT
.PP
The file consists of sections and parameters.  A section begins with the 
name of the section in square brackets and continues until the next section
begins.  Sections contain parameters of the form \'name = value`'.
.PP
The file is line-based text - that is, each newline-terminated line 
represents either a comment, a section name, or a parameter.  Parameters
in the .conf file normally do not appear on multiple lines, except for 
several specific exceptions (lists and tables) that are not used in this 
package. 
.PP
Section and parameter names are not case sensitive.
.PP
Only the first equal sign in a parameter is significant.  Whitepsaces before
or after the = are ignored.  Leading and trailing whitespaces are ignored.
Whitepaces within a parameter name are also ignored, while whitespaces 
within a parameter value are preserved.
.PP
Any line beginning with a semicolon or a pound sign is treated as a comment
and is ignored.
.PP
Any line containing a list, in the form 'name = { v1 v2 v3 }' may be 
continued over multiple lines if the terminating '}' is not found in the
current line.
.PP
Any line beginning with a plus is considered a repeat of the "name =" portion
of the last parameter line.  This is often used to build up hostname lists
when multiple hostnames may be specified.
.PP
The parameter value may either be quoted or unquoted.  Quoted parameters 
values may be used to specify lead or trailing spaces which would otherwise
be ignored.  Either matching single or double quotes may be used, and the
quotes are not kept as part of the value returned to the application.
.PP
Parameter values may either be strings, numeric values, or boolean flags.
When a boolean parameter is used, the characters "T" for 'true' and "F" for
'false' may be used.  The full word, "true" and "false", may also be
spelled out.  "Y" or "Yes" and "N" or "No" may also be used for "true" or
"false".
.PP 
.SH SEE ALSO 
.PP 
.BR speak (1)
.PP 
.SH AUTHOR 
.PP 
David Sugar (dyfet@tycho.com)
.PP