Merging HelpSets
I would like to be able to load components that
have their own help, and on loading merge the
help sets, so that help for all loaded components
appears in the one browser window, both in the
contents, the index, and the search pane.
It appears I should be able to do this, however
I am unsure. The merge demo, that comes with
the JavaHelp distribution, pops up separate viewers
for each help set, and the source code has some
comment about merge functionality being broken.
So, I guess the question I'm asking is, should I
be able to do what I want? How? Is it as simple
as just calling HelpSet.merge() ?
Regards,
Tom Haywood
I have recently successfully constructed a helpset that merges two different helpsets. I used the information available in the documentation. Look in the JavaHelp system users guide. (I have a PDF file I'm looking at; it says JavaHelp1.1 November 1999 at the top.) In the section called "Merging Helpsets" (starts on p. 130 in my PDF file), it describes how to do this. I started out by creating a "Dataless Master HelpSet" as described starting at the bottom of p. 131. What it says there worked for me, EXCEPT that I did have to create a dummy map file. One thing I had to remind myself of, after messing it up at first, is that the <name> tags in each corresponding <view> must match for the merge function to truly merge info in the navigation pane. For instance, TOC1 and TOC2 need only be specified in the <data> tag; if you distinguish them in the <name> tag, they don't get merged together.
Hope this helps....