IBM Advanced Linguistic Search Plug-in for Adobe version 1.3.0 for Windows (IBMALS 1.3.0) Installation Instructions & Version Notes (README) Driver Level Last Updated: 2007/10/12 (C) Copyright IBM Corp. 1989, 2006. All rights reserved. ----------------------------------------------------------- This version (1.3.0) is intended for use with Adobe Reader/Acrobat version 7.x, not 8.x. It is recommended that you use the next version of IBMALS (ie. Version 1.4.0) for Adobe Reader/Acrobat version 8.x. Please access: http://www-306.ibm.com/software/applications/office/bkmgr/adobeplugin.html This README file (available in English only) contains the information you need to install and configure IBM Advanced Linguistic Search Plug-in for Adobe. The information is divided into the following categories: - Prerequisites - Installation of IBM Advanced Linguistic Search Plug-in for Adobe - Running the Programs / Viewing the Documentation - Uninstalling - Version Notes - Limitations - Getting Help with BookManager Products - Trademarks ----------------------------------------------------------- PREREQUISITES ----------------------------------------------------------- Software Prerequisites ---------------------- One of the following operating systems: · Microsoft Windows 2000 or XP One of the following Adobe products: · Adobe Reader (free) Version 7.0.5, 7.0.9 · Adobe Acrobat Professional Version 7.0.5, 7.0.9 · Adobe Acrobat Standard Version 7.0.5, 7.0.9 Note: The 7.0.5 version of Adobe Reader cannot run on operating systems earlier than Windows 2000 with Service Pack 2. Windows NT support was not available in Adobe Reader 7.0.0, but is available for Adobe Reader 7.0.5 (and 7.0.9) Hardware Prerequisites ---------------------- · Any personal computer capable of running Windows 2000 or XP with Intel® Pentium®II (or higher), or compatible processor, with a minimum of 256MB RAM · Display device supported by Windows 2000 or XP (VGA or better resolution) · Any pointing device supported by Windows 2000 or XP. · Hard-disk drive storage of 6MB for final installed image (Note: A total of 8MB free disk space is required to run the install program.) ----------------------------------------------------------- INSTALLATION OF ADVANCED LINGUISTIC SEARCH PLUG-IN FOR ADOBE ----------------------------------------------------------- Download and Install From the IBM BookManager pages on ibm.com: --------------------------------------------------------------- 1. Start the Windows system. 2. Open your Web browser to the following IBM BookManager page on ibm.com: http://www.ibm.com/software/applications/office/bkmgr/adobeplugin.html 3. Click on the link to download "Advanced Linguistic Search Plug-in for Adobe" and on the resulting page, pick the FTP link to download installation file 7xhclxinst.exe 4. After accepting the terms and conditions, select a drive and folder on your system in which to download the file and click Save. 5. Click on the Windows "Start" button. The Start menu should appear. 6. Select the "Run" option. The Run window should appear. 7. In the Run window, click on "Browse". When the Browse window opens, select the drive and folder you specified in Step 4 to save the file, then highlight the 7xhclxinst.exe file and click Open. The correct path to the 7xhclxinst.exe file should be displayed in the Run window. 8. Click on OK. 9. Follow the instructions in the Installation window. 10.During installation, you will be asked to select the Adobe products for which to install the plug-in. 11.When installation is complete, you can start using the IBM Advanced Linguistic Search Plug-in for Adobe by launching a PDF in your Adobe product and clicking the magnifying glass icon that appears on the Adobe product's icon bar at the top of the screen. Note that the plug-in functionality can only be fully exploited for PDFs that have been indexed by the IBM Document Indexer tool. ----------------------------------------------------------- RUNNING THE PROGRAMS / VIEWING THE DOCUMENTATION ----------------------------------------------------------- Once installed, the IBM Advanced Linguistics Search Plug-in for Adobe is started whenever you start your Adobe product, either as a stand-alone application or within a web browser. Web browser usage may occur when the Adobe product is is launched by the Shelf Search Results PDF link produced by the web-based IBM Library Server product To use the plug-in, either click on the magnifying glass icon in the icon bar at the top of the window, or select Edit->IBM Advanced Linguistic Search from the menu bar. The IBM Advanced Linguistics Search Plug-in is fully functional only with PDFs indexed with the IBM Document Indexer tool. ----------------------------------------------------------- UNINSTALLING ----------------------------------------------------------- To uninstall, use "Add/Remove Programs" from the Control Panel of Windows. ----------------------------------------------------------- VERSION NOTES ----------------------------------------------------------- These are the enhancements for Version 1.3.0 of the IBM Advanced Linguistic Search Plug-in for Adobe, organized by driver levels: ALS_20060814 . support for launching via the SoftCopy Reader (SCR) version 3.6 (SCRV3_081506) Known Problems: . In some instances ALS will not be able to accurately determine the location of the Topic on the Page, consequently it will display the full page. ref. Adobe Wordfinder Bug concatenated words (Defect 3399) ref. Fails to find search term in figure (Defect 3434) ref. Fail to locate srch term delimited with u'scores (Defect 3435) ref. Fails to find Topic Title prefixed with a '&' (Defect 3436) ref. Topic Titles with Overscore not recognized. (Defect 3438) ref. Fails to find next topic title (==end of topic) (Defect 3439) ref. Topic Titles with embedded punctuation, not recog. (Defect 3440) ref. Figure Data adversely affect Topic Location (Defect 3441) ref. Scroll alignment for some topics (Defect 3442) ref. Header mistaken for Topic Title (Defect 3446) . Pageup/PageDown keys do not work within the Search (results) list ref. Pgup/PgDwn Search Results (Defect 3370) . Search terms containing the '<' character will produce anomalous results. For example "Test" will be treated as a search for "Test<" and "EndTag>" ref. Search terms containing '<' (Defect 3395) . When in a 'stand-alone' configuration (ie. Not inside a Web Browser page), excessively long Topic titles displayed in the Results Dialog may require more than one 'click' in order to be selected. ref. Results Dlg. Long entries need two clicks (Defect 3430) . Search terms that are terminated by a colon cannot be found. ref. Fails to find search terms terminated with colon (Defect 3433) . In order to 'paste' Search Terms into the 'Search Term:' box, you must use the Mouse Right button, to activate the edit drop-down menu, and select 'Paste'. ref. Default 'paste' operation does not work in Srch Win (Defect 3453) . The Scroll Arrows in the Search Results dialog and in the Page Display window do not respond to the normal 'continuous-scroll' operation (ie. keeping the button depressed). However, clicking above or below the scroll 'handle', does result in the normal page-up and page-down actions . PDF files do not clearly differentiate between words that appear in the body of the text, and words that appear in the page header and/or footer. Consequently the search will produce false hits if a search term is present in the page header or footer. . Occasionally Reader (and Acrobat) will appear to be unresponsive, and the user will be obliged to wait until the Reader regains focus. .............................................................. ALSP_09252005 - Initial beta release. ALSP_20051212 version 1.1.0 . IBMALS is now able to differentiate between Topics with identical titles. ref. (Defect 3363) . The use of Boolean Characters in search terms (as per the Library Server Search) is now supported. ref. (Defect 3365) . Search hits in neighboring topics are now highlighted correctly. ref. (Defect 3366) . Trailing whitespace (spaces, carriage-returns, etc.) are now automatically removed from search terms. ref. (Defect 3368) . Scrolling to the Title of the topic containing the search hits has been considerably improved. ALS_20060405 version 1.2.0 . Long entries (ie Topic Titles) in the Results dialog are truncated, when the cursor (mouse) passes over such entries the full text appears in a 'fly-over box'. When Acrobat is running inside a browser page, this behavior was interpreted as a 'select' and consequently the indicated Topic was displayed. This behavior has been corrected (however, see Defect 3430 in 'Known Problems') ref. Results Dialog -- Mouse-flyover (Defect 3364) . When in stand-alone, you could kill the results dialog, and any subsequent 'entry and search' from the Search dialog would result in a new Results dialog being created. When running in a browser window, this behavior was not seen. This behavior has been corrected, the search dialog can now be 're-used' ref. Reuse of Results dialog fails in Browser (Defect 3367) . In some instances ALS was not be able to accurately determine the location of the Topic on the Page, consequently it displayed the full page. This behavior is caused by a number of processing errors, the following have been corrected: ref. Topic titles with mixed emdash, endash, hyphen (Defect 3394) ref. Revision Bar in Topic Title (Defect 3397) ref. Hyphen with spaces in Topic Title (Defect 3398) ref. Fails to recognize/process (R) in Topic Title (Defect 3401) ref. Topic Title contain 'C++' not recognized (Defect 3402) ref. U'scores in Topic Title not recognized (Defect 3448) . Some search operations (from within a Web Browser) were adversely affected by the processing of 'special' characters. These failings have now been rectified. ref. c?t does not work in browser mode (Defect 3400) ref. Hexed chars (eg %26) stripped from PDF URL (Defect 3413) . Internal processing errors would sometimes result in the message "Could not locate the topic in the PDF Outline tree" being displayed. These errors have now been addressed. ref. Fails to find valid Topic in Outline Tree (Defect 3403) ref. Need test for "End of topic title" (Defect 3407) ref. Fails to find end of last topic in outline tree (Defect 3408) ref. Topic parent of "1.0" not recognized (Defect 3420) . If, when working in a Browser Session, the Results dialog was minimized, then further use of IBMALS was not possible. This behavior has now been corrected. ref. IBMALS cannot be reused during an LS session (Defect 3414) . There was no on-line help for the IBMALS search. The search methodology and the options available to the user, are identical to those in the LibraryServer. Therefore IBMALS now uses the appropriate section from the LibraryServer "Getting Started" document ref. Add Help -- pntr to LS GetStart, Srch a Doc (Defect 3416) ref. Add 'Help' button to Search Dialog (Defect 3470) . PDFs produced from applications other than Adobe Distiller, sometimes use 'unusual' methods to construct the document. These resulted in PDFs that could not be fully exploited by IBMALS. The analysis and processing capabilities of IBMALS have now been improved to cover these differences in document architecture. ref. Fails to find topics in 'brochures' (Defect 3449) ref. Fails to process all forms of page ref. (Defect 3450) ----------------------------------------------------------- LIMITATIONS ----------------------------------------------------------- * The IBM Advanced Linguistics Search will only work with PDFs indexed with the IBM Document Indexer tool. This version (1.3.0) is intended for use with Adobe Reader/Acrobat version 7.x, not 8.x ref. Adobe Document 331246 In Acrobat 7.0 and Adobe Reader 7.0, the 'Display PDF In Browser' preference does not behave as expected. Normally, selecting a Topic from the 'Search Results' dialog will result in scrolling of the appropriate page to place the topic title at the top of the display. In the event that the first 'hit' is not on the page containing the Topic Title, the full page (containing the hit) will be displayed. ----------------------------------------------------------- UPDATES ----------------------------------------------------------- For updates to this plug-in, please periodically visit the BookManager web pages for the Advanced Linguistic Search Plug-in for Adobe at: http://www.ibm.com/software/applications/office/bkmgr/adobeplugin.html ----------------------------------------------------------- GETTING HELP WITH BOOKMANAGER PRODUCTS ----------------------------------------------------------- This section contains information on how to obtain support and the latest corrective service for BookManager products. We recommend you obtain and apply the latest available service from the ibm.com website at installation time. Both electronic and telephone support are available. ELECTRONIC SUPPORT ------------------ Electronic support is available via Internet, Web, and FTP. This support covers: - Hints & Tips - Most Frequently Asked Questions & Answers - Fixes (for some BookManager products) Internet -------- Email: bookmgr@us.ibm.com Web: BookManager Home Page - Take the Support link: http://www.ibm.com/software/applications/office/bkmgr/ IBM Personal Systems Service & Support Home Page: http://ps.software.ibm.com/ FTP: FTP to ps.boulder.ibm.com logon anonymous use your email as your password change directory to /ps/products/bookmanager ----------------------------------------------------------- TRADEMARKS ----------------------------------------------------------- The following are trademarks of the IBM Corporation: - IBM - BookManager The following are trademarks of the Microsoft Corporation: - Microsoft - Windows - Windows XP - Windows 2000 The following are trademarks of the Adobe Systems Incorporated: - Adobe - Acrobat - Reader - Adobe Acrobat - Adobe Reader All other product names are trademarks of their respective owners. ----------------------------------------------------------- - End of 7xhclxread.txt file - -----------------------------------------------------------