Win Help Translation (Converting RTF files to IPF)

The SMART Windows to OS/2 Help Translator Conversion utility (SMARTHLP.EXE) provides conversion
of Windows help files to OS/2 help files.  This utility can be executed from SMART through the interface dialog
panel associated with "Translate Win Help..." under the "Resources" menu item or can be run from a
command line or embedded in a batch command file. 

Follow these steps to convert a Windows RTF (Rich Text Format) file to an OS/2 help file.

1.  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 located in ..SMARTAUX\SAMPLE.HPJ.
2.  To access the the Win Help Translator dialog panel, choose "Resources" from the SMART
main dialog panel.   From the Resources pulldown choose "Translate Win Help". 
3.  On the Win Help Translator dialog panel, enter the name (including path) of the HPJ
file in the "Input Filename" field.
4.  Choose the rest of the options as they apply.    Generally, most of the options will
be needed.
5.  If the output will be used by an application, choose "Output .HLP file".  If the output
will be independent, like a "users' reference", choose "Ouput .INF file".  To view the 
output, create a .INF file and use the VIEW command (in OS/2).
6.  Another useful option is "Send Error file to Editor".  Then, errors can be viewed.
7.  When all options have been chosen, press "ok".
8.  SMART does not display a status on the conversion process for a HELP document.  If
the "Send Error File to Editor" option is chosen, then the process will be complete
when the error file is displayed.   Otherwise, watch the OS/2 window in the backgound
to ensure that the Help conversion process is complete. 
9.   Output from the Help conversion will depend on the options chosen.   If nothing was
entered in the "Output Filename" the file will be written to the same directory 
as the input file.
10.  Unless the "Convert to IPF Only" option is chosen, the IPF file produced by SMART will
automatically be sent to the IPF compiler.   In that case, an INF or HLP file will be 
produced (depending on the option chosen).   If the "Convert to IPF Only" option IS chosen,
only the IPF file will be produced and will not be compiled. 

Note:  Error messages are explained in the online help.   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 the IPF compiler (IPFC.EXE) is required for SMART Win Help translation.
IPF (Information Processing Facility) is available from the IBM Devolopers Toolkit.

Nothing special is needed to convert National Language Support (NLS) files from RTF to IPF as long 
the language is covered by the 850 codepage.   If the language is not covered by the 850 codepage,
change the code page parameters on the Win Help Translation dialog panel.
