Adobe(TM) Acrobat(TM) Reader UNIX(R) Read Me Notes for Version 2.1


This Read Me file contains last-minute product information for Acrobat 
Reader 2.1. The "Installation and Getting Started Guide" information and the 
online guide (Help-Reader.pdf) will also provide essential information to help
you begin using Acrobat Reader.


What's New in Acrobat Reader 2.1
================================

Acrobat 2.1 contains many new features and improvements over Acrobat 1.0.  All
features are described in the Help-Reader.pdf document. Changes of note 
include: we no longer require nor install Display PostScript (TM) or DPS-NX; 
the ability to follow cross-document links, including embedded URLs; and the 
ability to open secured files.

Acrobat Reader now accepts some specially enabled plug-ins, which enable users 
to take advantage of new capabilities in PDF files created with Acrobat 
Exchange. Two new plug-ins are Weblink and AutoClose. Weblink enables you to 
follow links and bookmarks to other PDF and HTML documents on the World Wide 
Web. AutoClose closes the least-recently-used document when you reach the 
maximum number of open documents.

Acrobat Reader prints to PostScript printers. We do not support printing to 
other printers, such as Sun's NeWSprint or PCL printers.


Known Issues with Acrobat Reader
================================

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. HP-UX users:
   
   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.
   	
3. If Acrobat Reader is started from a directory that cannot be determined then
   the launch will fail and Reader may become interfaceless but still run.
   Please run Reader from a directory that the "pwd" command can stat.
   
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.   
	
5. Acrobat Reader does not warn the user when the preferences file cannot be
   written. Please make sure the '.acrorc' file in your home directory is
   writable if you wish to save preferences.
	
6. When exiting Full Screen mode, bookmark and thumbnail views are not 
   displayed. To display them, press the appropriate button in the Tool Bar. 
	
7. Window managers other than those listed in the "Installation and Getting 
   Started Guide" are not supported.
   
8. Users cannot convert secure PDF documents to PostScript from the command 
   line even though they are able to print the files from Acrobat Reader.

9. 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. 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 "lost" 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. If another window or icon obscures the document view, scrolling the window
   modally using the hand tool or scrollbar thumb to scroll the view may leave
   newly exposed areas that were underneath the obscuring window unupdated.
   This occurs only if the window manager's auto raise feature is turned off,
   the page is not in the page cache, and the user scrolls the document image
   modally.  The document information may be refreshed by changing the view to
   some other page then back again, causing the viewer to recieve an expose
   event by obscuring it with another window, or running the "xrefresh" program.
   You can also work around this problem if you enable the window manager's
   auto raise feature.
   
Known Issues with Weblink
=========================

Acrobat's Weblink plug-in supports Netscape version 1.1 or later and Mosaic
version 2.5 or later. The preferences for Weblink are stored in $HOME/.weblink.

- Issues working with Netscape:

1. When launching Netscape from Acrobat Reader, you get a locale warning 
   message on your command line:

   netscape-v11N: locale: `iso_8859_1' not supported by Xlib; using `C'

   this is nothing to be alarmed about.

-Issues working with Mosaic:

1. Whenever you pass a Universal Resource Locator (URL) to Mosaic, you get the 
   following messages on your command line:

   MoCCINewConnection(); I've been called
   Mosaic: got a CCI connection

   this is nothing to be alarmed about. 
   
2. Due to a problem with Mosaic, its window does not pop to the front when you
   click an embedded URL in a PDF file. 
   
3. Mosaic has trouble following subsequent URLs whose base is the same as the 
   previous URL. For example, your first embedded URL is the following:
   
    	http://www.adobe.com/Product.html
    	
   The next embedded URL you click on inside a PDF file is:
   
   	http://www.adobe.com
   	
   In this scenario, Mosaic will reload the first URL instead of the second (and
   correct) URL.
   
   
Miscellaneaous Information
==========================

1. You may choose to print to any PostScript printer with the following command
   lines:

	acroread -toPostScript -pairs myfile.pdf /tmp/$$.ps
	lp -dprinter_name /tmp/$$.ps
	rm -f /tmp/$$.ps
	
   To generate level 2 PostScript, add the -level2 argument to the command
   line:
   
       acroread -toPostScript -level2 myfile.pdf
	
2. 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.
   
