home *** CD-ROM | disk | FTP | other *** search
- ==============================================================
- Adobe and Acrobat are trademarks of Adobe Systems Incorporated
- which may be registered in certain jurisdictions.
-
- ****************************************************
- This Acrobat Reader is a pre release version, does not represent
- final product from Adobe, and may contain bugs,
- errors and other problems that could cause system failures.
- The Acrobat 3.0 Beta Reader is currently available for OS/2 Warp,
- Win 3.1, Windows 95, Windows NT, and Macintosh.
- ****************************************************
-
- (c) 1996 Adobe Systems Incorporated. All rights reserved.
-
- I. Adobe Acrobat Reader for OS/2
-
- Welcome to the second beta for the Acrobat Reader for OS/2 Warp.
- You must have OS/2 version 3.0 or higher to run this software.
- This reader is a 3.0 code level version. Therefore, it shares
- the following new features for Acrobat with the other 3.0 readers:
-
- -NETSCAPE INTEGRATION: Display Acrobat files inside of netscape
- and jump to web URLs from within Acrobat. (requires Netscape
- version 2.02E)
- -FORMS: Ability to fill out Acrobat forms
- -New views -- continuous scrolling and 2-up pages.
- -Anti-aliased text for crisper onscreen viewing.
-
- Please make sure you read the known problems at the end of this
- file; especially before reporting any bugs to Adobe via the Web.
-
- We on the Acrobat Reader team would like to thank everyone for
- using our web pages to report problems, and encourage everyone to
- continue doing so in the future. It's through this process that
- we are able to solve a wide variety of problems that we might
- otherwise be unexposed to. You can find out how to report prob-
- lems by reading the section below entitled "Reporting Problems"
-
- NOTE: The URL for reporting problems has changed. See "Reporting
- Problems for the new location".
-
-
- II. This file contains the following topics:
-
- -Installing the Acrobat Reader
- -Getting Help
- -Reporting Problems
- -Setting up for use with the IBM WebExplorer
- -Setting up for use with Netscape
- -Known Problems
-
-
- III. Installing the Acrobat Reader.
-
- 1. OS/2 Installation:
-
- Note that the use of "<enter>" below refers to hitting your key-
- board's ENTER or RETURN key. Everything else within quotes should
- be typed exactly.
-
- The OS/2 Acrobat Reader comes in the form of a self extracting
- archive (OS2RD3B2.EXE) which you will have downloaded using your
- web browser.
-
- NOTE TO NETSCAPE USERS: If you haven't installed the Final
- version of Mozilla, you may want to do that before installing
- Acrobat. Acrobat takes advantage of Netscape with Web integration,
- and will install files into Netscape. If you install Netscape after
- Acrobat, you will simply have to move the "plugin file" manually.
-
- To install Acrobat, execute "OS2RD3B1.EXE". i.e.:
-
- [C:\]OS2RD3B2.EXE
-
- If this file exists on a network drive to which you only have
- read access, you can install it directly as long as you do invoke
- the install program from a write-able drive on your system. i.e.:
-
- [C:\]N:\OS2RD3B2.EXE
-
- This will start the installation program. When the first dialog
- box comes up, read the screen carefully, then click on the "Con-
- tinue" button. The next screen will come up and ask you if you
- wish to install this product. Click on the "OK" button.
- Next, the Adobe end user license agreement page comes up. Read
- the entire document and then click on "Accept" if you agree to
- the license, or "Do Not Accept" to abort installation.
- Once you accept the agreement, the "Install - directories"
- dialog box will come up. You must make sure that the "Installa-
- tion directory" has enough disk drive space to hold the program.
- The default directory is C:\ACROBAT3\READOS2. If you would like
- to change the location for Acrobat, do so now by editing the
- displayed text. Once you have chosen a directory, click on the
- Disk space button. If the "Bytes available" on the drive for the
- directory you chose exceeds the "Bytes needed" number, click on
- the OK button, otherwise, select another drive then click on the
- OK button. This will automatically change your installation
- directory to an equivalent directory on that drive letter.
- Once you have done this, you may click on the "Install" but-
- ton. When the progress bar completes, you should see a screen
- which says "The requested components of Acrobat Reader for OS/2
- are successfully installed." When you click on OK, the installer
- should exit. Your installation is complete.
- IMPORTANT NOTE: This installation program may find that you
- have previously installed the Beta 1 version of Acrobat Reader
- for OS/2. If so, you will be asked whether you want to update
- it or delete it and re-install. You must choose to "Delete the
- installed product and re-install."
-
- Once you have installed the reader on your machine, you may
- either delete the OS2RD3B2.EXE program, or you may choose to
- leave the program on a network drive where others can have access
- to it for installations. If you would like to distribute it on
- floppies, you will need to use the OS/2 BACKUP and RESTORE commands
- or some equivalent utility since the archive file is larger than
- what one floppy will hold.
-
- You'll now have an "Adobe Acrobat" folder on your desktop.
- Double click on that folder, then double-click on the "Acrobat
- Reader" program to start Acrobat. If you had trouble installing,
- check the INST_L1.LOG file in the c:\os2\install directory.
-
- 2. Users of Acrobat Reader for Windows:
-
- Those folks who are currently using the Windows Acrobat Reader
- may find that when they double-click on an Acrobat file in the
- Workplace Shell, the Windows Acrobat program launches instead of
- the OS/2 Acrobat Reader. This is because the Windows program
- object is still associated first with PDF (portable document
- format) files. To set up your system to use the OS/2 Acrobat
- reader by default, do the following:
-
- a] Locate the program object for your Windows Acrobat Reader
- or Exchange program. This may be "nested" in a folder on your
- desktop called "WIN-OS/2 Groups". In this folder, look for a
- folder called "Adobe Acrobat" or "Adobe Acrobat 2.0". Inside one
- of these folders, look for a program called "Reader" or "Ex-
- change". If present, right click on the program icon using the
- right mouse button (left mouse button if you set the mouse to be
- left-handed), then click on settings. Click on the notebook page
- that says "Association". If you see a reference to "*.PDF" in the
- list box entitled "Current Names", click on that reference, then
- click on the "Remove" button next to the list box. This will
- remove the *.PDF association to your Windows Acrobat viewer.
- b] If you _didn't_ find the association in a program object
- in one of these folders, yet the Windows viewer still launches
- when you double-click on PDF files, try searching your computer
- for the actual executable (.EXE) file for the Windows viewer.
- This will either be called "ACROREAD.EXE", "ACROEXCH.EXE",
- "ACROEX16.EXE", or "ACRORD16.EXE". You can search for this by
- right clicking on your OS/2 Desktop, then selecting "Find" from
- the popup menu. Type "ACRO*.EXE" in the "Name" field, then make
- sure the "Start Folder" has "<All Local Drives>" selected. Also
- make sure that "Search All Subfolders" has a checkbox next to it.
- Now click on the Find button. When this operation has completed,
- you'll see a list of files that match this name. (NOTE: One of
- the files named "ACROREAD.EXE is your OS/2 viewer.) Check the
- Associations page for each file to make sure that "*.PDF" is not
- listed in the "Current Names" listbox for that file.
-
- If you have done this properly, your Windows viewer should not
- appear the next time you double click on an Acrobat document. To
- insure this is the case, right click on a "PDF" file, then click
- on the arrow next to the "Open" item. The only menu item you
- should see is "Acrobat Reader".
-
- Note: If you want to have a choice on the open menu for PDF files
- to allow you to open _either_ the OS/2 program or the Windows
- program, you may re-add the association to "*.PDF" to the Windows
- program icon (not the executable file) at this time. The OS/2
- Viewer will still be the default association.
-
- 3. Uninstalling Acrobat
-
- To Uninstall Acrobat, double click on the Acrobat Reader Unin-
- stall icon in the Adobe Acrobat folder. Next, click continue,
- then click on the delete button.
-
- IV. Getting Help
-
- The Acrobat home page can be found at
- http://www.adobe.com/Acrobat on the internet. From here, you may
- download all the currently available versions of the Acrobat
- Reader. You can also find out how to configure Acrobat with the
- various HTML Viewers, including WebExplorer. Look to these Web
- pages for up-to-date information on Acrobat 3.0 and the OS/2
- Acrobat Reader.
-
- V. Reporting Problems
-
- Please do not send E-mail directly to Adobe concerning problems
- with the Acrobat Reader for OS/2. The proper way to report prob-
- lems regarding Acrobat are through the online bug form on our web
- site. The URL for this site can be found at:
- http://www.adobe.com/prodindex/acrobat/bugreport.html.
-
- BEFORE you report problems, PLEASE make sure that the problem
- you are experiencing is not already a known problem. You can do
- this by first checking the list below., and also by checking out
- our list of known problems on the web, available from the Acrobat
- home page, or by linking directly to
- http://www.adobe.com/prodindex/acrobat/knownproblems.html
-
- The bug report page has a form with many entry fields on it.
- Make sure to complete this form as completely as possible; ESPE-
- CIALLY the field for "Operating System". That is the only way we
- will be sure to get the right problems to the right people!
-
- VI. Setting up WebExplorer
-
- Note: IBM seems to be moving away from Web Explorer and towards
- Netscape as the standard web browser for OS/2. We are providing
- directions here for Web Explorer, but suggest that you move to
- using Netscape for OS/2. This offers several advantages to
- WebExplorer, including rendering PDF inside netscape, and
- browsing hot-links to web sites from inside PDF files. The
- latest version of Netscape can be downloaded from:
-
- http://www.internet.ibm.com/browsers/netscape/warp/
-
- If you plan to continue using WebExplorer instead of Netscape,
- drop us a note at acro4os2@adobe.com so that we can get a feel
- for the number of Acrobat users using WebExplorer.
-
-
- These are the changes that need to be made to run Acrobat Reader
- as a helper application to the IBM WebExplorer:
-
- a] Set the WebExplorer ini file (EXPLORE.INI) mailcap and
- extmap variables to the full paths of your existing or new user
- extension-map and mime type files (i.e. EXPLORE.EXT and
- EXPLORE.CAP).
- The EXPLORE.INI file can be found in your ETC directory. To
- figure out where your ETC directory is, edit your OS/2 config.sys
- file and search for ETC:
-
- E c:\config.sys (if the OS2 directory is on a different drive
- letter, use the appropriate letter).
-
- You should see a line like this:
-
- SET ETC=C:\MPTN\ETC
-
- Change to this directory to edit your EXPLORE.INI. You should
- see something like this:
-
- [advanced]
- ; advanced user settings - edit with care!
- ;
- ; mailcap= specifies full path to user mailcap file
- ; format is: mime/type; program_name params %s
- ; example: image/jpeg; jview -r %s
- ; no wildcards allowed, no piping, no unix commands
- ;mailcap=
- ; extmap= specifies full path to user extension map file
- ; format is: mime/type extension_list
-
- ; example: image/jpeg jpg jpeg jpe
- ;extmap=
-
- Edit this to look something like the following:
-
- [advanced]
- ; advanced user settings - edit with care!
- ;
- ; mailcap= specifies full path to user mailcap file
- ; format is: mime/type; program_name params %s
- ; example: image/jpeg; jview -r %s
- ; no wildcards allowed, no piping, no unix commands
- mailcap=c:\mptn\etc\EXPLORE.CAP
- ; extmap= specifies full path to user extension map file
- ; format is: mime/type extension_list
- ; example: image/jpeg jpg jpeg jpe
- extmap=c:\mptn\etc\EXPLORE.EXT
-
- If you already had existing files listed , do not change
- EXPLORE.INI, but for the next two steps, simply add the informa-
- tion to your existing files.
- (Note: Do not edit the [viewers] section of EXPLORE.INI)
-
-
- b] Modify or create your user "MIME/application map" or
- mailcap file (ie. EXPLORE.CAP). Create it in your ETC directory
- if one doesn't already exist. If it does exist, then place the
- following line into it:
-
- application/pdf; C:\ACROBAT3\READOS2\ACROREAD.EXE %s
-
-
- Modify or create your user "extension map" or extmap file (i.e.
- EXPLORE.EXT). Create it in the ETC directory if one doesn't
- already exist. If it does exist, then place the following line
- into it:
-
-
- application/pdf pdf app
-
- Note: the "app" is a bug fix for a problem in the WebExplorer.
-
- c] That's it. When you start your WebExplorer, any links to
- PDF files should activate Acrobat now.
-
- VII. Setting Up for use with Netscape for OS/2
-
- Note: If you are currently using Netscape for OS/2, you will
- need to upgrade to 2.02E Beta 2 or final code level. This will
- solve many problems that occur using Acrobat with the older version
- of Netscape. The latest Netscape can be downloaded from:
- http://www.internet.ibm.com/browsers/netscape/warp/
-
- These are the directions for installing Acrobat for use with
- Netscape version 2.02E:
-
- -Install Netscape
- -Install Acrobat
-
- That's it. Acrobat will register itself as a helper in Netscape,
- as well as copy a plugin file into the netscape "PLUGINS"
- directory.
-
- If you choose to install Netscape after Acrobat, you must copy
- the Acrobat Netscape plugin manually into the
- "C:\NETSCAPE\PLUGINS" directory. The Acrobat plugin is located
- in Acrobat's browser directory; normally:
-
- C:\ACROBAT3\READOS2\BROWSER\NPPDFOS2.DLL
-
- Copy this file into C:\NETSCAPE\PLUGINS, and you will have
- completed the installation.
-
- VIII. Known Problems
-
- There are a number of features and bug fixes yet to be incorpo-
- rated into the Acrobat Reader for OS/2. An up-to-date list can
- always be found at:
-
- http://www.adobe.com/prodindex/acrobat/knownproblems.html
-
- Below are some of the problems known for this Web release:
-
- Install Problems:
-
- -Some folks are reporting the installer hanging. We have been
- able to recreate this on Warp 4, and it stems from the
- SysCreateObject() call. If your install seems to stop making
- progress, cancel, then take the option to delete the files
- you have already copied. Reboot and try again. Our install
- program (the IBM installer) is not the only program that gets stuck
- here; trying to run any Rexx program at that point which calls
- SysCreateObject() will also result in the program hanging.
- This seems to be a problem with the Workplace shell that can only
- be fixed by rebooting.
- -If you are running 4OS2 version 2.0, you won't be able to
- execute the install program. Newer versions work correctly. To
- work around this problem, start a regular command shell by
- typing "CMD" from your 4os2 command prompt. Then do a install.
- This should work properly.
- -You can't execute the installer from a path that has spaces in
- it. This is a problem with the IBM installer.
-
- General Problems:
-
- -If you are seeing black boxes occasionally while viewing, try
- turning "Page Caching" on. This can be found in the "Preferences,
- General" menu off of the file menu.
- -Some of the shortcut keys are not implemented yet.
- -When multiple links to PDF files are opened simultaneously from
- the WebExplorer, some PDF files may be left over in the TMP
- directory after WebExplorer completes. This problem is likely to
- remain in the final version, so it is a good idea to clean out
- your "TMP" directory (as defined in config.sys) from time to
- time.
- -Custom background color is implemented for full screen viewing,
- but requires Fixpak 17 or later to work, since it uses a newer
- OS/2 custom control.
- -Printing complex PDF to non-postscript printers may require lots
- of swapper space, especially if you are using a higher resolution
- such as 600 DPI. If you plan on doing this, make sure you have
- 150Mb or more free. If you are using an HP Laserjet 4 or 5, make
- sure you have selected "Use Large Buffers" in the driver options page.
- You can find out which drive is your swapper drive by checking the
- "SWAPPATH" setting in config.sys.
-
- Printing Problems:
-
- Due to many problems with printer drivers that shipped with
- Warp version 3.0, Adobe suggests that Acrobat users update their
- OS/2 system with Fixpak 26 or later. This will solve many, if not
- all of your printer driver problems. Adobe will not support
- printing on systems that have not been brought up to this level.
- This is not to say that you won't be able to work around these
- problems without the fixpak- just that we can not support those
- configurations. In many cases, updating the printer driver and
- other systems components such as PMMERGE.DLL may work.
- Those who have upgraded to Warp version 4.0 should not
- experience any of these printing problems.
-
- -Printing to HPLaserjet 4Plus and some other HP printers may cause
- some images to print upside down., especially with Laserjet driver
- version 30.456. This is prevalent with people who are using Warp and
- have applied Fixpak 17 or later.
- This is a bug in the IBM LASERJET.DRV driver. We suggest
- using the PostScript driver with these printers.
- -If you are using the Original OMNI Driver from Warp 3.0 (version
- 30.437), this will also cause upside down printing. This is the
- driver used for HP Deskjets and many other printers. Upgrade your
- driver and you should have no trouble printing. The latest driver
- would be 30.509 or later. This is available on ftp.software.ibm.com
- and the filename is omnidrv.zip.
- -When printing to HP Laserjet printers, the default options
- should be changed for better performance. The option "HPGL/2"
- should be turned ON, and the option "Use large buffers" should
- also be turned on. This does not match the defaults.
- -Printing to a Unix printer (using lprportd) produces no output.
- -Ctrl-Ins doesn't copy selection to clipboard right now; use
- <ctrl-C> instead.
-
- Forms Problems:
-
- -If you are using forms with combo boxes, you may have trouble
- selecting an item using the mouse. To work around this, click
- on the listbox to give it focus, then select the item using the
- arrow keys.
- -You currently can't use the <Tab> key to jump between fields.
- -It sometimes takes two clicks to set an entry field active.
-
- Video Problems:
-
- -There are problems using 16 bit (65536) color video modes with
- certain video card/driver combinations. Try switching to 8 bit or
- 24 bit if you experience these problems.
- -Folks with the following video cards are experiencing trouble:
- Elsa Winner1000 cards using 1.03 drivers should be upgraded
- to 1.04 drivers (available on compuserve and elsewhere)
- Older Matrox drivers should be updated to the latest version. HP
- customers and other people using "OEM" versions of the MGA card
- should go directly to their PC manufacturer for the latest MGA
- driver; Matrox does not support those cards directly.
-