DECtalk ™  Software
Installation Guide
Order Number: AA-XXXXX-TE
April 1998

This guide describes how to install DECtalk Software.




Revision / Update Information:
This document supersedes the DECtalk Software for Windows User's Guide, Version 4.4

Operating System:
Microsoft Windows 95
Microsoft Windows NT
DIGITAL UNIX

Software Version:
DECtalk Software Version 4.5





Digital Equipment Corporation
Maynard, Massachusetts
April 1998
The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that might appear in this document.

No responsibility is assumed for the use or reliability of software or equipment that is not supplied by Digital Equipment Corporation or its affiliated companies.

© Digital Equipment Corporation 1998.

All Rights Reserved.
Printed in U.S.A.

The following are trademarks of Digital Equipment Corporation: 
AlphaStation, DEC, DECtalk, DIGITAL, VAX, and the DIGITAL logo.

Intel is a trademark of Intel Corporation. Microsoft Word for Windows is a registered trademark and Windows 95 and Windows NT are trademarks of the Microsoft Corporation. RoboHELP is a registered trademark of Blue Sky Software Company.  SoundBlaster is a registered trademark of Creative Labs, Inc. UNIX and DIGITAL UNIX are registered trademarks in the United States and other countries licensed exclusively through X/Open Company, Ltd.  Motif is a registered trademark of Open Software Foundation, Inc.

This document was prepared using Microsoft Word 97 to generate MS Word 6.0/95 compatible files. The online help system was prepared with Microsoft Word 97 and the RoboHELP 4.0 help authoring tool.


Contents
Preface	vii
Purpose and Audiences	vii
Structure	vii
What's New in DECtalk Software V4.5?	viii
What's New in DECtalk Software V4.4?	ix
What's New in DECtalk Software V4.3?	ix
Windows Online Help	x
FAQs: Frequently Asked Questions about DECtalk Software	xi
Conventions	xiii
Chapter 1 - Installing DECtalk Software  for Windows	1-1
Preparing for Installation	1-2
Release Notes	1-2
Software License	1-2
Hardware Requirements	1-2
Audio Output Device	1-3
Required Disk Space and Software	1-3
Installing DECtalk Software	1-4
Solving Installation Problems	1-8
Chapter 2 - Installing DECtalk Software for DIGITAL UNIX	2-1
What's the Difference Between the DECtalk Software Runtime Kit and the DECtalk Software Development Kit?	2-2
License Requirements	2-2
Installing DECtalk Runtime Software for DIGITAL UNIX	2-3
Preinstallation Tasks	2-4
Accessing the Release Notes	2-4
Registering Your Software Licenses	2-5
Checking the Software Distribution Kit	2-6
Installation Procedure Requirements	2-8
Hardware Requirements	2-8
Software Requirements	2-8
Checking Current Disk Space	2-9
Increasing Disk Space by Using Alternative Disks	2-9
Installation Tasks	2-10
Using the CD-ROM Consolidated Distribution Media	2-10
Using an RIS Distribution Area	2-11
Starting the Installation Procedure	2-12
Selecting Subsets	2-12
Stopping the Installation	2-16
Post-Installation Tasks	2-16
Running the Installation Verification Procedure	2-17
Deleting DECtalk Software from Your System	2-17
Displaying Documentation from the CD-ROM Distribution Disc	2-18
Correcting Problems During Product Installation	2-18
Reporting Problems	2-19
Installing DECtalk Software Development Kit for DIGITAL UNIX	2-21
Preinstallation Tasks	2-22
Accessing the Release Notes	2-22
Registering Your Software Licenses	2-23
Checking the Software Distribution Kit	2-24
Installation Procedure Requirements	2-25
Hardware Requirements	2-25
Software Requirements	2-26
Checking Current Disk Space	2-26
Increasing Disk Space by Using Alternative Disks	2-27
Installation Tasks	2-27
Using the CD-ROM Consolidated Distribution Media	2-28
Using an RIS Distribution Area	2-28
Starting the Installation Procedure	2-29
Selecting Subsets	2-30
Stopping the Installation	2-33
Post-Installation Tasks	2-34
Running the Installation Verification Procedure	2-34
Deleting DECtalk Software from Your System	2-35
Displaying Documentation from the CD-ROM Distribution Disc	2-35
Correcting Problems During Product Installation	2-35
Reporting Problems	2-36
Index


Figures
Figure 1-1- Installing  DECtalk Software	1-6


Tables
Table 1-1- Installing  DECtalk Software	1-7


Preface
Purpose and Audiences
This guide describes how to install DECtalk Software for Windows and DECtalk Software for DIGITAL UNIX.  
The instructions documented in this guide do not cover basic user information for the operating system.  Only information specific to running DECtalk Software applications is included. 
Structure
The guide is organized as follows:
Chapter 1
Installing DECtalk Software for Windows
Chapter 2
Installing DECtalk Software for DIGITAL UNIX 


What's New in DECtalk Software V4.5?
DECtalk Software V4.5 for Windows 95 and Windows NT contains the following new features:
Distributed on CD-ROM. 
Year 2000 support speaks four-digit year specifications as four-digit year specifications, for example, the year 1998 is spoken as nineteen ninety eight, and speaks 2-digit year specifications as a 2-digit number without asssuming the century, for example, the year 98 is spoken as ninety eight. 
United Kingdom English is added.
SAPI mark syntax (\mrk=\ tag) is working.  The TextData interface now accepts tagged text.  The \mrk=\ tag is the only tag supported.  Other tags are ignored.
ITTSBufNotifySink: The BookMark and WordPosition interfaces are now functional. The timing of the TextDataStarted and TextDataDone notifications is corrected.
ITTSNotifySink: The Visual interface is now functional; the timing of the AudioStart and AudioStop notifications is corrected.
DECtalk Software V4.5 provides better indexing performance than previous versions.
Multi-Language (ML) support is functional.
Sample programs Speak and dtsample are updated to Multi-Language (ML) functionality. All sample applets are ML-compliant code. Some sample applets demonstrate ML-application programming. 
The User Dictionary compiler now handles accent characters (extended ASCII).
OLE notification support, AudioStart and AudioStop, now returned.
The current DECtalk Software implementation of the Microsoft Speech API (SAPI) is described in the appendix3.txt file that is included with the DECtalk Software installation files.
DECtalk Software Implementations and Licensing
DECtalk Software is packaged to run on the Windows NT, and Windows 95 operating systems. The DECtalk Software documentation library is designed as a single library of hardcopy and online documentation for all platforms. Each of the DECtalk Software implementations and its supporting documentation is charted in the following table.
What's New in DECtalk Software V4.4?
DECtalk Software V4.4 for the Windows operating system contains the following new features:
Available in multiple languages: American English, Castilian Spanish, Latin-American Spanish, and German.
Advanced preprocessing rules.
Email parsing has been added to the Mode in-line IDHcommand to expand abbreviations and initialisms as well as stripping unwanted header and footer information.
The SPEAK.EXE demonstration program now shows highlighting.
What's New in DECtalk Software V4.3?
In addition to the new features in DECtalk Software V4.4, the following DECtalk V4.3 features are new to users of DECtalk Software V4.2:
Support for operation on the Windows operating system
Support for the Microsoft Speech Application Programmer's Interface (SAPI)
Support for OLE 
Support for multi-threaded and multi-instance operation 
Expanded main dictionary
A new document, the DECtalk Software Reference Guide has been added.  This guide provides an overview and reference listings of the DECtalk in-line commands.
User-dictionary suffix processing to help locate words in the user dictionary
Expanded pronunciation rules and improved pronunciation
Homograph processing
Improved in-line index-mark processing
Added the following in-line commands:
Play command to play wave audio files in line with text
Tone command to generate tones
Dial command to generate DTMF tones used to dial telephone numbers
Stereo volume control commands
A new Text-to-Speech DDE (Dynamic Data Exchange) server that can be used to run DECtalk Software from within an application, such as MS Word 
A speech-to-memory Sample program 
An enhanced User Dictionary Builder that automatically translates text strings into phonemes
A new command-line applet named Say that runs DECtalk Software from the Windows command line 
Windows Online Help
DECtalk Software online Help is part of the application and is easily accessed from any of the program applets or from the Help icon in the DECtalk program group.  
You can find specific information in Help by using keyword searches and the index. Windows Help has a powerful cross-referencing facility that allows you to access many related topics in the same session.
The DECtalk Help file provides help on: 
DECtalk program applets
You also can access help on specific applets when you display help by double-clicking the Help icon, double-click the DECtalk Software Help book, and choose Graphical Programming Applet Master Index.  Click the icon of the applet for which you want help.
DECtalk Software APIs and API function calls
Display Help by double-clicking the Help icon:
Double-click the DECtalk Software Help book, double-click the Programmer's Guide, and choose Introduction to the DECtalk Software API 
Double-click the DECtalk Software Help book, double-click the Reference Guide, and choose DECtalk Software API Function Calls  
DECtalk Software in-line commands
Display Help by double-clicking the Help icon, double-click the DECtalk Software Help book, double-click the Reference Guide and choose:
DECtalk Software In-Line Commands 
Using In-Line Commands
DECtalk Software reference tables
Display Help by double-clicking the Help icon, double-click the DECtalk Software Help book, double-click the Reference Guide, and choose DECtalk Software Reference Tables.
FAQs: Frequently Asked Questions about DECtalk Software
Q: What is DECtalk Software?
A: DECtalk Software is software that converts ASCII text into speech without the use of special or proprietary hardware.
Q: What hardware does it support? Does it work or require a DECtalk hardware device?
A: Although DECtalk Software does not need any specialized hardware (specialized hardware is defined as boards and devices DIGITAL has released over the past 12 years with other DECtalk products) for the text-to-speech conversion process, you must have a sound card installed or built into your computer.
Q:  Who is DECtalk Software for?
A:  DECtalk Software is for users and developers.
For users, there are the Speak, Sample, and Dictionary applets.  These provide a runtime environment in which users can speak text files directly with DECtalk or through other applications, such as Microsoft Word. 
For the developer, DECtalk also provides an API that can be used to include text-to-speech synthesis in Windows applications. 
Q: How long does it take DECtalk Software to start speaking?
A: DECtalk Software is optimized for quick startup. However, speaking start time is hardware (processor type) and software (operating system) dependent.
Q: Can DECtalk Software be used in a telephony environment. 
A: Yes, DECtalk Software supports 8-bit mu-law synthesis and a multi-instance environment with the proper licenses.
Q: Can I create my own DECtalk voice?
A: Yes! In addition to the nine predefined voices, you can create a customized voice of your own. See Chapter 5 in the DECtalk Software Reference Guide.
Q: What is the difference between DECtalk Software for the Windows operating system and other DIGITAL DECtalk products?
A: The DECtalk family of products is listed in the following table.

