bugUnofficial CHM Specification - Bugs: bug #32593, second name parameter for the HHK...


bug #32593: second name parameter for the HHK file

Submitted by:  Paul Wise <pabs>
Submitted on:  Fri 25 Feb 2011 05:18:16 AM UTC  
Category:  None Severity:  3 - Normal
Item Group:  None Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open

Add a New Comment (Rich Markup)

You are not logged in

Please log in, so followups can be emailed to you.


Fri 25 Feb 2011 05:18:16 AM UTC, original submission:  

I was looking at your documented CHMspec pages a while ago.
Specifically, the page located at:

I was looking at the pages in response to a message containing a plea for help asking about the second name parameter for the CHM .HHK file.
As there seems to be nothing that really documents this and your pages seem to be the sole repository, I wondered if my response might be helpful in some way.

Here is what I replied with on HATT moments ago:

I cannot tell you what Microsoft may call the second name parameter, but I can tell you what it controls.

When you compile a CHM and are creating Index entries you establish relationships between each term or phrase the user sees in the list of terms and whatever topics are associated with each term or phrase.

So the first Name parameter stores what appears in the list of terms.

As the user finds interesting terms or phrases and clicks them, one of two things occurs, depending on the configuration of the Index.

If the term or phrase is associated to a single topic, the topic appears in the topic pane of the CHM viewer.
If the term or phrase is associated with multiple topics, a pop up list of potential topics is presented. In this case, what is configured in the second Name parameter is presented to the user. When clicked, its associated topic appears in the topic pane of the CHM viewer.

Note that if you have perhaps four CHM topics associated with a specific term or phrase, you will then see five Name parameters listed. Each additional parameter is also followed by a "Local" parameter that lists the path and file name to the associated topic.

Cheers... Rick :)

Paul Wise <pabs>
Project Administrator


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by pabs (Submitted the item)
  • -email is unavailable- added by pabs (submitter)

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.




    Follows 1 latest change.

    Date Changed by Updated Field Previous Value => Replaced by
    2011-02-25 pabs Carbon-Copy- => Added rick stone <rstone75@kc.rr.com>

    Back to the top

    Powered by Savane 3.6