Note: This is a reproduction of the file called README.TXT which is distributed with the WinCALIS installation package.

Return to the Main Page...


         WinCALIS Author Workstation Readme File

To install a WinCALIS Author Workstation, run "a:\setup" from
the Windows 3.1 Program Manager "File,Run" menu or from the Windows 95
"Start" menu (substituting for "a:" the drive letter of the floppy drive
or CD-ROM drive you are using for installation).

Note: The Student Workstation Setup included with your Author
Workstation package is intended to enable you to install a second legal
copy of  WinCALIS on a SEPARATE machine for a student to use to run
your lessons--for example, in a public computer cluster or language lab.
(See also 3.5 below.)
                            - - - - - - - -


                    CONTENTS OF README FILE

   1.0  INSTALLING OVER AN EXISTING WINCALIS INSTALLATION
   2.0  HOW TO UNINSTALL WINCALIS
   3.0  TROUBLESHOOTING
   4.0  RUNTIME MCI DRIVERS FOR MULTIMEDIA
   5.0  VIDEO FOR WINDOWS 1.1 SETUP
   6.0  NEW FEATURES NOT INCLUDED IN MANUAL
   7.0  WINSPELL
   8.0  BUG REPORT FORM

                            - - - - - - - -


1.0  INSTALLING OVER AN EXISTING WINCALIS INSTALLATION

If you are installing an update over an existing WinCALIS 2.x
installation, it is advisable to make copies elsewhere of all your
own scripts, then delete everything in the WinCALIS 2.x program
directory and its subdirectories, remove the fonts which WinCALIS
added to your Windows system, and then reinstall the update from
scratch. This is not essential, but is encouraged to avoid creating
certain duplicate files and directories and to guarantee that new
versions of certain WinCALIS font files actually replace the ones
already existing in your Windows system. See the section, "HOW TO
UNINSTALL WINCALIS" for step-by-step instructions.


                            - - - - - - - -


            2.0  HOW TO UNINSTALL WINCALIS

To uninstall WinCALIS you will need to remove the directories
and files listed below from your machine. You can use the Windows File
Manager, or you can use DOS commands. WinCALIS also adds fonts
to your Windows system, causing Windows to add them to the [fonts]
section of your WINI.INI file. WinCALIS makes no other modifications
directly to any of your Windows initialization files, such as WIN.INI,
SYSTEM.INI, etc.  (This is also covered in On-line Help.)


2.1 Uninstalling Using the Windows File Manager:

 1) Click on the File Manager icon in the Windows 3.1 Main group
    to start the File Manager.

 2) Select the drive which contains the directory which you specified
    as the WinCALIS program directory during setup, e.g.,
    the C: drive.

 3) Highlight the WinCALIS program directory (by default C:\WINCALIS).
    Then press the Delete key. When asked, press "Delete All".

    WARNING!! This will delete ALL files in ALL subdirectories under the
    WinCALIS program directory--over 600 files in the case of
    a full installation. Be sure to exercise caution that you have
    specified the correct directory, and make backup copies first of
    any of your own script or document files which you wish to keep.

 4) Still using the File Manager, locate the main Windows directory
    (e.g., C:\WINDOWS) and click on it in order to display the files in
    it. Delete the following file by highlighting it and pressing the
    Delete key:

        MLPTT.INI

 5) Now locate the Windows System directory (e.g.,
    C:\WINDOWS\SYSTEM) and click on it in order to display the files in
    it. Delete the following files:

     WARNING!! Other applications may have also installed one or more of
     these files and still need them. If you are in doubt, do NOT delete
     them. They will not affect the performance of your system.

        PXENGWIN.DLL    Paradox Engine library for record-keeping
        CTL3D.DLL       3-D Effects in dialog boxes

    If the following files were added through the Control Panel, Drivers,
    Add Driver procedure described in a separate section below, they
    should also be removed through the Control Panel.

        AAPLAY.DLL      Autodesk Animation Player
        MCIAAP.DRV            "
        MCIAWI.DRV      Gold Disk Animation
        MCIAWI1D.DLL          "
        MCIAWI1O.DLL          "
        MCIAWI1T.TSK          "
        MCIMMP.DRV      Microsoft Multimedia Movie Player
        MCIPANAS.DRV    Panasonic Videodisc Player
        MCIPIONR.DRV    Pioneer Videodisc Player
        MCIVISCA.DRV    ViSCA-compatible VCRs
        MCIVSONY.DRV    Sony Videodisc Player
        MMP.DLL         Microsoft Multimedia Movie Player

 6) Now close the Windows File Manager, and click on the icon for
    the Control Panel, also in the Main group, to open the Windows
    Control Panel.

 7) Click on the Fonts applet.

 8) Scroll through the list of "Installed Fonts" until you see the
    group of fonts described as "WinCALIS 2.0......". All such fonts
    were added only as part of the WinCALIS 2.0 Setup, and may be
    safely removed as part of the Uninstall process. Highlight all
    these font names by either of the following procedures:
        a) While holding down the Shift key, click on the first font
           beginning with "WinCALIS 2.0...", then scroll to the last
           font beginning with "WinCALIS 2.0..." and click on it.
        b) While holding down the Ctrl key, click on each font which
           begins with "WinCALIS 2.0...".

    (This procedure may also be used by any WinCALIS user to
    selectively remove unwanted fonts from his Windows system, in order
    to conserve disk space, speed up Windows startup time, etc. For
    example, a WinCALIS Author who deals only with French, German, or
    Spanish, and is willing to confine himself to the ANSI/Latin1
    character set, may choose to remove all of these extra "WinCALIS 2.0"
    fonts, or at least any of the fonts for Unicode pages with exotic
    alphabets.)

  9) Click on the Remove button. When asked for confirmation, click in
     the checkbox which says "Delete font files from disk" and press the
     "Yes to All" button to uninstall all fonts installed during the
     WinCALIS Setup.

  10) Close the Fonts Applet and the Windows Control Panel.