Product
Operating System
Comments
DECtalk Software for the Windows NT Operating System
Windows NT
Has API and OLE
DECtalk Software for DIGITAL UNIX
DIGITAL UNIX
Has API
DECtalk-PC (DTC07)
DOS
Hardware assisted
DTC01
Custom
6800 cpu based, serial port, telephone interface product (assistive)
DTC03
Custom
Rack mount telephone interface product (non-assistive)
DTC05
Custom

DECtalk Express (DTC08)
Custom
Box with a serial interface and speaker
Conventions
The following conventions are used in this guide:
Convention
Meaning
enter
Enter means type the required information and press the Enter key.
mouse
Mouse refers to any pointing device, such as a mouse, a puck, or a stylus.
MB1
MB1 indicates the left mouse button.
click 
Click means to press and release MB1. 
Double click 
Double click means to press and release MB1 twice in rapid succession without moving the mouse.
drag
The phrase drag means to press and hold MB1, move the mouse, and then release MB1 when the pointer is in the desired position.
Ctrl/x
Press the Ctrl key while you press another key.
Menu ⇒Command
The right arrow key indicates an abbreviated instruction for choosing a command from a menu. For example, File ⇒Exit  means pull down the File menu, move the pointer to the Exit command, and release MB1. 
Courier type
Courier type indicates text that is typed or displayed on the screen. This is most often used for program code examples.
User Input
Boldface type in interactive examples indicates information you enter from the keyboard. For example: 
A:>SETUP
XX YY and 
XXn YYn
In DECtalk Software in-line command syntax, XX and YY indicate options and parameters. When more than one choice of options or parameters is allowed, the symbol XXn or YYn with n replaced by a numeral indicates each option or parameter in the symbolic representations, such as [:phoneme XX1 XX2 YY]. Note that the number of characters in the symbolic representation does NOT represent the number of characters allowed in the actual option or parameter name.
DD and DDn
In DECtalk Software in-line command syntax, DD indicates a decimal (base 10) value. When more than one decimal values are allowed, the symbol DDn with n replaced by a numeral represents each allowed value, such as [:volume XX DD1 DD2]. Note that the number of characters in the symbolic representation does NOT represent the number of characters allowed in the actual decimal value.
Conventions used in API calls
bold
Bold text indicates call names, data structures, and field names. 
Italics
Italic text indicates call arguments and emphasizes important information.
Unless otherwise noted, press Enter after typing responses to command prompts.


Chapter 1-
Installing DECtalk Software 
for Windows
This chapter provides the information you need to install DECtalk Software and important information about registering your DECtalk Software product.
Specific topics include:
Preparing for installation
Installing DECtalk Software
Solving installation problems
Preparing for Installation 
DECtalk Software is installed from the installation media shipped with the product. The installation should take you no longer than ten minutes to complete. You can install DECtalk Software from the Windows command line or from within the File Manager. 
Before installing DECtalk Software, make sure that all prerequisite software and hardware components are installed on your system. Consult the release notes and carefully read the DECtalk Software license agreement. DIGITAL recommends that you back up the disk or file system you will be installing DECtalk Software on before installing DECtalk Software.
Release Notes
Before you install the DECtalk Software product, DIGITAL strongly recommends that you read the release notes in the readme.txt file found in the installation directory. These notes contain the latest information about the product.  
Software License
The software license is subject to the software agreement enclosed in the product kit containing the installation disks and documentation.
Hardware Requirements
Hardware requirements include a standard audio sound card and adequate disk space for installation.
DECtalk Software performance is dependent on your system having enough computational power to perform all the computations involved in text-to-speech conversion. See the Software Product Description or release notes for a list of the latest supported systems.
Note
DECtalk Software performance can be affected in a heavily loaded multitasking environment where DECtalk Software could become starved for computational power and will not speak continuously. There might be pauses in output for any application running on such a system.

Audio Output Device 
Your system must be configured with an audio device (and appropriate driver) that support 8-bit or 16-bit data format at an 11.025 kHz sample rate. You can install DECtalk Software without an audio device present and capture .WAV audio files; however, an audio device must be present to actually have DECtalk Software speak text.
Required Disk Space and Software
DECtalk Software requires that you have a minimum of 3 MB disk space for proper configuration and installation.
DECtalk Software requires that you have the Windows NT or Windows 95 operating systems installed and running on your computer.
Installing DECtalk Software
You can install DECtalk Software from within Windows using the Windows Explorer or from the Windows operating system Run dialog. 
If a previous version of DECtalk Software exists on your system, the new installation overwrites it.
Note
Before installing this version of DECtalk Software, please close any already running DECtalk applications and uninstall any existing DECtalk  Software.	
This Software Development Kit (SDK) is on a single CD-ROM that contains English U S, English U K, Spanish, Spanish Latin American and Multi-Language (ML) installation disk image sets.
Each language specific image set consists of 7 disk images. These separate into a 3 disk image set for installation on Intel processors and a 4 disk image set for installation on Alpha processors. Each disk image set is further separated into install disk images and an incremental license/key disk image.
1.Select the disk image set for the desired language. The languages are in separate directories on the CD-ROM and are identified as follows:
* "u s" is English U S, 
* "u k" is English U K, 
* "s p" is Spanish, and 
* "l a" is Spanish L A.
2.Select the disk image set for the target processor (Intel or Alpha). 
The ML install disk image set consists of one single disk image for Intel  and one for Alpha. There is no incremental license/key disk image for ML.
3.Identify the install disk images that make up the install kit and the single disk image that has the incremental license/key program. 
4.Run the program SETUP.EXE from the installation disk image 1. 
This can be done two ways.  Either click on program SETUP.EXE in the file manager or in an MS-DOS window, select the appropriate drive for the distribution media by typing the proper drive letter (for example, e:), change the default directory to the language or ML specific directory, then change the default directory to the processor type specific directory, (cd us\intel), then type SETUP and press Enter. The setup program then prompts for any additional information (that is, Username, company, destination drive).  Possible distribution media include floppy disks and CD-ROMs.  The drive for floppy disks is usually the a: drive; the drive for CD-ROMs can be d:, e:, or any other letter mapped to the CD-ROM reader drive.
When the installation is complete and if you are installing a specific language, find the incremental license/key directory (license)in the file manager, or in an MS-DOS window, change default to the incremental license/key directory (cd license), and run the program LICENINC3.EXE to increment the license/key count to 4.
Consult the DECtalk Software Documentation for additional information.
For a listing of files contained in the source media, please refer to file APPENDIX1.txt.
For development hints, please refer to file APPENDIX2.txt.
For a list of Microsoft Speech API functions supported by DECtalk Software, please refer to file APPENDIX3.txt.
Figure 1-1- Installing DECtalk Software

