MAKEHM: Utility for Associating Resources with Help Contexts

Click to open or copy the MAKEHM project files.

MAKEHM is a console application that produces a mapping between resource identifications and Help contexts. The sources are provided for MAKEHM to serve as an illustration of a console application that uses the Microsoft Foundation Class Library (MFC), and to enable you to modify the tool.

A console application such as MAKEHM is linked with the same variant of the MFC library as GUI (graphical user interface) applications.

Normally, you do not need to run MAKEHM directly. Custom build rules on the resource.h file will determine when it is run. For Visual C++ 6, a MAKEHELP.BAT will be provided for backward compatibility with projects from older versions.

The command line syntax to run MAKEHM directly is:

makehm <from>,<to>,<add> [<from>, <to>,<add> [...]] <resource.h> >> [output.hm]

<from>

Specifies the symbol prefix to be read, such as a command ID.

<to>

Specifies the symbol prefix of the Help context identification to be produced in the .hm file.

<add>

The Help ID base number to be added to the value of the <from> identification to produce the Help context number.

You can specify one or more sets of <from>,<to>,<add> in the command line.

<resource.h>

The header file that provides #define definitions for the symbols to be read.

<output.hm>

The .hm file to be produced by MAKEHM.

Look at the custom build rules for the resource.h file (or a Makehelp.bat file produced by AppWizard) to learn what command line values to use.

This sample demonstrates the following keywords:

AfxThrowMemoryException; CFile::Close; CFile::GetPosition; CFile::Open; CFile::Seek; CStdioFile::ReadString; CStdioFile::WriteString; CString::GetBuffer; CString::GetLength; CString::IsEmpty; CString::ReleaseBuffer; CString::Right; __iscsym; __iscsymf; _strdup; exit; fprintf; free; isdigit; isxdigit; sprintf; strchr; strcmp; strlen; strncmp; strstr; strtok