Help 1 Compiler Errors
This topic covers common issues related to the Help 1 compiler (Microsoft HTML Help Workshop).
- Why is the help compiler failing with HHC3002 and HHC3004 errors referencing non-HTML files such as images?
- Why is the help compiler failing with HHC6000 and HHC5007 errors referencing "disk full" and "fatal navigational compilation" errors?
- Why is the help compiler failing with an HHC6003 error stating that itircl.dll has not been registered?
- The help 1 compiler (HHC.EXE) crashes with an exit code of -1073741515. What does that mean?
Why is the help compiler failing with HHC3002 and HHC3004 errors referencing non-HTML files such as images?
See BE0060: The [itemType] '[item]' contains a comma or '.h' which may cause the Help 1 compiler to fail.
Why is the help compiler failing with HHC6000 and HHC5007 errors referencing "disk full" and "fatal navigational compilation" errors?
Check the log file for the MRefBuilder output. It will most likely report that it found and documented zero types. This is caused by not having any public types in the documented assemblies or not specifying any assemblies at all to document (i.e. the Documentation Sources project node is empty or only contains XML comments files). Sandcastle requires at least one assembly and will not document internal and private code by default. Be sure to declare at least one class public. If all classes really are supposed to be private and/or internal, set the Document Privates and/or Document Internals project properties to true.
Why is the help compiler failing with an HHC6003 error stating that itircl.dll has not been registered?
This error affects a small number of people and is caused by one of the help components (itcc.dll) either not getting installed or not getting registered correctly. Search your system for the DLL. If not found, you can either locate it on another system that has the Help 1 components or you can search Google for it. Once you obtain it, you will need to copy it to the failing system and register it. This can be done by running the following command from a command prompt. Adjust the path to the DLL as necessary based on its location on your system.
regsvr32 C:\Windows\System\itcc.dllThe help 1 compiler (HHC.EXE) crashes with an exit code of -1073741515. What does that mean?
Typically, this means that the help 1 compiler is not installed correctly or is missing one or more of its components. Download and install the Microsoft HTML Help Workshop to correct the problem. A link for the download can be found in the Installation Instructions topic. You may need to do this even if the guided installer detects that the help 1 compiler is installed. The HTML Help Workshop installer may also state that it is already installed as well. Complete the installation anyway to ensure that all of the required components are present and registered correctly.