Table 1-1- Installing DECtalk Software
Task/Location
Action
Result
Drive for the distribution media
For all installation procedures, insert the distribution media in an appropriate drive for that media. 
Installing DECtalk Software from the Windows Explorer
With the Windows Explorer displayed (1) 
1.Display the directory listing for the drive with the distribution media.
2.Select the disk image set for the target processor.


3.Double click on the setup.exe file.  (2) 
The DECtalk Software installation process begins.
Installing DECtalk Software from the Windows Run dialog box
On the Task Bar
1.Click Start	
The Workstation menu is displayed. 
On the Workstation menu
2.Click Run.	
The Run dialog box is displayed. (3)
Run dialog box (3) 
3.Enter a:\setup. (4) (where a: is replaced by the appropriate drive letter for the drive with the distribution media.)




4.Click on OK. (5) 
The DECtalk Software installation process begins.
Installing DECtalk Software from the Windows Command Prompt dialog
On the Task Bar
1.	Click Start, then click Programs.	


2.From the programs list, click Command Prompt. 
The Command Prompt dialog (6) displays.
Command Prompt dialog.  (6)
3.Set the default directory to the drive letter for the drive with the distribution media by typing that letter followed by a colon. (7)


4.Enter setup and respond to the prompts.  (8)
The DECtalk Software installation process begins.
For all installation procedures:
DECtalk Software prompts you for required installation information through a number of screen prompts.
A message is displayed when installation is complete.
Solving Installation Problems 
If errors occur during the installation procedure, DECtalk Software returns an error message. Installation errors usually occur if any of the following conditions exist:
The operating system version is incorrect.
The prerequisite software and hardware components or version is missing or incorrect. 
There is insufficient disk space. 
System files and parameters are not updated to reflect exact file locations and directory naming conventions. 
If you have problems while using DECtalk Software and you believe the error is caused by the application, do one of the following based on the type of support service your organization has obtained from DIGITAL:
If you have a Software Product Services Support Agreement, contact your Customer Support Center for advisory and remedial advice.
Submit a Software Product Report (SPR).


Chapter 2-
Installing DECtalk Software
for DIGITAL UNIX


This chapter describes the tasks required to install DECtalk runtime and development software on DIGITAL UNIX systems.  Topics include:
What's the Difference Between the DECtalk Software Runtime Kit and the DECtalk Software Development Kit?
License Requirements
Installing DECtalk Runtime Software for DIGITAL UNIX
Installing DECtalk Development Software for DIGITAL UNIX
What's the Difference Between the DECtalk Software Runtime Kit and the DECtalk Software Development Kit?
DECtalk Software for DIGITAL UNIX is packaged as a runtime kit and a development kit. The runtime kit gives you access to the following DECtalk Software applications: say, speak, emacspeak, aclock, and windict.
In order to develop your own DECtalk Software applications, you must order the DECtalk Software Development Kit. DECtalk Software Development Kit gives you access to the DECtalk Software API and sources for some sample application programs.
NOTE: You must install the runtime kit in order to install the development kit.

License Requirements
You can run one copy of any DECtalk Software application at a time without needing an LMF license. A license is required to run more than one copy of the runtime kit or to use the DECtalk Software Development Kit. See the sections on LMF Licensing under each software kit for more information.
Installing DECtalk Runtime Software for DIGITAL UNIX
This section describes the preinstallation, installation, and post-installation tasks required to install the DECtalk Software runtime kit on DIGITAL UNIX systems.  Topics include:
Preinstallation Tasks
Accessing the Release Notes
Registering Your Software Licenses
Checking the Software Distribution Kit
Installation Procedure Requirements
Hardware Requirements
Software Requirements
Checking Current Disk Space
Increasing Disk Space by Using Alternative Disks
Installation Tasks
Using the CD-ROM Consolidated Distribution Media
Using an RIS Distribution Area
Starting the Installation Procedure
Selecting Subsets
Stopping the Installation
Post-Installation Tasks
Running the Installation Verification Procedure
Deleting DECtalk Software from Your System
Displaying Documentation from the CD-ROM Distribution Disc
Correcting Problems During Product Installation
Reporting Problems
The runtime software installation procedure installs all files in subdirectories under:
/usr/opt/DTKRT450
After a successful installation, DECtalk Software online help is accessible in two forms:
Manpages - Invoke manpage help from the UNIX command line with the %man speak command
HTML Hypertext - Start Netscape hypertext help by launching Netscape and loading the online help html file defaultdectalk.html.
Preinstallation Tasks
This section covers the preinstallation tasks you must perform before installing the DECtalk Software runtime kit. Topics include:
Accessing the Release Notes
Installation Procedure Requirements
Hardware Requirements
Checking Current Disk Space
Accessing the Release Notes
DECtalk Software provides release notes containing information about changes to DECtalk Software for DIGITAL UNIX. DIGITAL strongly recommends that you read these release notes before using the product. See the Compact Disc User's Guide shipped with your media for instructions about how to access the release notes prior to the software installation.
The release notes for the DECtalk Software runtime kit are in the following files after the DTKRTRELNOTES450 subset is installed:
/usr/opt/DTKRT450/docs/ascii/release_notes_rt.txt
/usr/opt/DTKRT450/docs/postscript/release_notes_rt.ps
Use the following command to read the release notes for DECtalk Software after the DTKRTRELNOT450 subset is installed:
# more /usr/opt/DTKRT450/docs/ascii/release_notes_rt.txt
You can also print either file.
Registering Your Software Licenses
DECtalk Software includes support for the License Management Facility (LMF). You must register your license product authorization keys (License PAKs) in the license database (LDB) in order to use DECtalk Software on a newly licensed system. The License PAKs are shipped with the kit if you ordered the licenses and media together; otherwise, they are shipped separately to a location specified on your license order.
NOTE: You must have superuser privileges to install the DECtalk Software and to register the license PAK.
If you are installing DECtalk Software as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.
To register a license under the DIGITAL UNIX operating system:
1.Log in as root.
2.At the superuser prompt, edit an empty PAK template with the lmf register command as follows, and include all the information on your License PAK:
# lmf register
LMF displays a blank template and invokes an editor to allow you to edit the template. LMF invokes the editor that is defined by your EDITOR environment variable. If the environment variable is undefined, LMF invokes the vi editor.
You must enter the license information from the PAK accurately.
3.When you finish entering the license data, exit from the editor. If the license data is correct, LMF copies it into the license database. If the license data is incorrect, you may reenter the editor and correct mistakes.
Alternatively, you can create a command script enclosing the license information (the license information is in the cover letter with this kit) found between
lmf register - << ENDLMF
and
ENDLMF
Execute this script as root.
4.After you register your license, use the following commands to copy the license details from the license database (LDB) to the kernel cache:
# lmf load 0 DECTALK-SW97
For complete information on using the License Management Facility, see the Guide to Software License Management and the lmf reference page.
Checking the Software Distribution Kit
Use the bill of materials (BOM) to check the contents of your DECtalk Software software distribution kit.
In addition to this guide, the software distribution kit includes the following:
CD-ROM optical disc for systems with optical disc drives
CD-ROM booklet
If your software distribution kit is damaged or incomplete, contact your DIGITAL representative.
Directories and files included in the distribution kit are listed in the following screen display:
/usr/opt/DTKRT450/docs/ascii:
dtk450_release_notes_rt.txt filelist_rt.txt

/usr/opt/DTKRT450/docs/html:
defaultdectalk.html
**other html filenames TBS**

/usr/opt/DTKRT450/docs/man/man1:
aclock.1       emacspeak.1    speak.1
dectalk.1      say.1          windict.1

/usr/opt/DTKRT450/docs/postscript:
dtk450_release_notes_rt.ps

