TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: followup to RoboHELP question From:Scott Miller <smiller -at- CORP -dot- PORTAL -dot- COM> Date:Fri, 24 Oct 1997 12:37:44 -0700
>>>>>>>>
>Has anyone ever had to use the programmer's map file to link to a help
>file? (I'm on hold with BlueSky as we speak....) Is this a lot of work?
><<<<<<<<
>
>For the first time, I'm using the programmer's map file to link help. It's a
>weird way to work, but effective. Some important points:
>
>- The programmer's map file has the suffix "HM." This doesn't affect
>anything. I've seen map files with suffixes H, HM, and HH.
>
>- The programmer's map file can change. Then your help can be broken. This
>usually occurs when more than one developer is working on a project, and they
>assign a number that is already assigned. Apparently, this is no problem for
>the program's code, but it can be deadly for context-sensitive help. In my
>case,map numbers originate in a file called "resource.h." This is where you
>will find duplicate entries.
>
>- The programmer's map file includes all sorts of contexts that may or may
>not require a help topic. This means that pressing F1 just about anywhere in
>the program will display help, but if you haven't hooked up help to a
>control, an error message is displayed. Many of these controls are unknown,
>for example, how can you tell what the context is for something like
>"HIDD_FWEEBLE_DISLOCATOR?" In some cases, as a last resort, you can use an
>alias to map unknown contexts to a single "No help available on this item"
>topic.
>
>Scott Miller
>smiller -at- portal -dot- com
>
>