.chm-to-namespace Map File   

Has anyone managed to convert a chm file to MSHelp2 and make the mappings 
work properly?

The documentation (shown below) is pretty skimpy on this, including the 
format. Any pointers or samples would be welcome.

Ken



"Specifies the namespace to which each HTML Help 1.x compiled Help (.chm) 
file should map when converted to Microsoft Help 2.0 compiled Help (.HxS) 
files. The primary purpose of the map file is to specify the relationships 
between links within a set of compiled Help files, ensuring that 
cross-collection links are translated properly.

The map file is a standard text file, which should be saved using the .txt 
file extension. The following example shows the format to use for a map 
file.

myHelp_1.chm myNamespace/myHelp_1
myHelp_2.chm ../myHelp_2
This example shows the two ways to map a .chm to a namespace. In the first 
line, the file myHelp_1.chm is mapped to an .HxS file named myHelp_1, which 
is registered under the namespace myNamespace. This direct mapping only 
works if myNamespace is always the parent. If myNamespace is registered as a 
child of another namespace, all mappings will be broken.

In the second line, the file myHelp_2.chm is mapped to an .HxS file named 
myHelp_2 using relative mapping. Relative mapping is more general, and 
always finds the sibling collection with the specified ID (in this example, 
myHelp_2) relative to the current .HxS file. Because of this, relative 
mapping is recommended in most cases."

date: Tue, 7 Jun 2005 14:58:01 -0400   author:   Ken Cox [Microsoft MVP]