# Using the Merge Demo

This merge demo is included to demonstrate the merge capabilities of JavaHelp.

## How Merging Works

When helpsets are merged there is allways a master helpset into which other helpsets are merged. Constituent helpsets can be dynamically removed from the merged helpset, even while the merged helpset is displayed.

In addition, a helpset file can use the `<subhelpset>` tag to statically include helpsets. This behavior has same result as if you had added the subhelpset to the enclosing helpset, except that if the subhelpsetfile does not exist, it is ignored.

## The Demo Program

This demo enables you to add helpsets to the master helpset, remove constituent helpsets from the merged helpset, and display master and slave views. The View command shows master and slave navigators, enabling you to see each helpset as it existed before the merge. The views are updated each time you merge or delete a helpset.

Running the merge demo

- When you run the merge demo without parameters, `Animals.hs` is used as the master helpset.
- To merge a helpset, choose Add from the helpset menu, and then choose the helpset that you want to merge into the master helpset
- To see the helpsets as they existed before the merge, choose View to show the master and slave views.
- To remove last helpset merged, choose Helpset > Remove.

### Notes:

- The View command can display the master and slave view only if at least one helpset has been merged.
- You can define the master helpset by setting its `.hs` file as the first command-line argument of the merge demo application startup command.
- The source file for this demo is at the following location:

        demos\src\sunw\demo\merge\Merge.java