3. Set the following Window manager resources to make Acrobat behave similar
   to the Windows or Macintosh versions.
  
   AutoInputFocus: false 	If true, the main window will lose focus when
   				the status windows appear and the keyboard 
   				accelerators will break.
   
   SetInput: select		Must click to type in the dialog box.
   
   AutoRaise: true		Brings the window to the front when it gets 
   				the focus.
   
   For MWM, these additional resources should be set to maintain behavior closer
   to Mac and Windows.
   
   autoKeyFocus: True		When the window is withdrawn, it gives focus to 
   				the window that previously had focus.
   				
   deiconifyKeyFocus: True	Gives the window the focus when deiconified.
   
   startupKeyFocus: True	Gives the window the focus when it's created.
   
   keyboardFocusPolicy: explicit	Must click to type in the dialog box.
   
   focusAutoRaise: True		Bring the window to front when it gets focus.
   
4. Using either BSD- or System5-style printing is controlled by resources set
   in the .Xdefaults file.
   
   The default from Acrobat is System5-style and the associated resource values
   are as follows:
   
   	*acroread.lprCommand: /usr/bin/lp
   	*acroread.lprStyle: SYSV
   
   To set the resources for BSD-style printing, set the resources as follows:
   
   	*acroread.lprCommand: /usr/ucb/lpr
   	*acroread.lprStyle: BSD
 
5. 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.
   
6. Sometimes the quality of color images on 8-bit pseudocolor displays will 
   suffer because Acrobat can't grab enough colors in the default color table. 
   
   A color cube is a "block" of colors, n by m by p, that Acrobat reserves for 
   rendering colors. Acrobat looks for the nearest color it can find to the one 
   it wants in this cube.  The larger the cube, the finer the color resolution.

   Color allocation is controlled by four resources:
    *minColorCube -- the minimum color cube size; default 3 (which reserves 
    3-cubed colors plus 3x2 grays, or 33 slots in the color table)

    *targetColorCube -- the size of color cube that Acrobat initially tries to 
    allocate; default 5, yielding 5-cubed colors plus 5x2 grays for 135 color 
    table slots (the largest allowed value is 6, since on an 8-bit color display
    there are only 256 colors and 7-cubed is greater than 256).

    If Acrobat can't find the 135 slots that *targetColorCube calls for, it 
    shrinks the color cube by 1 in each dimension successively (5x5x4, then 
    5x4x4, then 4x4x4, and so on) until it comes up with a number of colors that
    will fit. If it reaches the *minColorCube size and still can't fit a color 
    cube in the color table, it uses the next resource:

    *noPrivateColormap: if this is True, failure to fit in the standard color 
    map will cause the image to drop into GrayScale (if the visual is not 
    GrayScale by default, an alert will appear).  If it is False, Acrobat will 
    allocate a private color map and allocate its colors there.

    *usePrivateColormap:  if this is True, Acrobat won't even try to fit its 
    colors into the default color map; it will always allocate its own.  
    
7. The following are other resource settings that may be helpful. You can place
   these in your .XDefaults file.
   
   *systemPlugInPath -- the location of plug-ins available to all users of the
   installed executable; default is $ACRO_INSTALL_DIR/$ACRO_CONFIG/plug_ins.
   
   *userPlugInPath -- the location of the user's private plug-ins; default
   $HOME/plug_ins.
   
   *useFrontEndProgram -- controls running a single process of Acrobat (default)
   or multiple processes; default is True.
   
   *noteTitleFontName -- controls the default font used in the titles of Acrobat
   notes; default is Helvetica.
   
   *noteTitleFontSize -- controls the font size used to display the titles of 
   Acrobat notes; default is 12.
   
   *bookmarkFontName -- controls the default font used to display bookmarks;
   default is Helvetica.
   
   *bookmarkFontSize -- controls the font size used to display bookmarks;
   default is 12.
   
   *maxOpenDocuments -- controls the maximum number of documents open at any
   given time; default is 20. Do not set this value below 2. 
   
8. Everytime you print from Acrobat Reader, a dialog will appear with the job
   ID. You can use the ID to kill the job, if you like. You must dismiss the 
   dialog by clicking OK.
   
9. 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.
   
10. 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.
   
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.

copyright 1983 - 1995 Adobe Systems Incorporated. All rights reserved.
