Research V3 development

[unix-history] / man / man1 / speak.1

.pa 1
.he 'SPEAK (I)'2/1/73'SPEAK (I)'
.ti 0
NAME		speak -- word to voice translator
.sp
.ti 0
SYNOPSIS	speak\b\b\b\b\b_____ [ -\b_ ] [ vocabulary ]
.sp
.ti 0
DESCRIPTION	speak\b\b\b\b\b_____
turns a stream of ascii words
into utterances and outputs them to a voice synthesizer.
It has facilities for maintaining a vocabulary.
It receives, from the standard input 

.in +2
.ti -2
- working lines - text of words separated by blanks
.ti -2
- phonetic lines - strings of phonemes for one word preceded
and separated by commas.
The phonetic code is given in vsp\b\b\b___(VII).
.ti -2
- empty lines
.ti -2
- command lines - beginning with !\b_.  The following forms
are recognized:
.in+1
.in+8

.ti-8
!\b_r\b_ file	replace coded vocabulary from file
.ti-8
!\b_w\b_ file	write coded vocabulary on file
.ti-8
!\b_p\b_	print phonetics for working word
.ti-8
!\b_l\b_	list vocabulary on standard output with phonetics
.ti-8
!c\b\b__ word	copy phonetics from working word to
specified word
.ti-8
!s\b\b__ file	(save) append working word and phonetics to file
in style of !l\b\b__
.in-8

.in-3
Each working line replaces its predecessor.
Its first word is the "working word".
Each phonetic line replaces the phonetics stored for the
working word.
Each working line, phonetic line or empty line
causes the working line to be uttered.
The process terminates at the end of input.

Unknown words are spelled
as strings of one-letter words.
Unknown one-letter words burp.

A phonetic line of comma only will delete the
entry for the working word.

speak\b\b\b\b\b_____ is initialized with a coded vocabulary stored in file
.ul
/etc/speak.m.
The vocabulary option substitutes a different file for speak.m\b\b\b\b\b\b\b_______.
.sp
The -\b_ option suppresses all utterances.
.sp
.ti 0
FILES		/etc/speak.m
.sp
.ti 0
SEE ALSO	vsp(VII), speakm(V), vt(IV)
.sp
.ti 0
BUGS		Vocabulary overflow is unchecked.
Excessively long words cause dumps.
Space is not reclaimed from deleted entries.