Fixing Issues with HTML Help Workshop
To make it easy to setup the tools necessary to build the help files on a developer's machine or on a build server, I store all relevant applications under a folder such as D:\Buildserver\Tools. This folder contains applications like Sandcastle, SHFB, and the HTML Help Workshop which contains the compiler for the help file. I install the applications using the supplied installer first, then copy the files into this Buildserver folder. All these applications are source controlled so setting up a new development or CI machine is a matter of getting a "latest version" from source control. Or so I thought.
Today I was installing Sandcastle and the necessary tools on a brand new machine. Setting up Sandcastle and SHFB went smoothly, but I ran into problems when SHFB tried to access the HTML Help Workshop. No matter what I tried, I kept getting the error: The program can't start because HHA.dll is missing from your computer. Try reinstalling the program to fix this problem.
Google didn't bring up any results for this error, so I was getting worried about my chances on fixing this error.
Then I realized that the solution was staring me in the face: I hadn't really installed the HTML Help Workshop, but merely used a local copy of the files under my Buildserver folder. So, maybe the setup installs other files than those under the main Program Files folder that I used for my build tools? A quick reinstallation of the HTML Help Workshop provided the answer: yes it does. Once I reinstalled the Help Workshop, everything worked fine, including running the Workshop tools from my Buildserver folder. Funny thing is: my system still doesn't seem to contain the HHA.dll file. Weird also that it ran fine on other machines used for the build, but maybe they simply had the HTML Help Workshop already installed.
I am merely blogging about this as a reminder to myself the next time I am setting up a new, clean build machine, but maybe it helps somebody else with a similar problem as well.
Where to Next?
Wonder where to go next? You can read existing comments below or you can post a comment yourself on this article.
Links in this Document
Talk Back! Comment on Imar.Spaanjaars.Com
I am interested in what you have to say about this article. Feel free to post any comments, remarks or questions you may have about this article. The Talk Back feature is not meant for technical questions that are not directly related to this article. So, a post like "Hey, can you tell me how I can upload files to a MySQL database in PHP?" is likely to be removed. Also spam and unrealistic job offers will be deleted immediately.
When you post a comment, you have to provide your name and the comment. Your e-mail address is optional and you only need to provide it if you want me to contact you. It will not be displayed along with your comment. I got sick and tired of the comment spam I was receiving, so I have protected this page with a simple calculation exercise. This means that if you want to leave a comment, you'll need to complete the calculation before you hit the Post Comment button.
If you want to object to a comment made by another visitor, be sure to contact me and I'll look into it ASAP. Don't forget to mention the page link, or the Doc ID of the document.
Please correct the following errors:
Unfortunately, something went wrong and your message or comments have not been submitted successfully.
There's a fair chance things broke down because you tried to post something that looks like HTML. Things that look like HTML include (X)HTML, obviously, XML, ASP.NET markup and c# generics syntax as all of them use the < and > characters.
If that's the case, try altering your message and remove anything that looks like an angled bracket. You can replace them with [ and ] for example so you can still make it look like HTML to some extend.
If, on the other hand, you were trying to spam this web site, I am pretty glad I caught you in the act and stopped you from doing so ;-)
Also, please don't use links in your posts; I had to block them to filter out most of the junk mail I am receiving.