ReadMe Information for Adobe (R) Acrobat(R) Reader v. 4.05 for UNIX(R) ============================================================================== Updated: 10 - 22 - 99 Welcome to the Adobe Acrobat Reader for Unix. Below are known issues regarding running the Reader on the various platforms, as well as regarding running inside of the Netscape web browser. Please read this file completely to get the most out of your Acrobat experience. Thanks for using Adobe Acrobat! Adobe Acrobat Reader - Platforms, Availability, and Redistribution ------------------------------------------------------------------ Versions of the Acrobat Reader and Acrobat Reader with Search are available for 32-bit Windows (Windows 95, and NT 4.0), Macintosh (PowerPC), Sun Solaris, SunOS, HP-UX, IBM AIX, and SGI IRIX. In addition, versions of the Acrobat Reader are now also available for Intel based Linux and Digital Unix. Installers for all of these versions are available from Adobe's Web Site at http://www.adobe.com/prodindex/acrobat/readstep.html. They are also included on the Acrobat Reader; for ordering information see http://www.adobe.com/prodindex/acrobat/cdrom.html. For information on redistributing the Acrobat Reader installers see http://www.adobe.com/prodindex/acrobat/distribute.html. Technical Support ----------------- The following technical support options are available for Adobe Acrobat Reader: A. Visit the Adobe World Wide Web site at http://www.adobe.com/. The Adobe Customer Support Databases can be searched at http://www.adobe.com/supportservice/custsupport/database.html . B. E-mail techdocs@adobe.com to obtain an index of technical solutions available via e-mail. Enter "250099" as the subject of your e-mail to obtain the index of Acrobat documents. C. Call Adobe's FaxYI faxback system at 206-628-5737 (in North America) or +44 131 458 3022 (in Europe) and request document number 250099 for an index of technical solutions available via fax. D. Visit Adobe's online forums on America Online (keyword ADOBE) or CompuServe (GO ADOBESYS). Online volunteers and forum managers offer assistance on Adobe products when issues are posted on the message boards. E. If you reside in the United States or Canada, contact Adobe Acrobat Technical Support between 6:00 a.m. to 5:00 p.m. Pacific Standard Time. You can either call the (206) number and purchase an Adobe Service Credit for $25, or call Adobe's Pay-For-Support (900) number. When you call the 900 number, after the first three minutes, $2.00 per minute will be charged to your phone bill. Acrobat Technical Support for UNIX 206-675-6404 (or) 900-555-4400 Acrobat Technical Support for Macintosh 206-675-6204 (or) 900-555-3300 Acrobat Technical Support for Windows 206-675-6304 (or) 900-555-2200 Known Issues with Acrobat Reader 4.05 ------------------------------------ General Information ------------------- 1. Using NCD PC-Xware: A pink tint will appear when Smooth Fonts is turned on in General Preferences and the default visual is TrueColor 5-6-5 (RGB) in 16-bit mode (this is a PC-Xware problem). This affects only the display, not the print result. SOLUTION: Change to a different visual (8-bit or 24-bit) or turn off the Smooth Fonts option. 2. Acrobat Reader will not run correctly from a directory where the "pwd" command fails. 3. We recommend you remove the file $HOME/.acrorc before running Acrobat 4.0 for the first time. This ensures the default preference settings are used when you first run Acrobat 4.0. This is not, however, a necessity, and may actually be undesirable if you wish to continue running Acrobat Exchange 3.0. 4. Files listed in the File menu are "recent files" and depend upon exact path names. If you open a file in a session using automounter and the automounter goes down, attempting to open the "recent file" will give a "No such file or directory" error. This also occurs when the file is moved, renamed, or Reader is run from a different machine that does not have the same file systems mounted. 5. To prevent temporary files (for instance opened from the Web) from appearing in the "recent files" list, set your mailcap entry as follows: application/pdf;acroread -tempFile %s 6. Acrobat Reader does not warn the user when the preferences file cannot be written. Please make sure '$HOME/.acrorc' is writable if you wish to save preferences. 7. Some Window managers may work better than others. Specifically, we have tested CDE, KDE, and Openwindows. 8. Users cannot print password-protected PDF documents to PostScript from the command line even though they are able to print the files from Acrobat Reader. 9. When operating in a heterogenous network enviroment using Novell servers, we recommend you avoid giving PDF files long names (greater than 32 characters). A Novell server displays the long file name to a Macintosh user, but the Macintosh Operating System prevents Acrobat from opening the file. This is not a problem on Windows. 10. Modal dialog boxes may appear to be "buried" behind the main document window. When they are behind the main window, they are still active and prevent the user from doing anything. To bring the dialog to the front, click anywhere in the main window. You can now dismiss the dialog and proceed. 11. At the command line, type 'acroread -help' or 'acroread -helpall' for more information on command line options. Note that when using these command lines you must still supply a DISPLAY variable if one is not already defined in your environment. 12. On a Tektronics X-Terminal: If displaying a document in Full Screen mode using a black background, a small white line will appear along the bottom and right edges of the background. This is due to a problem in the olwm running locally on the X-Terminal and is not an Acrobat bug. 13. Characters in PDF files that are not part of the ISO8859 encodings will not display when the text is selected and pasted elsewhere. This is most notable with the Registered and Trademark symbols. Printing is not affected and will work fine. 14. Printing: no document printed and/or error in lp log. When you lp foo.ps, it creates a symbolic link from the spool file to the foo.ps file. This saves space on the file system. Unfortunately, Acrobat creates a temporary file to spool, writes the PostScript out, and then deletes the temporary file before the lpd process can get hold of it. SOLUTION: Include the "-c" option (copy) on the lp or lpr command in the print dialog box. This forces the lp process to copy the file to the spool area instead of making a link. 15. In Acrobat 3.0 and later it is possible to give a PDF file attributes for how it should open (with or without Tool bar, etc.) To make Acrobat ignore the "Open" settings, keep the CTRL and Shift keys pressed down when clicking OK in the File > Open dialog box. For example, when opening a file which has been set to hide the Tool bar, it is not possible to then show the Tool bar for the file once it is open. If you need the Tool bar displayed, you should close the file and re-open it making Acrobat ignore the "Open" settings. 16. Launching external applications / Security - PDF files may contain instructions to launch an external application or to open a non-PDF file. To enhance the security of PDF files, Acrobat Reader version 4.0 will prompt users with an alert before launching an external application, an executable file or a command. The alert will say: "Acrobat is about to launch this application: " [Application] "Allow this action (yes) or all actions to all applications (all)?" followed by three buttons, "Yes", "No", and "All". - Choosing "Yes" will allow only this instance of this action. - Choosing "No" will prevent this instance of this action. - Choosing "All" will allow all instances of all actions, thus disabling the alert until Acrobat is exited and restarted. 17. Using Acrobat Search. If you want to create full text search indexes that can be reliably used across platforms, you must use ISO 9660 file naming conventions for the indexed files (8.3 uppercase, restricted character set). If you don't use such names, the UNIX Reader will attempt to guess what the Unix filenames are. This causes delays in searching, and may result in the file not being found. 18. The select graphics tool and column text select tool are nested under the select text tool. To select one of these other tools, click and hold down the select text tool button, then drag your mouse over to the tool you wish to use. 19. Although there is a "Use Page Cache" option, it is disabled inside the Viewer for 4.0. 20. The acrobat reader will not support visuals with 12 planes. If you attempt to run the reader on a display set to a visual with 12 planes you will see the following message: Depth=12 Visuals are not supported by Acrobat Reader If this happens, you can manually set the visual for the Reader by using the -visual command line option. 8, 16, and 24 plane visuals are fully supported. You can use the xdpyinfo command to determine your X terminal's supported visuals. See the man page for more info. 21. Open file links may not work on Unix platforms On Unix platforms, links to an external file may not open correctly due to system file registration incompatibilities [303737] 22. Full Reader functionality is not available for CJK text on Unix The Unix Acrobat Reader has been enhanced to view and print documents that contain Chinese, Korean, and Japanese text. However, there are currently various limitations on Unix: -No Forms fill in using Asian fonts -Cannot view notes created with Asian fonts -You may not search/find words that use Asian fonts -Bookmarks which use Asian fonts will not be displayed correctly -You may not copy/paste words containing Asian fonts [306872] 23. Errors when printing PDF files saved from InDesign 1.0 PDF files created by InDesign 1.0 will sometimes give an error when printing to PostScript Level 2 and Level 3 printers. The workaround is to create the PDF from InDesign using Distiller, or print from Acrobat to a PCL printer, or print from Acrobat using Print As Image. [323742] Known Issues for Acrobat Reader Working with Netscape ----------------------------------------------------- ACROBAT WON'T LAUNCH. If you encounter problems where PDF documents do not view correctly in Netscape, Netscape hangs, or document transmission stalls, you may disable PDF viewing in the Netscape window and use the viewer as a "Helper Application". To disable PDF rendering in the Netscape 3.0 window: 1. Pull down the "Options" menu item and select "General Preferences". On the "General Options" dialog, select the "Helpers" tab item. Find the item in the list of helper applications that looks like the following: application/pdf Plug In : nppdf.so 2. Select this item. 3. Select the "Edit ..." button to modify this entry. In the dialog box, select the item marked "Application" and enter the pathname to the Acrobat Reader product along with the "%s" field identifier for the temporary file name. For example, if Acrobat Reader is installed in /usr/local/Acrobat4 then enter the following in the text box for the application: /usr/local/Acrobat4/bin/acroread %s 4. Select the "OK" button in the "Netscape Helper" dialog box. 5. Select the "OK" button in the "Netscape: General Preferences" dialog box. The view in Netscape window feature has been disabled and Acrobat will act as a Netscape helper application. SOME FORMS CAUSE "SAVE AS" DIALOG Some forms cause the Save As dialog to come up. This is because certain forms return Forms Data Format files (.fdf) and Netscape is not set up to handle this mime type. This is easy to fix; following are directions for Navigator 4.x: -Bring up Preferences dialog by selecting the Edit menu, then the "preferences" menu item. -Under the Navigator section, select Applications. -Click on the New button. -For Description, type Forms Data Format -For Mime type enter: application/vnd.fdf -For Suffixes enter: fdf -Click Application -Type /usr/local/Acrobat4/bin/acroread -iconic %s (note: your path may vary) -Click OK Navigator 3.x: -Choose General Preferences from the options menu -In the General Preferences window that appears, click the Helpers Tab. -Click "Create New Type" -Mime Type: application -Mime SubType: vnd.fdf -Click OK Now application/vnd.fdf should be selected. If not, scroll to it in the File type list. -Under the text field "File Extensions, type: fdf -Click "launch the application" -Type in the application text field: /usr/local/Acrobat4/bin/acroread %s iconic (note: your path may vary) -Click OK Netscape is now ready to accept forms data format. RUNNING IN 256 COLORS OR LESS. Often the viewer may launch in greyscale mode when running inside of Netscape as a plugin. This will happen when your default visual has a color depth of 8 planes or less (PseudoColor for instance).This is because Netscape does not "grab" enough colors for Acrobat. You can work around this problem by launching an instance of the Acrobat Reader and displaying it on the current screen before launching Netscape. Netscape will then use the Color Map that Acrobat has created and will allow the viewer to run as a plugin with enough colors. This won't be an issue if you are running with 16 or more color planes. CAN'T SUBMIT FORMS FROM NETSCAPE. Submitting forms on the web will not work if Netscape has warned you that it found a lock file in the .Netscape folder. This warning (which occurs when you first launch Netscape) usually means you have another copy of Netscape running. You may fix this problem by insuring that only one copy of Netscape is running. If a lock file is left around because of a Netscape crash, you may simply delete the .Netscape/lock file. SETTING UP WEBLINK. It is a good idea to set the weblink preferences so that the Acrobat reader can find netscape. We recommend that you actually point to the editted netscape launch script that we provide with the Acrobat Reader, which can be found in the Acrobat4/Browsers folder. You can edit this script to set NDIR to point to your netscape installation and set the ADIR to point to your Acrobat installation. If you set up your Browser application to point to our script, you won't have multiple launches of the reader if you click on a web link, in a PDF file, then later click on a PDF Link on a web page. That is not the case if you set your Web Browser Application to the netscape provided script. AIX-Specific Information ------------------------ 1. The acrobat plugin for netscape does not run properly under AIX 4.3. If you attempt to use the plugin under netscape 4.7, you may see a message: "Cant load plugin". For AIX 4.3, we recommend setting up Acrobat as a helper application instead of a plugin. See above for instructions. on how to do this. 2. Some versions of netscape will crash when a pdf link is revisited. If this is happening on your system, we recommend you run acrobat as a helper application instead of a plugin. See above for instructions. Solaris-Specific Information ---------------------------- 1. Text colors may change depending on zoom factor. This occurs when working in Solaris on a Sparcstation with a CG14 frame buffer and is a known problem with the CG14 frame buffer. Please contact Sun Microsystems for a patch. The following patches are available and should correct the problem: Solaris Release Patch id --------------- --------- 2.5.1 103794-01 2.5 103074-02 2.4 101922-15 2.3 101594-18 2. A segmentation fault will occur when launching Acrobat Reader if your PSRESOURCEPATH includes /usr/openwin/lib/X11. This directory does not contain Type1 PostScript fonts and should not be included in the path statement. 3. We have experienced crashes while trying to fill in forms using the X server that ships with _all_ versions of Solaris 2.6. There is a patch available from sun to fix this. The patch number is 105633-21 and you may download it from sun's website at http://www.sun.com. 4. There is no search functionality available for the x86 Solaris version of the Acrobat Reader. HP-UX-Specific Information -------------------------- 1. You might receive warning messages indicating missing fonts. There are several messages you could receive depending on your configuration. - You are displaying on an X server that has no HP-ROMAN8 font defined. The message you receive is: Warning: No fonts available with charset "HP-ROMAN8", using "ISO8859-1" In this situation, upper-ascii characters will display incorrectly. To fix this, change your language to an ISO8859 language (e.g., setenv LANG american.iso88591). - The variable fontList is specified and its encoding doesn't match the encoding of the application. If you specified an ISO font list, you will receive an error that says the encoding for fontList doesn't match the locales encoding. You need to change your LANG variable as listed above. - The Helvetica used by the Motif toolkit is not available on the system in the hp-roman8 encoding. The message you might receive is: Warning: Cannot convert string "-adobe-helvetica-bold-r-normal-*-*-120-*-*-*-*-hp-roman8" to type FontStruct This occurs when you are running on HP but displaying on a non-HP system. To fix this, set an application resource for fontList to specify a font that exists on the system. 2. The HP Motif library uses different virtual key bindings than Sun's. As a result, when running on a Sun and displaying on an HP, the keys for DeleteLine, DeleteChar, InsertLine, and InsertChar may not be properly defined by default. You can tell if you get warnings of the form 'Warning: cannot convert string "DeleteChar" to type VirtualBinding'. One consequence of this is that the Esc key on some HP keyboards will not work to exit Full Screen mode. To fix this, load a file with the appropriate key bindings using the "xmbind" command. See the man page for xmbind for where it looks for the file. Check the bindings using "xprop -root | grep BIND". The resulting string should include hpDeleteLine, hpDeleteChar, hpInsertLine, and hpInsertChar. 3. Support for viewing/printing files with embedded ICC profiles, a new feature of Acrobat 4.0, is not supported on the HP platform due to compiler issues. Currently, if you try to print a file with an embedded ICC profile, your viewer may display a bus error, and possibly crash. IRIX-Specific Information ------------------------- None at this time. OSF-Specific Information ------------------------ None at this time. Linux-Specific Information -------------------------- 1. The Acrobat Reader for Linux was built on a 2.2.5-15 kernel. (RedHat 6.0) 2. There is currently no search functionality available for the Linux Acrobat Reader. 3. The current Reader is now "glibc" 2.1 based as opposed to libc. This means that the Acrobat Reader has been linked with libc.so.6 as opposed to libc.so.5. The effects of this are mainly that if you are using a "libc" based version of Netscape, you will not be able to launch the Reader as a plugin. In fact, this will crash netscape. Also, systems that use the older "2.0.x" glibc libraries (such as RedHat 5.x and Debian 2.x, and Slackware 4.x) may experience crashes when running this version of the Acrobat Reader. We therefore recommend running the very latest version of your distribution. Debian plans to move to glibc 2.1 in the next release. Slackware is glibc 2.1 based for version 7.0. --------------------------------------------------------------------------------- Adobe, the Adobe logo, Acrobat, the Acrobat logo, and PostScript are trademarks of Adobe Systems Incorporated or its subsidiaries and may be registered in certain jurisdictions. Macintosh is a registered trademark of Apple Computer, Inc. Digital is a trademark of Digital Equipment Corporation. HP is a registered trademark and HP-UX is a trademark of Hewlett-Packard Company. IBM, AIX, and OS/2 are registered trademarks of International Business Machines Corporation. Microsoft and Windows are registered trademarks and Windows NT is a trademark of Microsoft Corporation in the U.S. and other countries. Motif is a trademark of Open Software Foundation, Inc. IRIX is a trademark of Silicon Graphics, Inc. Solaris is a registered trademark of Sun Microsystems, Inc., which has not tested or approved this product. Sun, SunOS, and OpenWindows are trademarks of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC International, Inc. SPARCstation is a registered trademark of SPARC International, Inc., licensed exclusively to Sun Microsystems, Inc. and is based upon an architecture developed by Sun Microsystems, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. X Window System is a trademark of the Massachusetts Institute of Technology. All other products or name brands are trademarks of their respective holders. Copyright 1983 - 1999 Adobe Systems Incorporated. All rights reserved.