WinHelp Redirect Builder ======================== 15jul03 Builds a WinHelp RTF file (REDIRECTS.RTF) from a list (TXT file), where each "topic" is a redirect to another topic. The RTF file is built by reading a list of the following format .. =[@[>]] For example, the following list creates an RTF file with three topics .. TOPIC1=TOPIC-ONE@HELP1.HLP TOPIC2=TOPIC-TWO@HELP1.HLP TOPIC3=TOPIC-THREE@HELP1.HLP Each of these topics will be a redirect to the specified file and topic. Basically, if you have a merged set of HLP files and want to be able to access topics in other files from the master HLP, create the list and run the Perl script. Then include the REDIRECTS.RTF file in your Help project and recompile. You can run the script by double-clicking it in Windows Explorer (you will be prompted to provide the redirect list name), or by entering the filename and redirect list at a DOS prompt, as follows .. WH-REDIRECT-BUILDER.PL REDIRECT-LIST.TXT This tool is a Perl script and thus requires that Perl is installed on your computer. For Windows systems you can get Perl from ActiveState (http://activestate.com/Products/ActivePerl/). Once you have Perl installed on your computer, you should be able to run it by double- clicking the PL file from Windows Explorer. The ZIP file consists of the following files: WH-REDIRECT-BUILDER.PL - The Perl script. WH-REDIRECT-BUILDER.TXT - The documentation (this file). The following is the basic procedure for using this tool: 1. Copy the contents of the ZIP file to a folder in your file system. It doesn't really matter where as long as it's convenient for you. 2. Make your "redirect list" file using Notepad or some other text editor. Put this file in the same folder as the Perl script. 3. Double-click the Perl script, and at the prompt enter the name of the redirect list. 4. If everything was successful, you will now have a REDIRECTS.RTF file. Add this file name to your HPJ file and compile your WinHelp project. You can test to see if your redirects are working by entering the following at a DOS prompt .. winhlp32 -I .HLP Where is the ID of the redirect topic, and is the HLP file that contains the redirect. Although this script is free to use, rather than passing it around, I would appreciate if new users could download it from the site. This way I have an idea of how many people are using it and can contact those people if there is an update. Please direct people to the following URL: http://www.leximation.com/downloads/wh-redirect/ If you run into any problems, have any questions, or would like to suggest any improvements, please email Enjoy! ...scott *************************** DISCLAIMER *********************************** This tool is currently offered as "freeware." Neither Leximation, Inc., nor affiliated persons, accept liability for any problems that may occur from the use of this tool. **************************************************************************