/usr/opt/DTKRT450/emacspeak/Macros:
HELP emacspeak-ispell.el
Makefile emacspeak-keymap.el
dtk-macros.el emacspeak-kotl.el
dtk-mme* emacspeak-load-path.def
dtk-sh.el emacspeak-oo-browser.el
dtk-spatial.el emacspeak-outline.el
dtk-speak.el emacspeak-perl.el
dtk-voices.el emacspeak-redefine.el
emacspeak-advice.el emacspeak-replace.el
emacspeak-auctex.el emacspeak-setup.def
emacspeak-bbdb.el emacspeak-sounds.el
emacspeak-c.el emacspeak-speak.el
emacspeak-calc.el emacspeak-tabulate.el
emacspeak-calendar.el emacspeak-tcl.el
emacspeak-compile.el emacspeak-tempo.el
emacspeak-dired.el emacspeak-vm.el
emacspeak-dmacro.el emacspeak-w3.el
emacspeak-ediff.el emacspeak-wrolo.el
emacspeak-eterm.el emacspeak.def
emacspeak-fix-interactive.el emacspeak.el
emacspeak-folding.el html-voice.el
emacspeak-gnus.el play.def
emacspeak-hyperbole.el voice-lock.el
emacspeak-info.el w3-util.el

/usr/opt/DTKRT450/emacspeak/docs/ascii:
emacspeak-README.txt

/usr/opt/DTKRT450/emacspeak/docs/postscript:
emacspeak.ps

/usr/opt/DTKRT450/etc/dt/appconfig/appmanager/C/Multimedia:
dtk_speak* dtk_windict*

/usr/opt/DTKRT450/etc/dt/appconfig/icons/C:
dtk_speak.s.bm dtk_windict.m.bm
dtk_speak.s.pm dtk_windict.m.pm
dtk_speak.l.bm dtk_speak.t.bm dtk_windict.s.bm
dtk_speak.l.pm dtk_speak.t.pm dtk_windict.s.pm
dtk_speak.m.bm dtk_windict.l.bm dtk_windict.t.bm
dtk_speak.m.pm dtk_windict.l.pm dtk_windict.t.pm

/usr/opt/DTKRT450/etc/dt/appconfig/types/C:
dtk_speak.dt dtk_windict.dt

/usr/opt/DTKRT450/examples/dtk/dtsamples:
aclock* demo.txt say* user.dic
birthday.txt noglass.txt startup.txt user.tab

/usr/opt/DTKRT450/examples/dtk/speak:
bitmaps/ speak* speak.uid

/usr/opt/DTKRT450/examples/dtk/speak/bitmaps:
bet16a.gif dtk.gif har16b.gif pau16b.gif urs16b.gif
bet16b.gif fra16a.gif kid16a.gif rit16a.gif wen16a.gif
den16a.gif fra16b.gif kid16b.gif rit16b.gif wen16b.gif
den16b.gif har16a.gif pau16a.gif urs16a.gif windict.gif

/usr/opt/DTKRT450/ivp:
DTKRT450.ivp

/usr/opt/DTKRT450/lib/dtk:
dectalk.dic  dtalk_la.dic dtalk_uk.dic
dtalk_gr.dic dtalk_sp.dic dtalk_us.dic

/usr/opt/DTKRT450/share/man/man1:

aclock.1dtk   emacspeak.1dtk  speak.1dtk
dectalk.1dtk  say.1dtk        windict.1dtk

/usr/opt/DTKRT450/shlib:
libtts.so* libttsmme.so*

/usr/opt/DTKRT450/tools:
dumpdict* userdict* windict* windict.uid

Installation Procedure Requirements
This section discusses the requirements for installing the DECtalk Software runtime kit.
Installing DECtalk Software takes approximately 5 minutes, depending on your type of media and system configuration.
Hardware Requirements
To install DECtalk Software, you need the following:
Software distribution device (if installing from media)
Locate the drive for the CD-ROM software distribution media. The CD booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media.
Terminal
You can use either a hardcopy or video terminal to communicate with the operating system and respond to the prompts from the installation procedure.
See the DECtalk Software for DIGITAL UNIX Software Product Description (SPD) for additional hardware requirements.
Software Requirements
DECtalk Software for DIGITAL UNIX Version 4.5 requires the DIGITAL UNIX operating system Version 3.x or 4.x.  DIGITAL also strongly recommends Multimedia Services for DIGITAL UNIX Version 2.x for use with the runtime kit.
Checking Current Disk Space
To check the current amount of free space for a directory path, log in to the system where you will install DECtalk Software. You can check which directories are mounted and their locations by viewing the /etc/fstab file.
For example:
# more /etc/fstab
/dev/rz3a / ufs rw 1 1
/dev/rz3g /usr ufs rw 1 2
/dev/rz3b swap1 ufs sw 0 2
The display indicates that /usr mounted on /dev/rz3g is the only mount point that affects where DECtalk Software files will reside; the system has only one local disk drive, and the /usr/opt file system resides in the g partition of the disk on that drive.
To check the total space and the free space for the directories where DECtalk Software will reside, enter the df command. Given the previous display of the /etc/fstab) file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system. For example:
# df /usr
Filesystem  512-blocks  Used   Avail  Capacity Mounted on
/dev/rz3a   79608       45648  25998  64%      /
/dev/rz3g   1482190     921846 412124 69%      /usr
This display shows that there are 206062 kbytes free. This free space must accommodate the subsets that you opt to install. If you choose to install all the subsets in the DECtalk Software Runtime kit you will need approximately 11 Mbytes of free disk space. Of this, the unsupported Emacspeak subset uses 2 Mbyte.
Increasing Disk Space by Using Alternative Disks
The DECtalk Software installation procedure creates and loads files into the subordinate directory:
/usr/opt/DTKRT450
If any of the previously listed directories already exists, the installation procedure uses it.
If you find that there is insufficient disk space for the DECtalk Software subsets and you know that you have additional space on alternative disks or disk partitions for your system, perform the following steps before installing DECtalk Software:
1.Log in as superuser.
2.Create the following directory: 
/usr/opt/DTKRT450
3.Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 
4.Enter the mount -a command so that the new mount points take effect. 
Installation Tasks
This section covers the installation tasks you must perform to install DECtalk Software. Topics include:
Using the CD-ROM Consolidated Distribution Media
Using an RIS Distribution Area
Starting the Installation Procedure
Selecting Subsets
Stopping the Installation
Using the CD-ROM Consolidated Distribution Media
The following procedure loads DECtalk Software files onto a disk belonging to the system where you perform the installation. When DECtalk Software is run, its executable images are mapped into memory on your system.
To install DECtalk Software from CD-ROM media:
1.Mount the media on the appropriate disk drive.
2.Log in as superuser login name root to the system where you will install DECtalk Software.
3.Make sure that you are at the root (/) directory by entering the following command:
# cd /
4.Specify the /cdrom directory to be the mount point for the distribution file system on the drive. If your drive is rz4c, enter the following command: 
# mount -dr /dev/rz4c /cdrom
5.Enter a setld command that requests the load function -l and identifies the directory in the mounted file system where DECtalk Software subsets are located. For example, if the directory location for these subsets is /cdrom/4.0/DTK450/kit, where "4.0" denotes a DIGITAL UNIX Version 4 installation, enter the following command: 
# /usr/sbin/setld -l /cdrom/4.0/DTK450/kit
For a DIGITAL UNIX Version 3.2 installation, you would use /cdrom/3.2/DTK450/kit. 
6.The installation procedure now displays the names of DECtalk Software runtime kit subsets and asks you to specify the subsets you want to load. 
See Starting the Installation Procedure to continue the installation. 
Using an RIS Distribution Area
If you are installing DECtalk Software subsets that reside in an /etc/ris RIS distribution area on a remote system, take the following steps:
1.Log in as superuser login name root to the system where you will install DECtalk Software runtime kit.
2.Make sure that you are at the root directory (/) by entering the following command:
# cd /
3.Enter a setld command that requests the load function (-l) option and identifies the system where the DECtalk Software subsets are located. For example, if you are loading DECtalk Software subsets from a RIS distribution area on node axpmme, enter the following: 
/usr/bin/setld -l axpmme
4.RIS now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load. 
See Starting the Installation Procedure to continue the installation. 
Starting the Installation Procedure
Before starting the installation procedure:
1.Log in as a superuser and verify that you are at the root directory.  Check to see if there are any previously installed DECtalk Software subsets by entering the following commands:
% su root
# cd /
# /usr/sbin/setld -i | grep DTK
2.Deinstall any installed subsets with the prefix DTK by entering the following commands: 
# cd /
# /usr/sbin/setld -d (name of subset)
3.To start the installation procedure, enter the following command: 
# /usr/sbin/setld -l /dev/rmt0h
4.Respond to the installation procedure prompts as described in Selecting Subsets. 
Selecting Subsets
The following section presents a complete installation procedure, including all messages that are displayed on your screen during the installation.
You must specify which DECtalk Software subsets you want to load. If you specify more than one number at the prompt, separate each number with a space, not a comma.
# /usr/sbin/setld -l /cdrom/4.0/DTK450/kit

