263
USING ROBOHELP HTML 9
Context-sensitive Help
Last updated 12/14/2011
Maintaining text-only topics (Microsoft HTML Help
projects)
When changes are made to the application, update your text-only topics to reflect these changes. (If you use What's
This? Help Composer, most of these maintenance issues apply.)
Changes in the application affect the following:
•
The map files used in your project.
•
The content in your text-only topics that explain how to use the application's features.
•
The text-only topic files (.TXT) you create for What's This? Help.
Problem
The wrong topic or no topic appears.
Error message
No message
or
Command: HH_TP_HELP_WM_HELP?HH_TP_HELP_CONTEXT_MENU
Processing: Project_Name.chm
Control ID: 1174
Help ID: 1003
File: Folder_Name/FileName.TXT
Cause
A map number in the map file is missing its matching topic ID.
or
A topic ID is matched to the wrong topic.
Resolution
If the problem is caused by a missing topic ID, correct the map file.
If the developer supplies the map file, update the map file.
For an auto-generated map file: Open the Context-Sensitive Text-Only Topics dialog box. Select the
map number. Enter the topic ID. Click Add/Update.
If the problem is caused by a topic ID matched to the wrong topic, remove the text-only topic. Create
one for the topic ID.
Compile the project. Retest using the updated CHM file.
Type of Change
Action
Obsolete features (dialog boxes, message boxes, and windows are
removed from the application).
Remove the text-only topics from the text-only files (.txt).
Updated and improved features (a dialog box is changed to
include new controls, some fields are removed).
Edit the content of the text-only topics so they accurately explain
how to use the features or if fields were removed from dialog
boxes.
New features (for example, new dialog boxes are added).
Create new text-only topics.
New map files (for new features).
Import the map files into the project before creating the text-only
topics.
Updated map files (for new or existing features).
Update the existing map file by removing the obsolete map file
and importing the updated one.