8.4.2 Specifying cross-reference destination files
If all your cross references are to sources within the same .hlp file, Mif2Go can process them without further information from you. If you have cross references to other files, you must specify into which .hlp files the original source files will be placed.
When all source files are going into the same .hlp file, you can use a one-step setting:
When you create multiple interlinked .hlp files, you must specify a mapping for each external file name that is specified in the helpset (but not in the current .hlp file) to the name of the .hlp file that contains the corresponding topic. You must insert this information in the configuration file for each helpset in the interlinked group of helpsets. Do not include paths or file extensions. For example:
; file name in xref = file name for .hlp
Mif2Go checks [HelpXrefFiles] for each cross reference to another file; if the file name is not listed, Mif2Go retains the original file name. Therefore, it is important to list the names of all source files included in each .hlp file.
What this does is cause the .hlp file name to be added to any links that reference the other files named. You do not need the mappings for the files going into the .hlp file you are constructing, because those do not require the extra information. You do need the mapping for files outside the .hlp file you are currently constructing. However, having the entire set present for all files is harmless.
If you are merging multiple help files into a set, also consider contents entries; see §8.13.2.5 Referencing multiple help files from contents.
> 8 Generating WinHelp > 8.4 Converting cross references > 8.4.2 Specifying cross-reference destination files