Chapter 1
JAWS PROGRAM FILES 
(Also contained in the disk file "T1FILES.TXT".)
 
 
 
 
 
 
CONTENTS OF CHAPTER 1
 
     1.   CHAPTER INTRODUCTION                               1
     2.   SUBDIRECTORY STRUCTURE                             1
     3.   LOCATION AND FUNCTION OF PROGRAM FILES             2
          3.1 Files in \JFW                                  2
          3.2 Files in \JFW\SETTINGS                         3
          3.3 Files in \JFW\MANUALS                          5
          3.4 Files in \JFW\TECNOTES                         5
     4.   USING THE GRAPHICS EDITOR                          5
          4.1 Merging Graphics Files                         6
          4.2 Editing a Graphics Label File                  6
     5.   ADDING JAWS TO PROGRAM MANAGER                     7
          5.1 Creating a JFW Program Group                   7
          5.2 Creating a JAWS Program Item                   7
          5.3 Adding JAWS to the Startup Group               9
 
 1.   CHAPTER INTRODUCTION
 
     This chapter identifies the various program files and
subdirectories that are used by JAWS.  It also explains the way
in which these files are used to manage screen reading activities
and speech synthesizer performance.
 
 
2.   SUBDIRECTORY STRUCTURE
 
     The JAWS program files are usually installed in the C:\JFW
subdirectory.  A different drive and subdirectory can be specified
during program installation.
 
     The \JFW subdirectory contains various Executable Program
Files and a variety of Dynamic-Link Library (DLL) files, in addition
to containing several Subdirectory branches.  For example, \ENU
contains English language files for the United States.  The names
of all language subdirectories follow the standard language
abbreviations used in Windows.
 
\JFW\HELP
=Location of on-line help files.
 
\JFW\MANUALS
= Location of electronic text files for JAWS documentation.
 
\JFW\SETTINGS
= Location of settings files and macro files.
 
\JFW\TECNOTES
= Location of technical bulletins on topics not included in the
manuals.
 
 
3.   LOCATION AND FUNCTION OF PROGRAM FILES
 
3.1  Files in \JFW
 
JFW.EXE = Executable JAWS program file.
 
JFW.INI = Initial setup file for JAWS.
     This file can be edited with a text editor.  If you wish to
     change synthesizer drivers without re-installing JAWS, then
     you can edit this file.  To change synthesizers, you must
     change the name of the synthesizer driver that is specified
     in this file, and you must have the corresponding ".DLL"
     and ".INI" files.  Often a corresponding "SSIL.DLL" is also
     needed.  Please see the technical bulletin "SYNTH01.TXT"
     for additional information.  It is located in your language
     subdirectory of \JFW\TECNOTES.
 
MACROED.EXE = JAWS macro editor.
 
GRAPHED.EXE = JAWS graphics label editor.
 
SynthesizerDriverName.DLL = Synthesizer driver file.
     The corresponding synthesizer driver file that matches the
     synthesizer driver name in your "JFW.INI" must be in your
     \JFW subdirectory.
 
SynthesizerDriverName.INI = Synthesizer initial setup file.
     The synthesizer driver specified in "JFW.INI" points to this
     file, and the filename and driver name must be the same. 
     If you wish to change synthesizers without re-installing
     JAWS, then all of the driver names in this file must be
     changed so that they match the "SynthesizerDriverName.D-
     LL" and "SynthesizerDriverName.INI".  Please see the
     technical bulletin "SYNTH01.TXT" in the \JFW\TECNOTES-
     \ENU subdirectory for additional information.
 
SSIL.DLL = Dynamic-link library file for the synthesizer driver.
     All synthesizers require a "SynthesizerDriverName.DLL",
     "SynthesizerDriverName.INI", and some require a
     corresponding "SSIL.DLL" file in order to work properly. 
     Dynamic-link library files are called upon as needed by
     "JFW.EXE".
 
CHANGES.DOC = Notes about new features in JAWS.
     New information which supplements the various JAWS
     manuals is contained in \JFW\MANUALS.  Look for files
     with the ".NEW" filename extension.
 
3.2  Files in \JFW\SETTINGS
 
     The \JFW\SETTINGS subdirectory actually does not contain
