Migrating Windows Help Files

You can use either SMART or Hyperwise Lite to migrate Windows 32-bit help files to OS/2 help files. See the Hyperwise Lite documentation for information on using Hyperwise Lite to migrate help files.

Follow these steps use SMART to convert a Windows rich text format (RTF) file to an OS/2 help (IPF) file:

• On the SMART2 Source Migration window, go to the Resources pull-down. Select Translate Win Help.

• SMART displays the Select Help Input Filename dialog. Create an HPJ file that contains the name of the RTF file to be converted along with any bitmap names that are needed.

  A sample HPJ file is:

  ..SMARTAUX\SAMPLE.HPJ
  

  

• SMART displays the Win Help Translator dialog. Enter the name, including the path, of the HPJ file in the Input Filename entry field.

  Choose the rest of the options as they apply. Generally, you will need to use most of the options. These are some of the options you might choose:

  • Check the Send error file to editor check box so that SMART logs the status information.

  • If the output will be used by an application, choose Output .HLP file.

  • If the output will be independent, like a users' reference, choose Output .INF file.

  • To view the output, create an INF file. Use the OS/2 VIEW command to view the INF file.

  • Unless you choose the Convert to IPF Only option, SMART will produce the IPF file and automatically send it to the IPF compiler. In that case, SMART will produce an INF or HLP file (depending on which option you choose). If you choose the Convert to IPF Only option, SMART produces the IPF file, but does not compile it.
  When you choose all the options you need, click on the Ok push button.

SMARTdoesnotdisplayastatusontheconversionprocessforaHELPdocument .IfyouchoosetheSendErrorFiletoEditoroption ,thentheprocesswillbecompletewhenSMARTdisplaystheerrorfile .Otherwise ,watchtheOS / 2windowinthebackgroundtoensurethattheHelpconversionprocessiscomplete .

OutputfromtheHelpconversionwilldependonwhichoptionsyouchoose .IfyoudidnotenteranythingintheOutputFilenameentryfield ,SMARTwritesthefilewilltothesamedirectoryastheinputfile .

Note: The online help explains the error messages. To view the error message explanations, choose HELP from the Win Help Translator dialog panel. Then choose Win Help Translator Topics. After that, choose Win Help Translator Messages.

Please note that you must have the IPF compiler (IPFC.EXE) for SMART Win Help translation. Information Presentation Facility (IPF) is available from the IBM Developer's Toolkit.