May 08, 2004 Adobe® Acrobat® Reader for UNIX® Read Me Welcome to the Adobe® Acrobat® Reader 5.0.9 Read Me. Adobe Acrobat Reader is the free viewing companion to Adobe Acrobat 5.0. Acrobat Reader lets you view, navigate and print Portable Document Format (PDF) files. Adobe Acrobat 5.0 is a complete solution for creating, enhancing, reviewing, editing, and sharing information in PDF. To learn more about Adobe Acrobat 5.0, visit http://www.adobe.com/products/acrobat This Read Me contains information on: New for Acrobat Reader 5.0.9 System Requirements Installation Instructions Adobe Acrobat Reader 5.0.9 Additional Information Troubleshooting Issues Known Issues for Acrobat Reader Working with Netscape Keyboard Shortcuts New for Acrobat Reader 5.0.9 A security patch was applied that solves a couple of problems reported with malformed uuencoded pdf files. New for Acrobat Reader 5.0.8 A security patch was applied that solves a problem reported with long URLs in weblinks which can cause a buffer overrun. New for Acrobat Reader 5.0.7 A security patch was applied that solves the problem reported in CERT vulnerability 200132 whereby a weblink could execute shell commands. New for Acrobat Reader 5.0.6 A security patch was applied that solves the problem reported in http://online.securityfocus.com/archive/1/278984 where opening the font cache when the application starts up can unintentionally cause the permissions of other files to change. System Requirements: System Requirements for Acrobat Reader 5.0.9 for Solaris® - SPARC®-class processor - Solaris version 2.6, 7, or 8 - 64 MB of RAM (128 recommended) - 30 MB of available hard disk space - Additional 40 MB of hard-disk space for Asian fonts (optional) System Requirements for Acrobat Reader 5.0.9 for Linux® - Pentium®-class processor - Linux kernel 2.2 - glibc 2.1.3 - 64 MB of RAM (128 recommended) - 30 MB of available hard disk space - Additional 40 MB of hard-disk space for Asian fonts (optional) System Requirements for Acrobat Reader 5.0.9 for HP-UX® - HP-UX 10.20 or 11.0 - 64 MB of RAM (128 recommended) - 67 MB of available hard disk space - Additional 40 MB of hard-disk space for Asian fonts (optional) System Requirements for Acrobat Reader 5.0.9 for AIX® - AIX 4.3.3 or 5.1 - 64 MB of RAM (128 recommended) - 50 MB of available hard disk space - Additional 40 MB of hard-disk space for Asian fonts (optional) Web Browser Support PDF files may be viewed within Netscape 4.x using Acrobat Reader on both Solaris and Linux. Netscape 4.7x is preferred. Installation Instructions Installing and Uninstalling Acrobat Reader 5.0.9 for Unix To install Acrobat Reader 5.0.9, follow these steps: - Make sure you have at least 30 MB of available disk space - Install Reader 5.0.9 by running the INSTALL script To uninstall Acrobat Reader 5.0.9, simply delete the directory where it was installed. Installation Issues None at this time. Installing Asian Language Kit for Acrobat Reader 5.0.9 Even though Acrobat Reader 5.0.9 for Unix is only available as a US English application, asian language kits are available. Users can display Adobe Portable Document Format (PDF) files that contain text in Chinese Simplified, Chinese Traditional, Japanese, and Korean (CJK). All you need to do is install the appropriate Asian font pack for use with Acrobat Reader. The Asian Language Support installers are available on the Adobe Acrobat 5.0.9 product CD, or from Adobe's web site at: http://www.adobe.com/prodindex/acrobat/cjkfontpack.html Adobe Acrobat Reader 5.0.9 Additional Information There is no search functionality available for the Linux version of the Acrobat Reader. Troubleshooting Issues Keyboard accelerators for menu items do not work on AIX Some documentation will refer to keyboard accelerators for menu items, like +L to go in to Full Screen mode. These accelerators do not work on AIX. [528004] Problems running Acrobat on older HP hardware and displaying to Solaris screen Due to incompatibilities between the X Server on Solaris displays and Motif clients running on older HP hardware (HPPA 1.1) with HP-UX 10.20, this configuration will not be supported. The suggested workaround is to use more recent HP hardware (HPPA 2.0 or later) or to use any other X-capable display; older HP-UX, Linux, AIX, etc.[527114] Using the Toolbar Acrobat Reader's toolbars can be torn-off, docked on the top, and their geometry may be changed. Torn-off toolbars cannot be combined by dragging the title bar of the toolbar; use the drag handle of the toolbar instead.[398112] Viewing PDF files within Netscape When attempting to view relatively large PDF files, you may see an error message saying "Page processing error. File input/output error. Time out during connecting." Other symptoms that you may see are Acrobat Reader displays blank pages or Acrobat Reader may hang. Check with your systems or network administrator that the version of Apache being used is 1.3.17 or greater. Acrobat Reader may exhibit the symptoms listed above with earlier versions of Apache.[417553] CJK Text Display of bolded text when magnification is applied Some CJK bolded characters may be blurred if the original application created the bolded text with synthetic bolding. If the Smooth Text and Use CoolType preferences in the Display preference panel are turned off, when the document is magnified you may see some white areas or cracks. Acrobat 4.x writes a character four times to achieve bolding, and for some documents, such text may appear as four lines of text instead of appearing as bold text. In Acrobat 5.0, synthetic bolding is used. Adobe recommends turning on the Smooth Text and Use CoolType preferences in the Display preference panel to avoid seeing white areas or cracks when the bolded text is magnified. [418447] Find Dialog - Using Find to Locate Unicode Characters You can use Find to locate Unicode characters within a PDF document. To do this, add a "\u" in front of the Unicode character for which you want to search. For example, to search for the Unicode equivalent of the ASCII character "A" , enter "\u0041" in the Find dialog. For some CJK characters, such as Unicode "4e01", you can specify "\u4e01".[413632] Hong Kong Character Set and Comments and Bookmarks Acrobat Reader 5.0 supports the Hong Kong character set for text in a PDF file. It is an extension to the Adobe Chinese Traditional character set. If you would like to view PDF files that contain text using the Hong Kong character set, please install support for the Chinese Traditional character by installing the Chinese Traditional Language Pack. Since the Hong Kong character set is not part of the standard system fonts you will not be able to comment or create bookmarks using Hong Kong characters.[407877] Save A Copy Acrobat Reader 5.0 contains a menu item and a toolbar icon called "Save A Copy". If you modify an Adobe PDF file in Acrobat Reader 5.0, your changes will not be preserved when you use this command. Only a copy of the original Adobe PDF file will be saved; saving updates is not a feature of Acrobat Reader.[414048] 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. The solution is to use a different visual (8-bit or 24-bit) or turn off the Smooth Fonts option. Acrobat Needs Access to pwd Acrobat Reader will not run correctly from a directory where the "pwd" command fails. Removing Previous Preferences We recommend you remove the file $HOME/.acrorc before running Acrobat 5.0.9 for the first time. This ensures the default preference settings are used when you first run Acrobat Reader 5.0.9. This is not, however, a necessity, and may actually be undesirable if you wish to continue running Acrobat Reader 4.0. Recent Files Names 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. Prevent Temporary Files from Showing Up in Recent File List 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 Writing the Preferences File Acrobat Reader does not warn the user when the preferences file cannot be written. Please make sure '$HOME/.acrobat' is a writable directory if you wish to save preferences. Window Managers Some Window managers may work better than others. Specifically, we have tested CDE, KDE, and Openwindows. Printing Password-protected PDFs 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. Heterogenous File Server Environment When operating in a heterogenous network environment 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 the user of a Macintosh® computer, but MacOS® prevents Acrobat from opening the file. This is not a problem on Windows. Buried Modal Dialogs 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. Command line help 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. Pasting Non-ISO8859 Characters 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. 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. The solution is to 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. Open Actions 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. 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 5.0.9 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. 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. Select Graphics and Column Text Select Tools 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. Setting Weblink Preferences Set your Web Browser Application to point to a local copy of Netscape if at all possible. Typically network installations of Netscape will be a shell script that does other things and can interfere with the setup of the Acrobat plug-in. If you do not have a local copy of Netscape on your system or are unable to install it locally, then make sure that the Web Browser Application is set to the Netscape executable and not a script. Printing documents with transparent Images When printing documents that contain transparent images, sometimes one of the images will disappear. This only happens when printing within the Acrobat user interface. The work around is to use command line printing which will print the PDF correctly. [510825] Known Issues for Acrobat Reader Working with Netscape: It is highly recommended that customers use the netscape script located in the Browsers subdirectory of the Adobe Acrobat Reader 5.0.9 for Unix installation area. Before using the script, the user may find it helpful to modify the script to know where the Acrobat installation area is and the location of the netscape executable. For example: adir="/usr/local/Acrobat5" ndir="/opt/Netscape-4.78" See the comments in the script for more information. Note: This script does not install the Acrobat plug-in into the Netscape installation area. It tells the netscape application (for this run only) where the Acrobat plug-in is located. If the user runs the Netscape application directly, in this case /opt/Netscape-4.78/netscape, the Acrobat connection will not be present. Netscape 6.0 Acrobat Reader 5.x supports Netscape 4.x and installs a plug-in to work with this browser. This plug-in enables users to download, view, navigate and print Adobe PDF files, and to fill in PDF forms while working inside the browser. With Netscape 6.0, Acrobat Reader 5.x works only as a helper application. PDF files must be downloaded in their entirety before they can be viewed. Also, with Netscape 6.0, PDF forms cannot be filled in when viewed within the Browser. Acrobat will not 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 window: 1. Pull down the "Edit" menu item and select " Preferences". On the "Preferences" dialog, select the "Navigator" tab item and then the "Applications" item. Find the item in the list of helper applications that looks like the following: application/pdf Plug In: nppdf.so or Portable Document Format 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/Acrobat5 then enter the following in the text box for the application: /usr/local/Acrobat5/bin/acroread %s 4. Select the "OK" button in the "Application" dialog box. 5. Select the "OK" button in the "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 To Appear 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/Acrobat5/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. Cannot 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. Using Acrobat As a Helper Application Netscape doesn't open a PDF but the association to a helper application is set. In this case, make sure the "%s" is on the command line to the helper application. For example "/usr/local/Acrobat5/bin/acroread -iconic %s". [497621] Acrobat and Netscape Crash When Opening a PDF Netscape 4.5 can crash loading the Acrobat plug-in on Solaris 2.7. The solution is to use Netscape 4.7X. [503568] Arrow key shortcuts may be unreliable when viewing a PDF in Netscape with the Acrobat plugin. On some systems, using the arrow keys to navigate between bookmarks in the Bookmark pane may be unreliable. The Up and Down arrow keys should move bookmark selection to one above or one below in the list, and the Left and Right arrows should open and close, respectively, a hierarchical Bookmark list. [513194] Keyboard Shortcuts: Hot Keys or Accelerators: Access menu bar with , then one of these keys: e - Edit menu f - File menu 1 ... 9 to load 1st through 9th most recent document h - Help menu v - View menu w - Window menu Selecting Tools: h - hand tool v or Shift-v - text select tool z or Shift-z - the zoom tool g - graphics select tool Navigation Tools: Page Up for previous screen Page Down for next screen Left Arrow for previous page Right Arrow for next page Up Arrow to scroll up Down Arrow to scroll down CTRL L to show or hide full screen CTRL N to go to a specific page CTRL Left Arrow to go to previous view CTRL Right Arrow to go to next view Function Keys: F5 to show or hide or select bookmarks F6 to show or hide or select thumbnails F8 to show or hide toolbars Editing Documents: CTRL A to select all CTRL C to copy CTRL M to zoom to CTRL O to open CTRL P to print CTRL Q to quit CTRL W to close a document CTRL 0 to fit in window CTRL 1 to fit actual size CTRL 2 to fit width CTRL 3 to fit visible CTRL + to zoom in CTRL - to zoom out SHIFT CTRL A to unselect all SHIFT CTRL P for page setup SHIFT CTRL S for save as SHIFT CTRL + to rotate clockwise SHIFT CTRL - to rotate counterclockwise Searching: CTRL F to find CTRL G to find again Document Information and Preferences: CTRL D to bring up document summary dialog box CTRL K to bring up General Preferences dialog box ALT CTRL S to bring up Document Security dialog box ATL CTRL F to bring up Document Fonts dialog box Windows: ALT CTRL W to close all windows ====================================================================== Copyright © 1987-2004 Adobe Systems Incorporated and its licensors. All rights reserved. Adobe, the Adobe logo, Acrobat, the Acrobat logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Distiller, Adobe Type Manager, ATM, Illustrator, PageMaker, and Photoshop are trademarks of Adobe Systems Incorporated. Sun, Sun Microsystems, the Sun Logo, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the United States and other countries. Products bearing SPARC trademarks are 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. Linux is a registered trademark of Linus Torvalds. Novell is a registered trademark of Novell, Inc. Macintosh and MacOS is a trademark of Apple Computer, Inc., registered in the United States and other countries. NCD and PC-Xware are trademarks or registered trademarks of Network Computing Devices, Inc. in the United States and other countries. STSong™ is a trademark of ChangZhou SinoType Technology Co., Ltd. All other trademarks are the property of their respective owners. The contents of this file are subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.mozilla.org/MPL.This file has not been modified by Adobe and Source code may be found at http://www.mozilla.org/source.html. The Original Code is Mozilla Communicator client code, released March 31, 1998.The Initial Developer of the Original Code is Netscape Communications Corporation. Portions created by Netscape are Copyright © 1998 Netscape Communications Corporation. All Rights Reserved. =======================================================================