To Copy the Help4Help Source Files

1. Copy the entire /usr/dt/dthelp/help4help/C directory to a new working directory (new-dir) using a command like this:

    cp -r /usr/dt/dthelp/help4help/C new-dir 
   

   This creates new-dir and copies all the files and directories into it.

2. To permit editing the files (which are copied as read only), change the permissions using a command like this:

    chmod -R u+w new-dir 
   

   The Help4Help volume uses these HelpTag source files:

   • MetaInfo

   • Toc

   • Tasks

   • HomeTopic

   • Concepts

   • Reference

   • Glossary

   Also included is a control directory, where you run HelpTag to create the run-time help file. Graphics are stored in the control/graphics subdirectory.

   Be sure to rename the Help4Help.htg file before running HelpTag. Your help on help volume should have a unique name to prevent conflicts with other help on help volumes.

Example

The following commands create a copy of the help on help volume and make its files writable. (Presumably the projects subdirectory already exists.)

cp -r /usr/dt/dthelp/help4help/C /users/dex/projects/NewHelp4Help
 chmod -R u+w /users/dex/projects/NewHelp4Help

To build a new version of the run-time help files, first ensure that the directory /usr/dt/bin is in your search path. Then, change to the new directory, rename the Help4Help.htg file, and run HelpTag:

cd /users/dex/projects/NewHelp4Help
mv Help4Help.htg NewH4H.htg
 dthelptag NewH4H

When the HelpTag software is done, you can display the new help on help volume using this command:

dthelpview -helpVolume NewH4H