files, but rather contains one or more subdirectory branches,
which contain settings and macro files.  The \JFW\SETTINGS\ENU
contains files for the U.S. English language version of JAWS. 
Files for other languages are contained in subdirectories that are
named with the standard Windows foreign language
abbreviations.
 
     The basic set of files included in the \JFW\SETTINGS\ENU
subdirectory are as follows:
 
DEFAULT.JCF = Text file that contains synthesizer settings.
     This file is updated when settings are saved.  It also can be
     edited with a text editor.
 
DEFAULT.JMS = JAWS macro source file.
     This is a text version of the JAWS macro file.  This file is
     edited when you use the JAWS macro editor.
 
DEFAULT.JMB = JAWS macro binary file.
     This file is the binary version of the JAWS macro source
     file.  It is compiled automatically each time you use the
     Save dialog of the JAWS macro editor.
 
GRAPHIC00?.JGF = JAWS graphics file.
     This file contains the labels that are spoken by JAWS to
     identify graphics.  All graphics labels for all applications are
     stored in this file.  Please see the technical bulletin
     "GRAPH01.TXT" located in the \JFW\TECNOTES\ENU
     subdirectory for additional information.
 
FUNCTIONS.JML = Functions of the JAWS macro language. 
     It lists all the macro functions that can be used when
     creating JAWS macros.  Additional information about the
     specific functions contained in this file is contained in
     Chapter 3 of this manual.
 
PROGMAN.JMS = JAWS macro source used with the Windows
Program Manager.
 
PROGMAN.JMB = JAWS macro binary used when running
Windows Program Manager.
 
     The "DEFAULT.J??" files are always in use regardless of
the Windows application you are using.  Each time you activate
a Windows application, JAWS searches for a related set of
application settings files.  For example, when you activate
Program Manager, JAWS looks for "PROGMAN.J??" files.  If they
exist, then JAWS loads them.  The application settings files are
then used simultaneously with the "DEFAULT.J??" files.
 
     When you press a key such as CONTROL+F4, JAWS
responds with the following three-step procedure.
 
a.   JAWS first looks in the ApplicationFileName.JMB file to see
     whether it contains a macro for CONTROL+F4.  If it is
     present, then it executes the macro.
 
b.   If the macro was not present in the application's macro
     binary, then JAWS looks in the "DEFAULT.JMB" file.  If
     JAWS does not find a macro with that name, then it
     passes the CONTROL+F4 on to the application which then
     responds.
 
     There are two major advantages to using this macro
strategy.  First, when you make a change in the default macro
file, the change applies to all applications, so that it is not
necessary to modify macro files for each application individually. 
Secondly, the application macro files can be very small.  They
can, for example, just contain the special purpose macros that are
only needed when using the application.  These short macro files
are easier to read and edit.
 
3.3  Files in \JFW\MANUALS
 
     The files in this subdirectory are text files for the various
JAWS Manuals.  The file "00READ.LST" located in the
\JFW\MANUALS subdirectory lists each text file, its chapter title,
and the manual from which it was taken.
 
3.4  Files in \JFW\TECNOTES\ENU
 
     The text files in this subdirectory contain technical
information that will change along with program improvements, or
which only applies to unusual situations or to specific technical
problems.  Each subdirectory in \JFW\TECNOTES is for a different
language.  American English files are in the \ENU subdirectory.
 
 
4.   USING THE GRAPHICS EDITOR
 
     The Graphics Editor is activated from the Utilities menu of
the JAWS application window.  The editor is designed to meet
two needs:  to merge two graphics label files such as an old file
with a new file, and to edit the entries in a single file.  When you
activate the graphics editor, it displays an opening dialog box. 
You use this box to choose between the options of "merging" and
"editing".
 
4.1  Merging Graphics Files
 
 
     When you press the Merge Button, it displays the Merge
dialog box.  There are two dialog options for specifying the files
that are to be merged, and a button which begins the merge
process.  Both of the File buttons display a standard File Selection
dialog.  After choosing one of the File Selection buttons, type the
name of a graphics label file in the edit field or press TAB to move
to the list box and choose a file from the file list.  Repeat this
process to specify the name of the second file which is to be
merged.  Information about the name of default graphics label files
is presented in the technical bulletin "GRAPH01.TXT" located in
the \JFW\TECNOTES subdirectory.  Information in this file will
help you properly name the new file that is created when the file
merging has been completed. 
 
     After specifying the two files, then press the Merge button. 
