Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 8 Generating WinHelp > 8.4 Converting cross references > 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.