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 thespecial 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