If the editor finds duplicate labels, as the files are being merged,
then the process will pause and you will be asked to choose the
graphics label you wish to keep.  After you make your choice,
then the process continues again.
 
4.2  Editing a Graphics Label File
 
     When you choose the Edit Button, the Edit dialog is
displayed.  Use the File button to display the File Selection dialog
and either type the name of a graphics label file in the edit field or
press TAB to move to the list box and choose a name from the file
list.  Information about the name of default graphics label files is
presented in the technical bulletin "GRAPH01.TXT" located in the
\JFW\TECNOTES subdirectory.
 
     After specifying a graphics label file, then press the Edit
button.  At this point you will be able to scroll through the entire
list of labels in the file.  To edit an entry, move the PC cursor to
the label you wish to edit, press INSERT+SPEECH PAD MINUS to
route the JAWS cursor to the PC cursor, then double click
SPEECH PAD SLASH (the left mouse button).  Edit the entry, and
press ENTER when you have finished.  Labels in the list are
alphabetized, and your label may be moved to a new location in
the list as soon as your editing is completed.
 
 
5.   ADDING JAWS TO PROGRAM MANAGER
 
     If you installed JAWS from a DOS prompt, then a JFW
group was not created in Windows Program Manager.  If you wish
to create a JFW group and a JAWS program icon, then follow the
steps presented in this section.
 
5.1  Creating a JFW Program Group
 
a.   Activate Program Manager.
 
b.   Press ALT+F to display the Files menu.  Press N to choose
     the New Program Object dialog.
 
c.   Use your UP ARROW to select the New Program Group
     radio button.  Press ENTER to display the dialog for creating
     the new program group.
 
d.   In the "description" edit field of the dialog type the
     uppercase letters "JFW" and press ENTER.  The group is
     immediately created and your selection cursor points to the
     new JFW group.
 
5.2  Creating a JAWS Program Item
 
a.   While your selection cursor still points to the JFW program
     group, press ALT+F to activate the Files menu and press
     N to choose the New Program Object dialog.  The selection
     cursor should already be pointing to the Program Item
     dialog, so press ENTER to display the dialog.
 
b.   Fill in the dialog options as shown below.
 
     Program Description = JAWS
          (Use uppercase letters.)  This is the text label that
          Program Manager will display with the JAWS icon.
 
     Command Line = C:\JFW\JFW.EXE
          This is the name of the JAWS program.  If you did
          not install JAWS on the C: drive or in the \JFW
          subdirectory, then make changes as needed in this
          command.
 
     Working Directory =
          Leave this blank.
 
     Shortcut Key = [optional]
          If you indicate a shortcut key, then this key can be
          used to start JAWS from anywhere in Program
          Manager.  Press TAB to move onto the OK button if
          you do not want a shortcut key, or press one of the
          combination of keys shown below to setup a
          shortcut key.  The character can be any letter,
          number, or special character.  If you just press a
          character key in the Shortcut Key box, then Program
          Manager automatically adds CONTROL+ALT in front
          of it.
              CONTROL+ALT+character
              CONTROL+SHIFT+character
              ALT+SHIFT+character
              CONTROL+ALT+SHIFT+character
 
     Run Minimized = [not checked]
          Leave this check box unchecked.
 
c.   The last step is to choose the OK Button to save your
     changes.  The JAWS program item is immediately displayed
     in the open JFW program group.  If JAWS is not already
     running, you can press ENTER to start JAWS.
 
5.3  Adding JAWS to the Startup Group
 
     Program items that appear in the Startup group of Program
Manager are automatically loaded (started) every time Windows
starts.  If you copy the JAWS program item into the Startup group
then JAWS starts when Windows starts.  To do this, follow these
steps.
 
a.   Use your PC cursor to point to the JAWS program item in
     the JFW group of Program Manager.
 
b.   Press ALT+F to activate the Files menu, and press C to
     use the Copy dialog.  This dialog is used to copy program
     items from one group to another.
 
c.   Your selection cursor is placed at the top of a list that
     contains the names of all groups in Program Manager. 
     Press DOWN ARROW until you find "Startup", and then
     press ENTER to choose this group name.  The JAWS
     program item is immediately copied into the Startup group,
     and JAWS will then be started automatically when you
     next start Windows.
 
 


