January 25, 2002 Adobe Acrobat Reader for UNIX Read Me Welcome to the Adobe Acrobat Reader 5.0.5 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:
System Requirements 
 
Installation Instructions 
 
Adobe Acrobat Reader 5.0.5 Additional Information 
 
Troubleshooting Issues
 
Known Issues for Acrobat Reader Working with Netscape

Keyboard Shortcuts

 
System Requirements:
System Requirements for Acrobat Reader 5.0.5 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.5 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) 
 
 
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.5 for Unix 
 
To install Acrobat Reader 5.0.5, follow these steps: 
 
- Make sure you have at least 30 MB of available disk space 
- Install Reader 5.0.5 by running the INSTALL script 
 
To uninstall Acrobat Reader 5.0.5, simply delete the directory where it 
was installed. 

  
Installation Issues 
 
None at this time.  

  
Installing Asian Language Kit for Acrobat Reader 5.0.5

Even though Acrobat Reader 5.0.5 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.5 product CD, or from Adobe's web site at: 
http://www.adobe.com/prodindex/acrobat/cjkfontpack.html 
 
 
 
Adobe Acrobat Reader 5.0.5 Additional Information  
 
There is no search functionality available for the Linux version of the 
Acrobat Reader.
 
Troubleshooting Issues
 
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.5 for the first time.  This ensures the default preference 
settings are used when you first run Acrobat Reader 5.0.5. 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.5 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.5 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 <ALT>, 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-2002 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. 
=======================================================================