WinCALIS is now completely uninstalled.


2.2 Uninstalling Using DOS Commands:

  1) Go to a DOS prompt.
  2) Change directories to the directory above where your WinCALIS
     program directory is. E.g., if your WinCALIS program directory
     is C:\WINCALIS (the setup default, if your copy of Windows is on
     your C: drive), then type the DOS commands

               X:\>c:       [press Enter]
               C:\>cd \     [press Enter]

  3) Type the DOS 6.x command "DELTREE," supplying the name of the
     WinCALIS subdirectory tree to delete. E.g.,

               C:\>deltree wincalis       [press Enter]

     WARNING!! This will delete ALL files in ALL subdirectories under the
     WinCALIS program directory--over 600 files in the case of
     a full installation. Be sure to exercise caution that you have
     specified the correct directory, and make backup copies first of
     any of your own script or document files which you wish to keep.

     If you are running an older copy of DOS than 6.x, you will need to
     change to the WinCALIS 2.0 program directory and each subdirectory
     under it and use the DOS "DEL" or "ERASE" command and "RD"
     commands to delete files in each subdirectory, then remove each
     subdirectory.  E.g.,

               C:\>cd \WINCALIS\SCRIPTS\MLTMEDIA      [press Enter]
               C:\WINCALIS\SCRIPTS\MLTMEDIA>del *.*   [press Enter]
               C:\>cd \WINCALIS\SCRIPTS               [press Enter]
               C:\WINCALIS\SCRIPTS>rd mltmedia        [press Enter]


  4) Change to the main Windows directory. E.g,

               C:\>cd \WINDOWS      [press Enter]

     Then delete the file MLPTT.INI.

               C:\WINDOWS\>del mlptt.ini

  5) Change to the Windows System directory. E.g.,

               C:\WINDOWS>cd system      [press Enter]

     Then delete the following files:

     (see list and warnings in step (5) under "Uninstalling Using
     the Windows File Manager" earlier in this section)

  6) Follow steps (6)-(10) under "Uninstalling Using the Windows
     File Manager" earlier in this section to remove WinCALIS 2.0
     fonts from Windows.

WinCALIS is now completely uninstalled.

                            - - - - - - - -


                        3.0 TROUBLESHOOTING

3.1 My updated copy of WinCALIS TrueType Printer does weird things.

If you have updated WinCALIS over an existing installation
and experience printing problems with MLPTT.EXE "WinCALIS TrueType
Printer," go to your main Windows 3.1 directory and delete the file
"mlptt.ini."

3.2 I have problems with an updated installation of WinCALIS.

If you are experiencing problems and have updated over an earlier
setup, it is advisable to delete everything following the procedure
described in the section "HOW TO UNINSTALL WINCALIS", then run
setup again. If the problem still occurs, contact the Duke University
Humanities Computing Facility.

3.3 WinCALIS Author doesn't work right on my foreign version of
Windows.