The subsets listed below are optional:

   There may be more optional subsets than can be presented on a single
   screen. If this is the case, you can choose subsets screen by screen or
   all at once on the last screen. All of the choices you make will be 
   collected for your confirmation before any subsets are installed.

   1) DECtalk Software V4.5 for DIGITAL UNIX CDE Integration.
   2) DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
   3) DECtalk Software V4.5 for DIGITAL UNIX Runtime Kit.
   4) DECtalk Software V4.5 for DIGITAL UNIX Documentation.
   5) Emacspeak, Speech Enabled Emacs - Sample Program (unsupported).

Or you may choose one of the following options:

   6) ALL of the above
   7) CANCEL selections and redisplay menus
   8) EXIT without installing any subsets

Enter your choices or press RETURN to redisplay menus.

Choices (for example, 1 2 4-6): 6
Next, the script lets you verify your choice. For example, if you enter 6 in response to the previous prompt, you will see the following display:
You are installing the following optional subsets:

   DECtalk Software V4.5 for DIGITAL UNIX CDE Integration.
   DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
   DECtalk Software V4.5 for DIGITAL UNIX Runtime Kit.
   DECtalk Software V4.5 for DIGITAL UNIX Documentation.
   Emacspeak, Speech Enabled Emacs - Sample Program.

Is this correct? (y/n):
If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is displayed again and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. After you respond to this question, the rest of the installation proceeds automatically and all the selected subsets are loaded. A sample of the rest of the installation script is listed below.
Checking file system space required to install selected subsets:

   File system space checked OK.

   5 subset(s) will be installed.

   Loading 1 of 5 subset(s)....

***********************************************************************
*                                                                     *
* DECtalk Software Application Services V4.5                          *
* Runtime Subset                                                      *
*                                                                     *
* Copyright(c)Digital Equipment Corporation, 1998 All Rights Reserved *
*                                                                     *
* Unpublished rights reserved under the copyright laws of the United  *
* States. The software contained on this media is proprietary to      *
* and embodies the confidential technology of Digital Equipment       *
* Corporation. Possession, use, duplication or dissemination of the   *
* software and media is authorized only pursuant to a valid written   *
* license from Digital Equipment Corporation.                         *
*                                                                     *
* RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the     *
* U.S. Government is subject to restrictions as set forth in          *
* Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, *
* or in FAR 52.227-14 Alt. III as applicable.                         *
*                                                                     *
***********************************************************************

DECtalk Software V4.5 for DIGITAL UNIX Runtime Kit.
Copying from . (disk)
Verifying

Loading 2 of 5 subset(s)....

DECtalk Software V4.5 for DIGITAL UNIX Runtime Users Guide.
Copying from . (disk)
Verifying

Loading 3 of 5 subset(s)....

DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
Copying from . (disk)
Verifying

Loading 4 of 5 subset(s)....

***********************************************************************
*                                                                     *
* DECtalk Software Application Services V4.5                          *
* Emacspeak Subset                                                    *
*                                                                     *
* Copyright(c)Digital Equipment Corporation, 1998 All Rights          *
* Reserved                                                            *
*                                                                     *
* Unpublished rights reserved under the copyright laws of the United  *
* States. The software contained on this media is proprietary to      *
* and embodies the confidential technology of Digital Equipment       *
* Corporation. Possession, use, duplication or dissemination of the   *
* software and media is authorized only pursuant to a valid written   *
* license from Digital Equipment Corporation.                         *
*                                                                     *
* RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the     *
* U.S. Government is subject to restrictions as set forth in          *
* Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, *
* or in FAR 52.227-14 Alt. III as applicable.                         *
*                                                                     *
***********************************************************************

Emacspeak, Speech Enabled Emacs - Sample Program.
Copying from . (disk)
Verifying

Loading 5 of 5 subset(s)....

DECtalk Software V4.5 for DIGITAL UNIX CDE Integration.
Copying from . (disk)
Verifying

5 of 5 subset(s) installed successfully.

***********************************************************************

DECtalk Software V4.5 runtime subset (DTKRT450) installation completed
successfully.

To verify that the kit installed properly please run the Installation
Verification Program by typing:

/usr/sbin/setld -v DTKRT450

***********************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Runtime Kit."
(DTKRT450)

***********************************************************************

DECtalk Software V4.5 runtime documentation subset (DTKRTDOC450)
installation completed successfully. This installation puts the
DECtalk Software online help in html format in the following directory:

  /usr/opt/DTKRT450/docs/html

You can view the online help with a Netscape(TM) browser.  Open the file

  /usr/opt/DTKRT450/docs/html/defaultdectalk.html

***********************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Documentation."
(DTKRTDOC450)

**********************************************************************<>

DECtalk Software V4.5 runtime release notes subset (DTKRTRELNOT450)
installation completed successfully. This installation put DECtalk
Software development subset release notes in the following directories:

/usr/opt/DTKRT450/docs/ascii and
/usr/opt/DTKRT450/docs/postscript

**********************************************************************<>

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Release Notes."
(DTKRTRELNOT450)

***********************************************************************

DECtalk Software V4.5 runtime subset (DTKEMSRT450) installation
completed successfully.

To run the program, please refer to the emacspeak-README.txt file
in:
/usr/opt/DTKRT450/emacspeak/docs/ascii

***********************************************************************

Configuring "Emacspeak, Speech Enabled Emacs - Sample Program."
(DTKEMSRT450)

**********************************************************************<>

DECtalk Software V4.5 CDE Integration subset (DTKRTCDE450) installation
completed successfully.

**********************************************************************<>

