emacspeak-dt - A C language interface between Emacspeak and the DoubleTalk

T. V. Raman wrote the interface between his Emacspeak and the DECtalk
in TCL.  I have translated it into C, then adapted it for the
DoubleTalk synthesizer.

T. V. Raman bears no responsibility for this code.  Questions,
problems, or suggestions should be sent to me, not him.

For the most recent version of this code, look on my web page:

	http://www.mv.com/ipusers/vanzandt/

For general information on Emacspeak, please consult the Emacspeak home page:

	http://www.cs.cornell.edu/Info/People/raman/emacspeak/emacspeak.html

There is also an Emacspeak mailing list.  To subscribe, send a message to:

	"greg e. priest-dorman" <priestdo@cs.vassar.edu>

PREPARATION

Before you can use this driver, you have to install emacspeak.  If you
have a recent Slackware Linux cdrom, you will find a package in the
/contrib directory.  You can install and configure it with commands
something like this:

	# installpkg /cdrom/contrib/emacspeak.tgz
	# /var/adm/setup/setup.emacspeak

INSTALLATION

Configure with
	./configure
or, if you want to install somewhere other than /usr/local, with
	./configure --prefix=/another/directory

Build with
	make

Remember that you have to set the environment variable DTK_TCL to
point to the driver before you start.  For testing, I put the
following two lines in a file named setup:

export DTK_TCL=`pwd`/emacspeak-dt
export EMACSPEAK=log

Then, before running emacspeak, I cd to the directory that has the
driver and type "source setup".

A man page is included in the driver package.  You can read it with
something like this:

   nroff -man emacspeak-dt.1|less

Install by becoming the superuser and typing
	make install

Set the environment variable with
	export DTK_TCL=/usr/local/bin/emacspeak-dt
(or the appropriate variation if you changed the prefix above). 

If your DoubleTalk is not on the first serial port (/dev/ttyS0 under
Linux, or COM1 under DOS), then set the other environment variable.
For example, for the second serial port, which is COM2 under DOS you
would use this:
	export DTK_PORT=/dev/ttyS1

If the port is set up for the right speed, you can check the
connection and port number with echo:
	echo this is a test >/dev/ttyS1

You may want to add this line to .profile in your home directory, or
/etc/profile so all users inherit those environment settings.

In the above, I have assumed you use bash or another derivative of the
Bourne shell.  For csh and its relatives, you would type this, or put
them in .cshrc in your home directory:

	setenv DTK_TCL /usr/local/bin/emacspeak-dt
	setenv DTK_PORT /dev/ttyS1

With the DTK_PORT environment variable set, the driver should announce
itself if you run it from the command line.  It expects commands from
an emacspeak process.  Here is an example:

	emacspeak-dt
	dectalk_speak hello 

The input line must end with a space.  Control-D will stop the driver.

Start Emacspeak with the command 
	emacspeak
which is a shell script installed in /usr/local/bin or /usr/bin.

Please let me know if you have problems or suggestions.

                       - Jim Van Zandt <jrv@vanzandt.mv.com>

---------------------------------------------------------------------
emacspeak-dt is Copyright (c) 1997 by James R. Van Zandt.

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 2 of the License, 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.