WinCALIS programs do not work reliably in all languages on various
localized versions of Windows 3.1, especially those which modify the
usual keyboard or font processing of generic Windows, such as Arabic
Windows 3.1, Korean Windows 3.1, Thai Windows 3.1 etc. Please contact
the Duke University Humanities Computing Facility to discuss your
own situation, if you need to run a WinCALIS application on a localized
version of Windows.

3.4 WinCALIS keeps crashing even though I have exited and started it
    again.

If a General Protection Fault (GPF) "crash" occurs in one of the shared
Dynamic Link Libraries (DLLs) used by both WinCALIS and WinCALIS
Author--you will see a Windows error message reporting something
like the following:
   "WINCALIS.EXE caused a General Protection Fault
    in module WCRTW.DLL at address 0000:0000"

--you will need to exit from BOTH the WinCALIS and WinCALIS Author
programs, before Windows will allow you to run either of them again.


3.5 I can't see *.CAL files in my WinCALIS opening screen Lesson
    Window.

You may have installed the Student Workstation Setup on the same
machine as your Author Workstation, and what you are running is
the Student Workstation version of WinCALIS. The student's
opening screen Options menu only allows changing directories,
not converting *.CAL files or changing Window defaults.

You can fix the problem in one of two ways:

 1) (Running Setup again)
    Use the File Manager to delete the current WINCALIS.EXE.
    Then run the Author Workstation Setup again. (You can just run the
    default setup--existing options will not be affected.)

 2) (Using the DOS "EXPAND" command)
    Go to a DOS prompt.
    Change to your WinCALIS program directory (e.g., C:\WINCALIS).
    Place Disk 1 of the Author Workstation Setup package in drive
    A: (or B:).
    At the DOS prompt, type the following command:

        expand  a:\files\wincalis.exe wincalis.exe


Note: The Student Workstation Setup included with your Author
workstation package is intended to enable you to install a second
legal copy of WinCALIS on a separate machine for a student to use to
run your lessons--for example, in a public computer cluster or
language lab.

This is preferable, but you may install both the Author Workstation
and the Student Workstation on the same machine, in order to see what
the Student Workstation looks like, if it is necessary, and if you know
what you are doing, and if you have plenty of hard disk space.
First install the Author Workstation and be sure that everything works OK.
Then install the Student Workstation in a SEPARATE directory on your
hard disk. You will end up with two identical icons on the screen.
Change their description (File,Properties) so that you can tell them apart.

3.6  My Graphics Multilingual Printer program (MLP.EXE) crashes in
Windows 95 when I click on the Printer Setup menu.

Yes, regrettably there is an incompatibility between MLP.EXE and the
Windows 95 printer setup routine. We will  fix this. Meanwhile, avoid
this menu and set up your printer from the Start, Settings, Printers
menu instead. In any case, MLP.EXE will always use your default printer, so
you will need to set your default printer there, if you have more than one
choice.

3.7  I tried to install WinCALIS in Windows 95.  I went through
all of the disks, yet I am not able to find the program.

WinCALIS is a setup designed for Windows 3.1. It also
installs successfully much of the time under
Windows 95. If it does not finish successfully on your
system, you can do the final details of the installation
manually. Usually, all files are written to the hard disk
OK, but (1) your WinCALIS fonts are not always installed
properly in Windows 95, (2) the WinCALIS Pangaea folder
and icons are not created in your Start Menu, and (3) the
WINCALIS.INI file is not created dynamically at the
end of setup.

(1) You can install the fonts manually from the Windows 95
Start Menu. Press Start, Settings, Control Panel, Fonts.
Click on File, and select Install New Font.... Then, in
the Add Fonts dialog box, select the System folder under
your main Windows folder. Highlight all the fonts which
begin "WinCALIS 2.0..." and click on OK. You can then use
the Windows Explorer to delete from your Windows 95
System folder all the WinCALIS font files with filenames
WC2*.TTF, WC2*.FOT, and WC2*.FON.

(2) You can create a WinCALIS Pangaea folder in
your Start Menu by clicking on the Start button with the right
mouse button, then clicking on Explore. Then insert Setup
Disk 1 into your floppy drive and drag the folder called
WinCALIS Pangaea into the Programs folder. You will then
have added the WinCALIS Pangaea folder to your Start menu.
If you installed WinCALIS in the default location C:\WINCALIS,
that is all you need to do. If you installed it elsewhere, you
will need to open the WinCALIS Pangaea folder and click on each
icon with your right mouse button, select Properties, then
the Shortcut tab, then correct the paths shown in the "Target:"
and "Start in:" lines. If you wish, you can also place
the WinCALIS Pangaea folder right on your Windows 95 desktop
by holding down the Ctrl key and dragging the WinCALIS Pangaea
folder icon onto your desktop.