Configuring "DECtalk Software V4.5 for DIGITAL UNIX CDE Integration."
(DTKRTCDE450)
#
Stopping the Installation
To stop the installation procedure at any time, press Ctrl/C. Then, interactively delete the files created by the installation up to the point where you stopped the installation. The directories and files created during the DECtalk Software installation are listed in the following file:
/usr/opt/DTKRT450/docs/ascii/filelist.txt
If you encounter any failures during installation, see Reporting Problems.
You may interrupt the installation procedure at any point. However, if you do, the installation may not be left in a useful state. Remove all the subsets you installed and reinstall them.
Post-Installation Tasks
This section explains the post-installation tasks you need to do after the runtime kit installation to make DECtalk Software ready for use. Topics include:
Running the Installation Verification Procedure
Deleting DECtalk Software from Your System
Displaying Documentation from the CD-ROM Distribution Disc
Correcting Problems During Product Installation
Reporting Problems
Running the Installation Verification Procedure
You can run the Installation Verification Procedure (IVP) during the installation or you can run the IVP independently after installing DECtalk Software to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DECtalk Software.
To run the IVP, enter these commands:
% su root
#/usr/sbin/setld -v DTKRT450
The DECtalk Software IVP verifies the installation as follows:
1.A check for a valid LMF license is made. If no license is found, the IVP fails because the software cannot be tested.
2.DECtalk Software requires that the Multimedia Software for DIGITAL UNIX server mmeserver be up and running. If the mmeserver is not already running then the IVP fails. Start the server and try again. To start the server follow the sequence shown below:
% su root
# mmeserver&
Deleting DECtalk Software from Your System
If you must remove a version of DECtalk Software from your system, delete each subset that you previously installed.
For example to delete a subset, do the following:
1.Log in as superuser login name root, as follows:
% su root
2.Verify that you are at the root directory (/) by entering the following command: 
# cd /
3.Enter the following form of the setld commands: 
# setld -i | grep DTK
4.Look for the word "installed" in the listing produced, and then delete the installed subsets. For example: 
# setld -d DTKRT450
# setld -d DTKDEV450
Displaying Documentation from the CD-ROM Distribution Disc
The DECtalk Software documentation is provided on the DIGITAL UNIX Layered Products Online Documentation CD-ROM in html file format. You can display the files on your workstation using a browser application such as Netscape(TM). For information on accessing and displaying these files, see the DIGITAL UNIX Layered Products Disc User's Guide.
Correcting Problems During Product Installation
If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, a message similar to the following is displayed:
There is not enough space for subset SUBSET_NAME
SUBSET_DESCRIPTION (SUBSET_NAME) will not be loaded.
where SUBSET_NAME is the name of the subset and SUBSET_DESCRIPTION is the description of the subset.
For example, DTKRTRELNOT450 is a subset name and DECtalk Software for DIGITAL UNIX Release Notes V4.5 is a subset description.
Errors can occur during the installation if any of the following conditions exist:
Operating system version is incorrect.
Prerequisite software version is incorrect.
Disk space is insufficient.
System parameter values for successful installation are insufficient.
For descriptions of error messages generated by these conditions, see the DIGITAL UNIX documentation on system messages, recovery procedures, and software installation.
Reporting Problems
If an error occurs while DECtalk Software is in use and you believe the error is caused by a problem with the product, take one of the following actions:
If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following:
1.The name and version number of the operating system you are using
2.The version number of DECtalk Software you are using
3.The hardware system you are using (such as a model number)
4.A brief description of the problem (one sentence, if possible)
5.How critical the problem is
If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR).
If you do not have any type of software services support agreement and you purchased DECtalk Software within the past year, you can submit an SPR if you think the problem is caused by a software error.
When you submit an SPR, take the following steps:
1.Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the DECtalk Software being used. Explain the problem with specific examples.
2.Reduce the problem to its elements.
3.Remember to include listings of any command files, include files, relevant data files, and so forth.
4.Provide a listing of the program.
If the program is longer than 50 lines, submit a copy of it on machine-readable media (floppy diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application.
For information about submitting media, see the tar(1) reference page.
5.Report only one problem per SPR. This will facilitate a faster response. 
6.Mail the SPR package to DIGITAL. 
If the problem is related to DECtalk Software documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe).
Installing DECtalk Software Development Kit for DIGITAL UNIX
This section describes the preinstallation, installation, and post-installation tasks required to install the DECtalk Software development kit on DIGITAL UNIX systems.  Topics include:
Preinstallation Tasks
Accessing the Release Notes
Registering Your Software Licenses
Checking the Software Distribution Kit
Installation Procedure Requirements
Hardware Requirements
Software Requirements
Checking Current Disk Space
Increasing Disk Space by Using Alternative Disks
Installation Tasks
Using the CD-ROM Consolidated Distribution Media
Using an RIS Distribution Area
Starting the Installation Procedure
Selecting Subsets
Stopping the Installation
Post-Installation Tasks
Running the Installation Verification Procedure
Deleting DECtalk Software from Your System
Displaying Documentation from the CD-ROM Distribution Disc
Correcting Problems During Product Installation
Reporting Problems
The development software installation procedure installs all files in subdirectories under:
/usr/opt/DTKDEV450
After a successful installation, DECtalk Software online help is accessible in two forms:
Manpages - Invoke manpage help from the UNIX command line with the %man speak command
HTML Hypertext - Start Netscape hypertext help by launching Netscape and loading the online help html file defaultdectalk.html.
Preinstallation Tasks
This section covers the preinstallation tasks you must perform before installing the DECtalk Software development kit. Topics include:
Accessing the Release Notes
Installation Procedure Requirements
Hardware Requirements
Checking Current Disk Space
Accessing the Release Notes
DECtalk Software provides release notes containing information about changes to DECtalk Software for DIGITAL UNIX. DIGITAL strongly recommends that you read these release notes before using the product. See the Compact Disc User's Guide shipped with your media for instructions about how to access the release notes prior to the software installation.
The release notes for the DECtalk Software development kit are in the following files after the DTKDEVRELNOTES450 subset is installed:
/usr/opt/DTKDEV450/docs/ascii/release_notes_dev.txt
/usr/opt/DTKDEV450/docs/postscript/release_notes_dev.ps
Use the following command to read the release notes for DECtalk Software after the DTKDEVRELNOT450 subset is installed:
# more /usr/opt/DTKDEV450/docs/ascii/release_notes_dev.txt
You can also print either file.
Registering Your Software Licenses
DECtalk Software includes support for the License Management Facility (LMF). You must register your license product authorization keys (License PAKs) in the license database (LDB) in order to use DECtalk Software on a newly licensed system. The License PAKs are shipped with the kit if you ordered the licenses and media together; otherwise, they are shipped separately to a location specified on your license order.
NOTE: You must have the root privileges to install the DECtalk Software and to register the license PAK.
If you are installing DECtalk Software as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.
To register a license under the DIGITAL UNIX operating system:
1.Log in as root.
2.At the superuser prompt, edit an empty PAK template with the lmf register command as follows, and include all the information on your License PAK: 
# lmf register
LMF displays a blank template and invokes an editor to allow you to edit the template. LMF invokes the editor that is defined by your EDITOR environment variable. If the environment variable is undefined, LMF invokes the vi editor.
You must enter the license information from the PAK accurately.
3.When you finish entering the license data, exit from the editor. If the license data is correct, LMF copies it into the license database. If the license data is incorrect, you may reenter the editor and correct mistakes. 
Alternatively, you can create a command script enclosing the license information (the license information is in the cover letter with this kit) found between 
lmf register - << ENDLMF
and
ENDLMF
Execute this script as root.
4.After you register your license, use the following commands to copy the license details from the license database (LDB) to the kernel cache: 
# lmf load 0 DECTALK-SW97
# lmf load 0 DECTALK-SW97-USER
For complete information on using the License Management Facility, see the Guide to Software License Management and the lmf reference page.
Checking the Software Distribution Kit
Use the bill of materials (BOM) to check the contents of your DECtalk Software software distribution kit.
In addition to this guide, the software distribution kit includes the following:
CD-ROM optical disc for systems with optical disc drives
CD-ROM booklet
If your software distribution kit is damaged or incomplete, contact your DIGITAL representative.
Directories and files included in the distribution kit are listed in the following screen display:
/usr/opt/DTKDEV450/docs/ascii:
dtk450_prog_guide.txt filelist_dev.txt
dtk450_release_notes_dev.txt

/usr/opt/DTKDEV450/docs/html:
defaultdectalk.html
**other html filenames TBS**

/usr/opt/DTKDEV450/docs/man/man3:
TextToSpeechAddBuffer.3          TextToSpeechPause.3
TextToSpeechCloseInMemory.3      TextToSpeechReset.3
TextToSpeechCloseLogFile.3       TextToSpeechResume.3
TextToSpeechCloseWaveOutFile.3   TextToSpeechReturnBuffer.3
TextToSpeechGetCaps.3            TextToSpeechSetLanguage.3
TextToSpeechGetLanguage.3        TextToSpeechSetRate.3
TextToSpeechGetRate.3            TextToSpeechSetSpeaker.3
TextToSpeechGetSpeaker.3         TextToSpeechShutdown.3
TextToSpeechGetStatus.3          TextToSpeechSpeak.3
TextToSpeechLoadUserDictionary.3 TextToSpeechStartup.3
TextToSpeechOpenInMemory.3       TextToSpeechSync.3
TextToSpeechOpenLogFile.3        TextToSpeechUnloadUserDictionary.3
TextToSpeechOpenWaveOutFile.3    **updated list TBS**

/usr/opt/DTKDEV450/docs/postscript:
dtk450_prog_guide.ps   dtk450_release_notes_dev.ps

/usr/opt/DTKDEV450/examples/dtk/dtsamples:
Imakefile  aclock.c   say.c   xmsay.uil
README.txt dtmemory.c xmsay.c

/usr/opt/DTKDEV450/include/dtk:
dtmmedefs.h  engphon.h  l_sp_ph.h  l_us_ph.h  
dtmmiodefs.h l_gr_ph.h  l_uk_ph.h  ttsapi.h

