
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 "<Key>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.