(3) You can copy the substitute WINCALIS.INI file from
the Setup Disk 1 "FILES" subdirectory to the main
directory in which you installed the WinCALIS Author
Workstation on your hard disk. Then open the file
in a plain text editor like the Windows Notepad and
edit the the directory paths as needed. If you
installed WinCALIS in the C:\WINCALIS directory,
no editing should be needed.

For late-breaking details, consult the Duke University
Humanities Computing Facility website:
/faq/faq.htm
or contact us by phone, fax, or e-mail.


                            - - - - - - - -


          4.0  RUNTIME MCI DRIVERS FOR MULTIMEDIA

             (This topic is also covered in On-Line Help.)

4.1 Installation in Control Panel

Disk 4 of the WinCALIS Author Workstation Setup and Disk 2 of the
WinCALIS Student Workstation Setup includes some runtime drivers
for Windows 3.1 MCI (Media Control Interface). These drivers variously
allow an author or student workstation to display previously-created
animation files, or to control an MCI-compatible laserdisc player or VCR.
The drivers can be installed using the following procedure:

     1) Load the Windows 3.1 Control Panel (from Main group).

     2) Double-click on the Drivers applet.

     3) Select the Add button.

     4) Highlight the "Unlisted or Updated Driver" item from
        the List of Drivers and click on OK.

     5) Insert the WinCALIS diskette labeled "Disk 4:
        Multimedia, MCI Drivers" in drive A or other drive,
        and enter the path where these files can be found,
        a:\drivers, and click OK.

     6) Select the desired driver.

     7) Repeat for as many drivers as needed.

4.2  Making MCI Drivers Work in WinCALIS

In order that WinCALIS, WinCALIS Multimedia Editor, and the Windows
Media Player be able to recognize the media device needed to play a
file from the file extension, in the case of "compound" devices (i.e.,
files) such as *.WAV digital sound files, *.AVI Video for Windows files,
*.MMM Microsoft Multimedia Movie Player animation files, etc., the
following extra step is also needed:

        Make a backup copy of your main Windows initialization file,
        "WIN.INI" in your main Windows program directory, using the
        Windows File Manager or DOS "COPY" command, e.g. as
        "WININI.BAK". Then using the Windows Notepad, the DOS editor,
        or other plain text editor, open the file "WIN.INI", find
        the [mci extensions] section, and add as many as you like of
        the following lines, if they do not already appear there.

            wav=waveaudio
            mid=sequencer
            rmi=sequencer
            avi=AVIVideo
            mmm=MMMovie
            fli=Autodesk
            flc=Autodesk
            awm=Animation
            awa=Animation
            mov=QTWVideo
            mpg=MCIMPEG

4.3 Other MCI Information

(The word following the = sign must correspond to a line in the
[mci] section of your Windows SYSTEM.INI file, which identifies
the MCI driver for that device, of the form "MMMovie=mcimmp.drv".
Such a line should have been written by the Windows Control Panel
for each MCI driver which you chose to install in steps 1-7 above.
The MCI drivers themselves, along with any supporting .DLL files,
etc., are usually added to your Windows system directory.)

See also the WinCALIS On-line Help for further information.


                           - - - - - - - -


              5.0  VIDEO FOR WINDOWS 1.1 SETUP

The Video for Windows 1.1 Runtime Module is included as a separate
optional Setup, on the disk labeled Video for Windows Setup.
Video for Windows can be installed as an upgrade to Windows 3.1
on any computer, enabling the computer to display digital video
*.AVI files without special video hardware. In order to hear the
audio track, an MCI-compatible sound card is required.

In order to see the video clip in the video sample exercse "videodem.*"
you will need to have Video for Windows installed.

                            - - - - - - - -


6.0   NEW FEATURES NOT INCLUDED IN MANUAL


6.1 Utilities

    There are some extra files installed in the WinCALIS program directory,
    which reflect ongoing work on WinCALIS development:

