Updating aliases

Update aliases when the following situations occur:

To update an alias:

Note: If you are using BugHunter to test aliases, right-click the map number and select Update Alias to open the dialog. By default, the topic ID and map number are automatically selected.

  1. Click the Project tab.

  2. From the File menu, select Aliases. The Edit Map IDs dialog opens.

  3. From Map File, click and select the map file that includes the topic ID used with the alias. All topic IDs and map numbers are listed below it.

  1. Select the topic ID you need to update from the list.

  1. From the Topic list, select the correct window-level topic to match to the topic ID.

  2. Click Assign. The topic ID and HTML file are matched and the alias is updated (or created) in the .ALI file.

  3. Repeat steps 3 - 6 for each alias you need to update.

  4. Compile your project to update the .CHM file and test the window-level Help topics with the application.

 

Tips:

  • You can change existing map numbers by editing the text in Map #. The program updates the .H file so it uses the new number. For auto-generated map numbers, as you type the topic ID, a number is assigned in the Map # field. You can replace the number with any number you prefer.

  • If the map file was removed from the project, the window-level Help topics are matched to topic IDs and map numbers that no longer exist. The alias file includes the topic ID/window-level match, but the context-sensitive Help will not work in the application. This is known as an orphaned alias and you can remove it from the project. You can also restore the alias by replacing the map file with a new copy that includes the original topic IDs and map numbers. For more information, see Removing orphaned aliases.