/usr/opt/DTKDEV450/share/man/man3:
TextToSpeechAddBuffer.3dtk          TextToSpeechPause.3dtk
TextToSpeechCloseInMemory.3dtk      TextToSpeechReset.3dtk
TextToSpeechCloseLogFile.3dtk       TextToSpeechResume.3dtk
TextToSpeechCloseWaveOutFile.3dtk   TextToSpeechReturnBuffer.3dtk
TextToSpeechGetCaps.3dtk            TextToSpeechSetLanguage.3dtk
TextToSpeechGetLanguage.3dtk        TextToSpeechSetRate.3dtk
TextToSpeechGetRate.3dtk            TextToSpeechSetSpeaker.3dtk
TextToSpeechGetSpeaker.3dtk         TextToSpeechShutdown.3dtk
TextToSpeechGetStatus.3dtk          TextToSpeechSpeak.3dtk
TextToSpeechLoadUserDictionary.3dtk TextToSpeechStartup.3dtk
TextToSpeechOpenInMemory.3dtk       TextToSpeechSync.3dtk
TextToSpeechOpenLogFile.3dtk        TextToSpeechUnloadUserDictionary.3dtk
TextToSpeechOpenWaveOutFile.3dtk    **updated list TBS**
Installation Procedure Requirements
This section discusses the requirements for installing the DECtalk Software Development Kit.
Installing DECtalk Software takes approximately 5 minutes, depending on your type of media and system configuration.
Hardware Requirements
To install DECtalk Software, you need the following:
Software distribution device (if installing from media)
Locate the drive for the CD-ROM software distribution media. The CD booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media.
Terminal
You can use either a hardcopy or video terminal to communicate with the operating system and respond to the prompts from the installation procedure.
See the DECtalk Software for DIGITAL UNIX Software Product Description (SPD) for additional hardware requirements.
Software Requirements
DECtalk Software for DIGITAL UNIX Version 4.5 requires:
The DIGITAL UNIX operating system, Version 3.x or 4.x.
The Multimedia Services for DIGITAL UNIX Version 2.x.
The Realtime extension.
DECtalk Software runtime kit V4.5.
Checking Current Disk Space
To check the current amount of free space for a directory path, log in to the system where you will install DECtalk Software. You can check which directories are mounted and their locations by viewing the /etc/fstab file. For example:
# more /etc/fstab
/dev/rz3a / ufs rw 1 1
/dev/rz3g /usr ufs rw 1 2
/dev/rz3b swap1 ufs sw 0 2
The display indicates that /usr mounted on /dev/rz3g is the only mount point that affects where DECtalk Software files will reside; the system has only one local disk drive, and the /usr/opt file system resides in the g partition of the disk on that drive.
To check the total space and the free space for the directories where DECtalk Software will reside, enter the df command. Given the previous display of the /etc/fstab) file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system. For example:
# df /usr
Filesystem  512-blocks  Used   Avail   Capacity  Mounted on
/dev/rz3a   79608       45648  25998   64%       /
/dev/rz3g   1482190     921846 412124  69%       /usr
This display shows that there are 206062 kbytes free. This free space must accommodate the subsets that you opt to install. If you choose to install all the subsets in the DECtalk Software Development Kit you need approximately 2 Mbytes of free disk space.
Increasing Disk Space by Using Alternative Disks
The DECtalk Software installation procedure creates and loads files into the sub directory:
/usr/opt/DTKDEV450
If any of the previously listed directories already exists, the installation procedure uses it.
If you find that there is insufficient disk space for the DECtalk Software subsets and you know that you have additional space on alternative disks or disk partitions for your system, perform the following steps before installing DECtalk Software:
1.Log in as root
2.Create the directory /usr/opt/DTKDEV450
3.Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space.
4.Enter the mount -a command so that the new mount points take effect. 
Installation Tasks
This section covers the installation tasks you must perform to install DECtalk Software.
Topics include:
Using the CD-ROM Consolidated Distribution Media
Using an RIS Distribution Area
Starting the Installation Procedure
Selecting Subsets
Stopping the Installation
Using the CD-ROM Consolidated Distribution Media
The following procedure loads DECtalk Software files onto a disk belonging to the system where you perform the installation. When DECtalk Software is run, its executable images are mapped into memory on your system.
To install DECtalk Software from CD-ROM media:
1.Mount the media on the appropriate disk drive. 
2.Log in as superuser login name root to the system where you will install DECtalk Software. 
3.Make sure that you are at the root (/) directory by entering the following command: 
# cd /
4.Specify the /cdrom directory to be the mount point for the distribution file system on the drive. If your drive is rz4c, enter the following command: 
# mount -dr /dev/rz4c /cdrom
5.Enter a setld command that requests the load function -l and identifies the directory in the mounted file system where DECtalk Software subsets are located. For example, if the directory location for these subsets is /cdrom/4.0/DTK450/kit, where "4.0" denotes a DIGITAL UNIX Version 4 installation, enter the following command: 
# /usr/sbin/setld -l /cdrom/4.0/DTK450/kit
For a DIGITAL UNIX Version 3.2 installation, you use /cdrom/3.2/DTK450/kit.
6.The installation procedure now displays the names of DECtalk Software subsets and asks you to specify the subsets you want to load. 
See Starting the Installation Procedure to continue the installation. 
Using an RIS Distribution Area
If you are installing DECtalk Software subsets that reside in an /etc/ris RIS distribution area on a remote system, take the following steps:
1.Log in as superuser login name root to the system where you will install DECtalk Software.
2.Make sure that you are at the root directory (/) by entering the following command: 
# cd /
3.Enter a setld command that requests the load function (-l) option and identifies the system where the DECtalk Software subsets are located. For example, if you are loading DECtalk Software subsets from a RIS distribution area on node axpmme, enter the following: 
/usr/bin/setld -l axpmme
4.RIS now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load. 
See Starting the Installation Procedure to continue the installation.
Starting the Installation Procedure
Before starting the installation procedure:
1.Log in as a superuser and verify that you are at the root directory.
Check to see if there are any previously installed DECtalk Software subsets by entering the following commands:
% su root
# cd /
# /usr/sbin/setld -i | grep DTKDEV
2.Deinstall any installed subsets with the prefix DTKDEV by entering the following commands: 
# cd /
# /usr/sbin/setld -d (name of subset)
3.To start the installation procedure, enter the following command: 
# /usr/sbin/setld -l /dev/rmt0h
4.Respond to the installation procedure prompts as described in Selecting Subsets. 
Selecting Subsets
The following section presents a complete installation procedure, including all messages that are displayed on your screen during the installation.
You must specify which DECtalk Software subsets you want to load. If you specify more than one number at the prompt, separate each number with a space, not a comma.
# /usr/sbin/setld -l .

The subsets listed below are optional:

   There may be more optional subsets than can be presented on a single
   screen. If this is the case, you can choose subsets screen by screen
   or all at once on the last screen. All of the choices you make will
   be collected for your confirmation before any subsets are installed.

   1) DECtalk Software V4.5 for DIGITAL UNIX Development Documentation.
   2) DECtalk Software V4.5 for DIGITAL UNIX Development Kit.
   3) DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
   4) DECtalk Software V4.5 for DIGITAL UNIX Sample Programs.

Or you may choose one of the following options:

   5) ALL of the above
   6) CANCEL selections and redisplay menus
   7) EXIT without installing any subsets

Enter your choices or press RETURN to redisplay menus.

Choices (for example, 1 2 4-6): 5
Next, the script lets you verify your choice. For example, if you enter 7 in response to the previous prompt, you will see the following display:
You are installing the following optional subsets:

   DECtalk Software V4.5 for DIGITAL UNIX Development Documentation.
   DECtalk Software V4.5 for DIGITAL UNIX Development Kit.
   DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
   DECtalk Software V4.5 for DIGITAL UNIX Sample Programs.

Is this correct? (y/n): y
If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is displayed again and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. After you respond to this question, the rest of the installation proceeds automatically and all the selected subsets are loaded. A sample of the rest of the installation script is listed below.
Checking file system space required to install selected subsets:

File system space checked OK.

4 subset(s) will be installed.

Loading 1 of 4 subset(s)....

DECtalk Software V4.5 for DIGITAL UNIX Development Documentation.
   Copying from . (disk)
   Verifying

Loading 2 of 4 subset(s)....

***********************************************************************
*                                                                     *
* DECtalk Software Application Services V4.5                          *
* Development Subset                                                  *
*                                                                     *
* Copyright(c)Digital Equipment Corporation, 1998 All Rights          *
* Reserved                                                            *
*                                                                     *
* Unpublished rights reserved under the copyright laws of the United  *
* States. The software contained on this media is proprietary to      *
* and embodies the confidential technology of Digital Equipment       *
* Corporation. Possession, use, duplication or dissemination of the   *
* software and media is authorized only pursuant to a valid written   *
* license from Digital Equipment Corporation.                         *
*                                                                     *
* RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the     *
* U.S. Government is subject to restrictions as set forth in          *
* Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, *
* or in FAR 52.227-14 Alt. III as applicable.                         *
*                                                                     *
***********************************************************************

DECtalk Software V4.5 for DIGITAL UNIX Development Kit.
   Copying from . (disk)
   Verifying