6.11 UNIGREP.EXE is a DOS program which will search through files
        of Unicode text for a particular ASCII string, and write the lines
        in which the string occurs to another Unicode file.  Type "unigrep"
        at the DOS prompt for proper usage and syntax. This is useful
        in searching through WinCALIS scripts for use of particular
        commands (e.g., to find an example of the 
        special response), or all references to external files, (just "grep"
        for ") in a variety of places at
periodic intervals, so that it is inconvenient to copy it to the clipboard and
paste it. Or if you need to perform a complex operation such as finding
certain text and deleting certain other adjacent text (the F12 "Repeat Find"
key in Author is also handy in such cases). Or type a Special Response in
the Anticipated Answer box of the Answers/Feedback dialog, then Tab
down and type the desired reaction to it in the Feedback box. Note that for
beginners, it is easier to choose to ignore the mouse and just record
keystrokes. But for experienced users, you can make very complex
macros using just the keyboard or the keyboard and the mouse. For more
information, see the On-line help for the Recorder, or your Windows
manual.

    "Set Tools..."

This menu option in WinCALIS Author or UniEdit enables you to add,
modify, and delete tools from your Tools menu.

If you do not have WinCALIS Author or UniEdit (WinCALIS Student
Workstation), you can add, modify, and delete items in your Tools menu
by editing the [Tools] section of your WINCALIS.INI file with a plain-text
editor, such as the Windows Notepad or DOS Edit program. Be sure to
make a backup of your original WINCALIS.INI first.

                            - - - - - - - -


                            7.0 WINSPELL

7.1 What is WinSpell?

-A setup disk for WinSpell, a shareware English spell-checker for
Windows, has been included in the WinCALIS Author Workstation setup,
as a service to WinCALIS authors working with English as either a target
language or the student-user's native language. WinSpell is compatible in
several ways with the Unicode-based WinCALIS authoring system, even
though it is ASCII/ANSI-based (i.e., works with single-byte 8-bit codes,
rather than the 16-bit Unicode).  A manual is included on the setup disk
and there is good on-line Help.

7.2 WinSpell Installation

Insert the WinSpell disk in your a: drive and in Program Manager click
on File, Run.., and type a:\"install" in the Run dialog Command Line: box.

7.3 How to Use WinSpell With WinCALIS Author

WinSpell can be used to check spelling in WinCALIS in at least the
following ways:

1) You can copy the contents of any Author window to the Clipboard and
check the spelling there. An entire script could be checked by retrieving
the *.CAL file in the Scratchpad and copying it from there to the Clipboard.

2) You can check the spelling interactively, as you type, in any window
you choose. WinSpell checks keystrokes--it is oblivious of the WinCALIS
Unicode text buffer--so there is no conflict.

3) You can check the spelling of a file on disk, but you would have to
convert the file to an ASCII/ANSI or other single-byte-coded standard first.

4) You can also configure WinSpell to use WinCALIS's Find and Replace
feature to automatically find and replace misspelled words in your text.


7.4 WinSpell Is Shareware

WinSpell is shareware. Please respect the authors' rights and distribution
requests, as described in the separate WinSpell setup. You can become a
registered WinSpell user for US$29.95. International shipping is an
additional US$5.00.

Dictionary files can be created for other languages, as user-developed
dictionaries, just as CALIS commands, options, keywords, and other
special terms, can be added to WinSpell dictionaries. Please notify the
Humanities Computing Facility at Duke University if you are aware of
existing spell-checker dictionaries for other languages for use with
WinSpell.

                            - - - - - - - -

                                                    Rev. 12/21/95

                        8.0  Bug Report Form

You can use this form to report bugs or desired changes and
enhancements. You are also welcome to report bugs by telephone or
E-mail, but if you do, please be prepared to supply the type of
hardware information listed below.

 - - - - - - - - - - - - - - - - Cut here - - - - - - - - - - - - - - -

                   WinCALIS Bug Report Form

Name:   ____________________  Organization: _____________________

Address:
_________________________________________________________

_________________________________________________________

Phone:  ______________________   Fax: ________________________

WinCALIS Serial Number: __________  WinCALIS Version: __________

Computer Manufacturer: _______________________________________

Model: _______________________   VGA Card type: ________________

Resolution:  ___________________   Number of Colors: _____________

Other peripherals in use: _______________________________________

____________________________________________________________

____________________________________________________________

DOS Version: ________________   Windows Version: _______________

What features are missing?
____________________________________________________________

____________________________________________________________

Bug Description:
____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________

____________________________________________________________


Please fax or mail to the Humanities Computing Laboratory,
301 W. Main St., Suite 400-I, Durham, NC 27701, FAX (919) 667-9556.
Tel. (919) 667-9556. Internet: info@humancomp.org


Home | Site Map | Services | New | WinCALIS | UniEdit