Compile Windows Help During a Build (Windows)

On Windows, you can use the Windows Help Compiler, hcw, to create Windows help (.hlp) files. The Windows Help Compiler takes as input a help project (.hpj) file that lists the rich text format (.rtf) and other files from which the help compiler creates Windows help files. You can run the the Windows Help Compiler as a build extension during a build.

To run the help compiler during a build, simply list help project files as a source files for the build. If these files have the file extension .hpj, the build process recognizes them as hcw project files. If they have any other file extensions, you must explicitly specify that their type is hcw. The build process runs hcw for each help project file for which the resulting help file does not exist or has an earlier date than the project file. It also runs hcw if the hcw project file or any of or rich text format files named have changed since the last build.

You can apply the following option to help project files.

The following hcw options are set by default:

For example, the following lines from a configuration file build a help file from a help project file called project.hpj:

option hcw_opt("/N") {
source "project.hpj"
}

The lines above have the same effect as entering the following on the command line:

hcw /M /C /E /N project.hpj

To work within the Window help compiler, run the hcw program from the VisualAge C++ command line window.



Configuration Files
Build Extensions and Specification (.ice) Files


Add or Change Source Files
Override the Default Type of a Source File
Bind Message Files to the Executable Target of a Build
Compile and Bind Resources
Use Resource Sources Files as Sources for a Build
Set Build Options
Build


Build Extensions Supplied with VisualAge C++
The Make Message File Utility