Loading 3 of 4 subset(s)....

***********************************************************************
*                                                                     *
* DECtalk Software Application Services V4.5                          *
* Sample Programs Subset                                              *
*                                                                     *
* Copyright(c)Digital Equipment Corporation, 1998 All Rights          *
* Reserved                                                            *
*                                                                     *
* Unpublished rights reserved under the copyright laws of the United  *
* States. The software contained on this media is proprietary to      *
* and embodies the confidential technology of Digital Equipment       *
* Corporation. Possession, use, duplication or dissemination of the   *
* software and media is authorized only pursuant to a valid written   *
* license from Digital Equipment Corporation.                         *
*                                                                     *
* RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the     *
* U.S. Government is subject to restrictions as set forth in          *
* Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, *
* or in FAR 52.227-14 Alt. III as applicable.                         *
*                                                                     *
***********************************************************************

DECtalk Software V4.5 for DIGITAL UNIX Sample Programs.
   Copying from . (disk)
   Verifying

Loading 4 of 4 subset(s)....

DECtalk Software V4.5 for DIGITAL UNIX Release Notes.
   Copying from . (disk)
   Verifying

4 of 4 subset(s) installed successfully.

***********************************************************************

DECtalk Software V4.5 development documentation subset (DTKDEVDOC450)
installation completed successfully. This installation puts the DECtalk
Software online help in html format in the following directory:

  /usr/opt/DTKDEV450/docs/html

You can use the Netscape(TM) browser to view the online help. Start by 
opening the file:

   /usr/opt/DTKDEV450/docs/html/defaultdectalk.html

***********************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Development
Documentation." (DTKDEVDOC450)

************************************************************************

DECtalk Software V4.5 development subset (DTKDEV450) installation
completed successfully.

************************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Development Kit."
(DTKDEV450)

************************************************************************

DECtalk Software V4.5 sample program subset (DTKSAMP450) installation
completed successfully. This installation puts the sample programs in
the following directory:

   /usr/examples/dtk/dtsamples

************************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Sample Programs."   
(DTKSAMP450)

************************************************************************

DECtalk Software V4.5 development release notes subset (DTKDEVRELNOT450)
installation completed successfully. This installation put DECtalk
Software development kit release notes in the following directories:

   /usr/opt/DTKDEV450/docs/ascii
   /usr/opt/DTKDEV450/docs/postcript

************************************************************************

Configuring "DECtalk Software V4.5 for DIGITAL UNIX Release Notes."
(DTKDEVRELNOT450)
#
Stopping the Installation
To stop the installation procedure at any time, press Ctrl/C. Then, interactively delete the files created by the installation up to the point where you stopped the installation. The directories and files created during the DECtalk Software installation are listed in the following file:
/usr/opt/DTKDEV450/docs/ascii/filelist.txt
If you encounter any failures during installation, see Reporting Problems.
You may interrupt the installation procedure at any point. However, if you do, the installation may not be left in a useful state. Remove all the subsets you installed and reinstall them.
Post-Installation Tasks
This section explains post-installation tasks you need to do after the development kit installation to make DECtalk Software ready for use. Topics include:
Running the Installation Verification Procedure
Deleting DECtalk Software from Your System
Displaying Documentation from the CD-ROM Distribution Disc
Correcting Problems During Product Installation
Reporting Problems
Running the Installation Verification Procedure
You can run the Installation Verification Procedure (IVP) during the installation or you can run the IVP independently after installing DECtalk Software to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DECtalk Software.
To run the IVP, enter the commands:
% su root
#/usr/sbin/setld -v DTKRT450
The DECtalk Software IVP verifies the installation as follows:
1.A check for a valid LMF license is made. If no license is found, the IVP fails because the software cannot be tested.
2.DECtalk Software requires that the Multimedia Software for DIGITAL UNIX server mmeserver be up and running. If the mmeserver is not already running, the IVP fails. Start the server and try again.
To start the server follow the sequence shown below:
% su root
# mmeserver&
Deleting DECtalk Software from Your System
If you must remove a version of DECtalk Software from your system, delete each subset that you previously installed.
For example to delete a subset, do the following:
1.Log in as superuser login name root, as follows:
% su root
2.Verify you are at the root directory (/) by entering the following command: 
# cd /
3.Enter the following form of the setld command: 
# setld -i | grep DTK
4.Look for the word installed in the listing produced, and then delete the installed subsets. For example: 
# setld -d DTKDEV450
# setld -d DTKDEVDOC450
Displaying Documentation from the CD-ROM Distribution Disc
The DECtalk Software documentation is provided on the DIGITAL UNIX Layered Products Online Documentation CD-ROM in html file format. You can display the files on your workstation using a browser application such as Netscape(TM). For information on accessing and displaying these files, see the DIGITAL UNIX Layered Products Disc User's Guide.
Correcting Problems During Product Installation
If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, a message similar to the following is displayed:
There is not enough space for subset SUBSET_NAME
SUBSET_DESCRIPTION (SUBSET_NAME) will not be loaded.
where SUBSET_NAME is the name of the subset and SUBSET_DESCRIPTION is the description of the subset.
For example, "DTKDEVRELNOT450" is a subset name, and "DECtalk Software for DIGITAL UNIX Release Notes V4.5" is a subset description.
Errors can occur during the installation if any of the following conditions exist:
Operating system version is incorrect.
Prerequisite software version is incorrect.
Disk space is insufficient.
System parameter values for successful installation are insufficient.
For descriptions of error messages generated by these conditions, see the DIGITAL UNIX documentation on system messages, recovery procedures, and software installation.
Reporting Problems
If an error occurs while DECtalk Software is in use and you believe the error is caused by a problem with the product, take one of the following actions:
If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink).
The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following:
1The name and version number of the operating system you are using
2The version number of DECtalk Software you are using
3The hardware system you are using (such as a model number)
4A brief description of the problem (one sentence, if possible)
5How critical the problem is
If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR).
If you do not have any type of software services support agreement and you purchased DECtalk Software within the past year, you can submit an SPR if you think the problem is caused by a software error.
When you submit an SPR, take the following steps:
1.Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version  number of the DECtalk Software being used. Explain the problem with specific examples.
2.Reduce the problem to its elements. 
3.Remember to include listings of any command files, include files, relevant data files, and so forth. 
4.Provide a listing of the program. 
If the program is longer than 50 lines, submit a copy of it on machine-readable media (floppy diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application.
For information about submitting media, see the tar(1) reference page. 
5.Report only one problem per SPR. This will facilitate a faster response.
6.Mail the SPR package to DIGITAL. 
If the problem is related to DECtalk Software documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe).



Index

A
authorization keys, 2-5
B
bill of materials, 2-6
D
DECtalk
audio sound card, requirements for, 1-3
disk space requirement, 1-3
installation procedure, 1-4
licensing agreement, 1-2
using online help, x
DECtalk Software runtime kit, 2-3
delete a subset, 2-35
distribution area, RIS, 2-11, 2-28
documentation, 2-18, 2-35
E
errors, 2-35
F
free space, 2-26
H
Hardware requirements, 1-2
I
Installation
disk space requirement, 1-3
from the NT console window, 1-7
from the program manager, 1-7
hardware requirements, 1-2
preparation for, 1-2
reading the release notes, 1-2
software license agreement, 1-2
software requirement, 1-3
trouble shooting, 1-8
installation procedure
stop, 2-16
installation tasks, 2-10, 2-27
Installation Verification Procedure (IVP), 2-17, 2-34
K
kit
runtime, 2-8
L
license, 2-5
License agreement, 1-2
License Management Facility, 2-5, 2-23
License PAK registration requirements, 2-23
License PAKs, 2-5
license product authorization keys, 2-5
O
Online help
how to use, x
P
PAKs, 2-5
post-installation tasks, 2-16, 2-34
preinstallation tasks, 2-4, 2-22
product authorization keys, 2-5
R
register a license, 2-5, 2-23
register the license PAK, 2-23
registration requirements, 2-23
release notes, 2-4, 2-22
Release notes, 1-2
RIS distribution area, 2-11, 2-28
runtime kit, 2-3, 2-8
S
software development kit, 2-25
software distribution kit, 2-6
stop the installation procedure, 2-16
T
tasks
installation, 2-10, 2-27
post-installation, 2-16, 2-34
preinstallation, 2-4, 2-22
total space, 2-26



iv


v


xiv


xiii


 2-36


1-7


2-37


Index - 2


Index - 1


