BugHunter tool

I have RH 9, so can't speak for RH10, but for RH 9 x64 anyway, I think it partially sort of works. I mean, I got it to do something, but I don't know if it's quite working the way it should.

Plus, it's hard to know, because the RH help needs more info on how to use this tool. Here's what I tried doing:

I run it from the View | Pods submenu. - CHECK

The message in the BugHunter tab says says to enable it, I have to select the Tools menu and choose Enable BugHunter. It now says "BugHunter Enabled..." - CHECK

But then what? Do I just use any application as usual and press F1 and it intercepts the call?

Being confused on this point, I naturally go to the Help on BugHunter

http://help.adobe.com/en_US/RoboHelp/9.0/RoboHTML/WS5b3ccc516d4fbf351e63e3d11aff59c571-7fe0.html#WS5b3ccc516d4fbf351e63e3d11aff59c571-7fdb

and view this subtopic "Test with BugHutner for HTML Help"

It says...

"Note: Microsoft HTML Help projects only." - CHECK.

It also says...

"Note: Before you start using BugHunter, you must launch Html Help Workshop once. To launch Html Help Workshop, double-click the hhw.exe file in the Html Help Workshop install folder." - CONFUSION

Hmmm. Okay. So I do a search on my C:\ drive for hhw.exe, but the search can't find it. I then figure I have to install it. I download and install the Html Help Workshop from Microsoft to the default C:\program files (x86)\ location. (By the way, Windows said a newer version was already installed.)

Anyway, I try to run the Html Help Workshop (hhw.exe) once per the instructions. But it don't open if I have BugHunter Enabled. So, I disable BugHunter and run it. Then try to re-enable BugHunter. I get this message:

"HTML Help BugHunter cannot be enabled while the Microsoft HTML Help Workshop is running."

Curious, because clearly the RH help file told me to run it first. But I dutifully close down the workshop and re-enable BugHunter. Perhaps what I did was sufficient?

Going back to the BugHunter help...

"To start capturing data, right-click inside the pane and select Enable BugHunter. The output dialog box displays capture data while the program is enabled. " - CHECK.Yup I re-enabled it.

Then this:

"When you activate Help in an application's dialog box, messages from BugHunter appear in the output window." -- FAIL.

To me, this means BugHunter should be intercepting the F1 calls somehow from our application. Or am I misinterpreting it? Or do I need to do something special for it to know I'm calling that application's help? Anyway, if I press F1 in our application, the help launches as expected, but no messages appear in the BugHunter output window. (I even tried running our application through RH's File | Context Sensitive Help | Open Application menu item and pressing F1 within our app. Same story. Help ran fine, but not output message.)

The closest I can get to BugHunter doing anything is if I right-click on the BugHunter output pane and choose "Test HTML Help API" from the popup menu and a dialog box of the same name appears. I browse to a chm file of ours. For Command, I choose HH_HELP_CONTEXT, and in Map Number, I type a number and then I click Test. Only then does BugHunter do something and display info on the mapping.

I can't get HH_DISPLAY_TOPIC to do anything. I've tried map number and help file for HTML File and nothing ever happens.

I then try the above HH_HELP_CONTEXT an the same chm help just in a different directory, and now nothing displays in the output now.

So, does it work? Partially. I guess. Maybe. Not really.