Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

> 8 Generating WinHelp > 8.12 Configuring index entries for WinHelp > 8.12.2 Eliminating duplicate keywords

### 8.12.2 Eliminating duplicate keywords

When a first-level index entry has second-level entries under it, to avoid repeats of the same topic, set DisambiguateIndex=Topic:

[HelpOptions]

; DisambiguateIndex = Yes (default, always write first-level keys),

; Strip (no first-level keys), Topic (only write first instance of

; a first-level key in each topic), No (only write first in doc)

DisambiguateIndex=Topic

The DisambiguateIndex options work as follows:

Topic | Prevents duplication by suppressing repeated index markers within a topic. When you have the same index marker in two or more places, and pick that item in the WinHelp index, you get a dialog with a list of all the places the item is referenced. If the same marker occurs twice in the same topic, you get two identical entries for that topic in the dialog list.
Yes | Prevents duplication by eliminating repeated first-level headings in the file (not just in the topic). When you have second-level topics under the same first-level topic, and you click the first-level heading, you get duplication. You need only one of the first-level headings in the file to make the index work right (avoiding a WinHelp defect).
No | Generates a first-level heading only for the first of its second-level topics.
Strip | Eliminates generated first-level headings, so that only explicit headings remain.