OS/2 Shareware BBS: 5 Edit

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / os2rd3b2.exe / read.me < prev

Wrap

Text File | 1996-12-19 | 23KB | 439 lines

============================================================== 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.