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.
|
> 8 Generating WinHelp > 8.12 Configuring index entries for WinHelp > 8.12.2 Eliminating duplicate keywords