==================================================================== README.TXT 12/2/94 ==================================================================== This README file contains the latest product information for Envoy (TM) 1.0a for Windows. See the QuickStart Card and Online Help for important information about installing and using Envoy. ==================================================================== TABLE OF CONTENTS This file is organised into the following sections: 1. System Requirements 2. Replacing Envoy 1.0 with Envoy 1.0a 3. Installation Troubleshooting 4. Additional Languages 5. General Troubleshooting 6. Envoy Driver Compatibility 7. Uninstalling Envoy from your System 8. Customer Support ==================================================================== 1. SYSTEM REQUIREMENTS Windows(TM) System Requirements: Hardware: PC with 386 processor or greater System software: Microsoft(R) Windows 3.1 Minimum RAM: 500K free Conventional Memory Free hard disk space: 1-2 MB 3.5" HD disk drive ======================================================================= 2. REPLACING ENVOY 1.0 WITH ENVOY 1.0A If you are replacing Envoy 1.0 with Envoy 1.0a, you can delete the files in ENVOY\PROGS and remove the directory. You should not try to run Envoy 1.0 after you have installed Envoy 1.0a. ======================================================================== 3. INSTALLATION TROUBLESHOOTING If Envoy does not function properly after installation, check that the following files have been installed to the locations listed below: Installed in the WINDOWS directory: ENVOY.INI: The Envoy INI file ENVOY.GRP: Viewer icon and samples ENVOY.REG: Envoy information for REG.DAT NOVELLPE.GRP or PERFECTO.GRP: Viewer icon REG.DAT: Viewer and Driver information STARTUP.GRP: DAD (Desktop Application Director) WIN.INI: Viewer and Driver information Installed in the WINDOWS\SYSTEM directory: ENVOYDRV.DRV: The Envoy printer driver TTEMBED.DLL: The Microsoft TrueType font embedding DLL (redistributable Windows component) HPU.DLL: Help print utility (prints all topics in online Help) SHWIND20.DLL: Control 3D Interface Installed in the ENVOY directory: ENVOY.EX_: ENVOY.EXE before decompression, which is used to build Runtime Viewers. ENVOY.EXE: The Envoy Viewer ENVOYDXX.DLL: The Envoy printer driver resources. (XX stands for a language code. Several languages may be installed.) ENVOYMAI.DLL: The Envoy electronic mail DLL (used only if you have a VIM- or MAPI-compliant electronic mail program) ENVOYPKG: The Envoy packager stub, which is used to build Runtime Viewers. ENVOYXX.DL_: ENVOYXX.DLL before decompression. (XX stands for a language code. Several languages may be installed.) ENVOYXX.DLL: The Envoy Viewer language resources. (XX stands for a language code, such as US for United States English. Several languages may be installed.) WPEN10XX.HL_: The Envoy online Help file before decompression. Several languages may be installed. WPEN10XX.HLP: The Envoy online Help file. Several languages may be installed. WPER10XX.HL_: The Envoy runtime online Help file before decompression. Several languages may be installed. WPER10XX.HLP: The Envoy runtime online Help file. Several languages may be installed. ENVOY\ENDOCS: Empty work directory (save .EVY and .EXE files here) ENVOY\SPOOL: An empty directory which is used as a destination for spooling multiple .EVY documents from the Envoy Driver. Installed in the ENVOY\SAMPLES directory: READMEW.TXT: This readme file, in ASCII text format. Several languages may be installed. *.EVY: Sample files. (Text in the sample files is in Latin.) Please note that if SHARE.EXE is running when you install Envoy, you may need to restart Windows during installation because shared components (ENVOYDRV.DRV, ENVOYDXX.DLL, TTEMBED.DLL) may be loaded and locked. ==================================================================== 4. ADDITIONAL LANGUAGES Various languages are available for Envoy. Periodically, other languages will be added. When another language is installed, you can use the following startup option: /L=XX (where XX is the two-letter language code). Or you can change the default language from within Envoy with Preferences. See Online Help for details. ==================================================================== 5. GENERAL TROUBLESHOOTING For detailed information about installing and using Envoy, see the QuickStart Card and online Help. The following are suggestions for troubleshooting possible situations you may encounter in the course of using Envoy on Windows. Envoy Viewer: RUNNING ENVOY UNDER OS/2 If you have a 256 colour display and you are running Envoy seamlessly on the OS/2 desktop, you may experience corruption of your desktop colours. To correct this problem, start Envoy using the /SW start-up switch. To start Envoy using the /SW start-up switch, 1. Right-click on the Envoy icon. 2. Open the Settings window, then click on the Program tab. 3. Type /SW in the Optional Parametres text box. To view an Envoy attachment in GroupWise, 1. Right-click on the attachment icon, then choose Open. 2. Type /SW after the *.EXE command in the text box (for example, ENVOY.EXE /SW). USING PERFECTOFFICE QUICKFINDER AND OPEN FILE The current version of QuickFinder cannot index .EVY files. You cannot view .EVY files in the Open File dialog box in PerfectOffice. UNDERSTANDING MENU OR TOOL OPERATIONS Look for the long prompts at the top and/or bottom of the viewer screen. These prompts provide descriptions of tools and menu commands, as well as context-sensitive suggestions about possible actions. HYPERTEXT LINK JUMPS TO UNEXPECTED DESTINATION If a hypertext link does not jump to the expected location within a document, the likely cause is that one or more pages have been inserted or deleted in the document between the hypertext source link and destination link. After pages have been inserted/deleted, re-link hypertext (select the link source using the hypertext tool, then edit the destination). PAGES OR THUMBNAILS ARE SLOW TO REDRAW AND DISPLAY IN THE VIEWER Most often, Envoy displays document pages very quickly. The speed with which Envoy displays pages might be decreased by the following: 1) The document file is being read from slow media, such as a floppy disk or a CD-ROM drive. Display time can be improved by moving the documents to a local hard drive. 2) The document includes a large colour bitmap image. Display time can be improved by choosing a lower Custom Bitmap Resolution and/or reducing the colour depth of the bitmap to 256 or 16 colours, then printing again to the Envoy Driver. 3) The document includes an intricate graphic image. Display time can be improved either by removing some of the more complex graphic elements or by replacing with a simpler graphic before printing to the Envoy Driver. RECOMMENDATIONS FOR LARGE DOCUMENTS If you are going to create an Envoy document with a large number of bitmaps in Windows, increase your system's RAM as much as possible. This will greatly decrease save time and the possibility of errors. For example, saving an 8MB manual on a Compaq 486/66 with 8MB of RAM can take eight or more hours. Increasing RAM to 24 MB decreases save time for the same manual to one hour; 40MB of RAM decreases save time to 40 minutes. IMPORTING FILES INTO VIEWER/DRAG-AND-DROP FILES ONTO VIEWER On Windows, some applications do not support converting their files to the .EVY format by importing files into the Envoy Viewer or by drag-and-drop. In order for these features to work with a file from a particular application, that application must have registered itself into the Windows Registration Database and must support printing to Dynamic Data Exchange. To test whether an application supports these Envoy features, drag a file onto the Windows Print Manager; if the file does not print, then the application does not support these features. In such a case, convert files by launching the application and printing the files to the Envoy Driver. ELSEWARE FONTWORKS ON WINDOWS FontWorks for Windows by ElseWare may cause a wait cursor to appear when the Envoy Viewer is launched. The solution is to uninstall FontWorks from your system, and to set the fonts line in the [boot] section of your WIN.INI file to read "fonts.fon=vgasys.fon". VIEWER EITHER DOES NOT LAUNCH OR LAUNCHES EMPTY AFTER PRINTING DOCUMENT TO DRIVER This situation is usually caused by lack of memory resources to support running both the printing application and the Envoy Viewer simultaneously. The solution to this problem is one of the following: 1) increase the Virtual Memory swap file size in the Windows Control Panel; 2) select the "Save as Envoy File" setting in the Envoy Driver Setup, print the document to file, quit the printing application, then launch the Envoy Viewer and open the file. LAUNCH VIEWER, SEE ERROR MESSAGE "CANNOT FIND LANGUAGE RESOURCES..." The language resources DLL either was not installed properly or was removed from the Envoy/Progs directory. Either copy a new language DLL (such as ENVOYUS.DLL) into the directory, or reinstall Envoy. ATI MACH32 VIDEO DRIVER On Windows the ATI Mach32 video driver may have some incompatibilities with the Envoy Viewer. The solution is to select another video driver, such as the standard Windows VGA driver. TOOLBAR COLOURS IN WINDOWS The colours of the Toolbar icons on the Envoy Viewer for Windows can be affected by changing the colour settings in the Windows Control Panel. If the Toolbar colours look strange, change the colour settings. Envoy Runtime Viewer: RECIPIENT OF RUNTIME VIEWER IS UNABLE TO LAUNCH VIEWER Check to make sure that the recipient is using Windows (rather than MacOS) to create the Runtime Viewer. Note that although Envoy documents themselves are compatible between Windows and Macintosh systems, the Macintosh Runtime Viewer will function only on Macintosh systems and the Windows Runtime Viewer will function only on Windows systems. SENDING A RUNTIME FILE BY E-MAIL If you send a Runtime file to e-mail using the Send feature on the File menu in the Envoy Viewer, the file is sent as an .EVY file. In order to send a Runtime file as an .EXE file, start from e-mail and attach the Runtime .EXE file. Envoy Driver: PRINTING FROM THE ENVOY VIEWER TO PCL AND POSTSCRIPT PRINTERS For best results in printing from the Envoy Viewer: Printing to PCL printers, use v1.26 or later version of the PCL driver, available from Hewlett-Packard or Microsoft. ROTATED TEXT Some applications on Windows print rotated text as a bitmap image. The result is that (1) the text cannot be selected using the text selection cursor and (2) the bitmap image may be jagged. Increase the bitmap resolution in the driver custom setup dialog to improve the visual quality of the rotated text. GRADIENTS Applications that generate gradients will render as a series of solid colours in Envoy. For best results, produce documents with solid colours rather than gradients. ENCAPSULATED POSTSCRIPT (EPS) IMAGES Documents that contain EPS files will contain the bitmap preview of the EPS image, if available, when converted to the .EVY format. The bitmap preview will be captured at the screen resolution and incorporated into the .EVY file. This is the standard behavior for non-PostScript printer drivers on Windows. In order to capture a scalable version of the EPS image, the document should first be converted to PostScript and then brought into the .EVY format using a PostScript conversion utility, such as ZScript, from ZenoGraphics. ZenoGraphics can be contacted at 800-366-7494. APPLICATION FAILS TO CORRECTLY CONVERT DOCUMENT TO .EVY FORMAT A few applications that do not conform to Windows printing standards may not be fully compatible with the Envoy Driver in some instances. See section 5, "Envoy DRIVER COMPATIBILITY," below for more details. ==================================================================== 6. ENVOY DRIVER COMPATIBILITY The Envoy Drivers on Windows carefully follow platform guidelines for design and implementation of printer drivers. Some applications, however, do not completely conform to platform guidelines for printing and therefore may be incompatible with the Envoy Driver in some instances. Applications that are incompatible with the Envoy Driver in some situations are documented below. Possible solutions are indicated, if applicable. In most of the cases listed below, applications may provide more complete output if the document is first converted to a PostScript file using a system PostScript driver and then converted to the .EVY format using a PostScript conversion utility, such as ZScript, from ZenoGraphics. ZenoGraphics can be contacted at 800-366-7494. ADOBE ILLUSTRATOR Text from Adobe Illustrator is not supported with this release of Envoy. CLARIS FILEMAKER PRO For best results with text spacing, select the High (300 DPI) resolution in the Envoy Driver setup dialog before printing from Claris FileMaker Pro. COREL DRAW Courier, Helvetica, Times, and Zapf fonts are not supported with this release of Envoy. MICROSOFT WRITE For best results with MS Write, select the Envoy Driver as the default driver in the Windows Control Panel. QUARKXPRESS Prints only bitmap images of documents to non-PostScript printers, including a bitmap image of all text. ==================================================================== 7. UNINSTALLING ENVOY FROM YOUR SYSTEM UNINSTALLING ENVOY VIEWER AND DRIVER 1. Exit Windows to DOS. 2. In DOS, delete the Envoy directory (for example, C:\ENVOY), subdirectories, and all files within those directories (except any .EVY files you have created). 3. Delete the following file in the Windows system directory (C:\WINDOWS\SYSTEM): ENVOYDRV.DRV 4. Restart Windows. 5. Delete the following file in the Windows directory (C:\WINDOWS): ENVOY.INI 6. Next, you will need to edit the WIN.INI file in the Windows directory (c:\windows), using Notepad in the Accessories program group, or using an ASCII text editor. 6.a. If you had previously selected Envoy as your default Windows printer driver, delete the following line under the [Windows] section: device=Envoy Driver, ENVOYDRV,EVY: 6.b. Delete any lines referring to Envoy under the [PrinterPorts] and [ports] sections. 6.c. Delete the lines referring to Envoy under the [devices] section. 6.d. Delete the .EVY association under the [Extensions] section. 6.e. Exit Notepad or your ASCII editor, choosing Y to replace the WIN.INI. 7. Delete the Envoy program group from the Windows Program Manager. UNINSTALLING ENVOY RUNTIME VIEWER: To uninstall the Runtime Viewer on a machine where Envoy has not been installed, 1. Delete the following files from the Windows directory (for example, c:\windows): ENVOYRTE.EXE ENVOYRTD.DLL ENVOYRTH.HLP ENVOY.INI (Note: ENVOY.INI exists only if you have changed the default settings in Envoy Runtime.) ==================================================================== 8. CUSTOMER SUPPORT If you are in the United States, Puerto Rico, or the U.S. Virgin Islands and you need assistance beyond what the QuickStart card, online Help, and this README file can provide, you can call the numbers listed below for personalised help with Envoy. If you are in another location, please contact your local affiliate or authorised reseller. Envoy Viewer: (801) 228-9929 Classic Support (you will be charged only for the phone call) (800) 861-2720 Priority Service (you will not be charged for the phone call, but will be charged $25.00 per incident for support service) (900) 555-7373 Pay per Call Support (you will be charged for the call in addition to $2.00 per minute for support service) Envoy Runtime Viewer: (900) 555-7373 Pay per Call Support (you will be charged for the call in addition to $2.00 per minute for support service) Support operators are available for Classic Support between 7:00 a.m. and 6:00 p.m., U.S. Mountain Time, Monday to Friday, excluding U.S. holidays. For Priority Service and Pay per Call Support, operators are available 24 hours a day, seven days a week. Please have your Personal Identification Number (PIN) ready when calling Customer Support. You will receive your PIN when you register your product with Novell, Inc. If you do not have a PIN, please have your licence number from your Certificate of Licence ready when calling for support. The licence number can also be found when you select About Envoy Viewer from the Help menu, if you entered it when you installed Envoy. When a product is upgraded to a new version or is discontinued, free support will continue for an additional 90 days. Envoy support policies are subject to change without prior notice. ====================================================================