ReadMe Information for Acrobat(TM) Reader(TM) 3.0 for UNIX(R) ============================================================================== This document describes known issues with Acrobat Reader 3.0 for UNIX software. Acrobat Reader 3.0 for UNIX is available on the following platforms: Sparc(R) SunOS 4.1.3, 4.1.4 Sparc Sun(TM) Solaris(R) 2.3, 2.4, 2.5 HP-UX(TM) 9.03 and above AIX 4.1 and above IRIX 5.3, 6.2 Linux (built and tested on 1.2.13 Yggdrasil Fall 1995 release) The document is organized in the following sections: New Features of Acrobat Reader 3.0 Known Issues for Acrobat Reader Working with Netscape Known Issues with Acrobat Reader 3.0 New Features of Acrobat Reader 3.0 ---------------------------------- Acrobat Reader 3.0 for SunOS, Solaris, HP-UX, and IRIX can be used as a plug-in with Netscape 3.0 to display Adobe PDF files inside the Netscape window. This provides for seemless viewing of PDF and HTML files while surfing the Web. This also includes page-on-demand downloading and progressive rendering of page contents of optimized PDF files, making PDF files fast and easy to view. Also in this release is a new print dialog, allowing greater flexibility. Known Issues for Acrobat Reader Working with Netscape ----------------------------------------------------- If you encounter problems where PDF documents do not render in Netscape, Netscape hangs, or document transmission stalls, you may disable PDF rendering in the Netscape window and use the viewer as a "Helper Application". To disable PDF rendering in the Netscape 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/Acrobat3 then enter the following in the text box for the application: /usr/local/Acrobat3/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. Known Issues with Acrobat Reader 3.0 ------------------------------------ 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 3.0 for the first time. This ensures the default preference settings are used when you first run Acrobat 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 and 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 opened when viewing PDF on 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. Window managers other than those listed in the "Getting Started Guide" are not supported. 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 heterogenious enviroment or 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 because Novell truncates the name to 8.3 structure. 10. In a heterogeneous environment, all cross-document links made from Windows list the path as all uppercase letters. Acrobat Reader may not be able to locate the file specified in the path if UNIX sees the path in mixed case instead of all upper- or lowercase. 11. 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. 12. 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 supply a DISPLAY variable if one is not already defined in your environment. 13. 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. 14. 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. 15. 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 command line. This forces the lp process to copy the file to the spool area instead of making a link. 16. In Acrobat 3.0 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. SunOS-specific Information -------------------------- 1. SunOS 4.1.3 or 4.1.4 users running the X11/NeWS server: You must install patch number T100444 (with a minor number greater than 73) to your system before the application can be run. This patch fixes a problem in the X11/NeWS server that prevents all X Window System clients built with Motif 1.2.3 from hanging their server. Under certain circumstances on SunOS 4.1.3 or 4.1.4 systems running this patched X11/NeWS server, the session may still hang due to a different X11/NeWS server problem we recently discovered. The cause of this hang is not yet determined. Multiple clicks in the scroll bars to move the view pane seem to cause this problem. The problem is intermittent and cannot be reproduced with regularity. We are working with Sun to find the cause for this problem. For now we recommend that you run the application with an X11R5 server obtained from a third party or you may obtain the sources for the server from the X Window Consortium, Inc., and build your own. 2. Acrobat Search running in SunOS cannot connect to or use indexes that are uppercase. To make the index available, convert all filenames of the index and its associated directory to lowercase. For example, if your index is named "HOMEINDEX.PDX" the associated directory is "HOMEINDEX". Rename the .PDX file using lowercase letters, to "homeindex.pdx". Then, rename the directory to "homeindex" and all the subdirectories and files inside it to lowercase names. 3. To turn off the warning message presented in regards to the above issue, you can redirect the standard output and standard error streams to /dev/null or you can get a different server. 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. 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. AIX-specific Information ------------------------ None at this time. IRIX-specific Information ------------------------- None at this time. Linux-specific Information -------------------------- Adobe develops and tests this Reader on the Yggdrasil 1.2.13 Fall 95 release configuration (1.2.13 Linux kernel, XFree86 3.1.2 and the following system libraries: libc 5.0.9, libm 5.0, libdl 1.7.10). However, we believe and have heard from users that it runs well on the following system configurations: Redhat Linux 3.0.3 and kernel 2.0 Slackware and the 1.2.13 kernel XFree86 3.1.2G X server XFree86 3.1.2 server, using S3 Trio64 hardware Linux 2.0.4 ELF system Linux 2.0.21 XFree86 3.1.2G (beta; X11R6.1) libc 5.3.12 ld.so 1.7.14 Debian 1.1 with kernel upgraded to 2.0.21 Slackware 3.1 2.0.18 and a hacked-up Slackware 3.0 install Red Hat 3.0.3 Picasso system (Linux 1.2.13 kernel) 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. HP is a registered trademark and HP-UX is a trademark of Hewlett-Packard Company. Motif is a trademark of Open Software Foundation, Inc. Solaris is a registered trademark of Sun Microsystems, Inc., which has not tested or approved this product. Sun 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.