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:
![[spacer]](1p.gif)
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.
|
