I'm getting empty topics in generated CHM, how can I fix it?

This happens when you open CHM from network location and try to open any topic, you get "Action canceled" error page.

The HTML Help viewer has canceled the display of the help file due to security restrictions. This will happen with all HTML Help files that you open over a network connection (note, that local HTML Help files will not be affected). This behavior is caused by Windows security update 896358, see http://support.microsoft.com/kb/896358 for more details.

Solutions

  • Place the CHM documentation on local drive.
  • Use some workarounds mentioned at http://support.microsoft.com/kb/896358.
  • Use free utility HHReg which fixes this new limitation by explicitly registering the help file in the Windows registry. You can get it from http://www.ec-software.com/products_hhreg.html. You can call Hhreg.exe directly from the template to register CHM on your computer. Open your CHM template in text editor and find a line containing call to hhc.exe in $vbdoc-exec-after$ macro. It ends like:

    hhc.exe" "$OUTPUT-PATH$\$PROJECT-NAME$$PROJECT-EXT$"

    Add call to Hhreg.exe somewhere after it. If you have installed Hhreg.exe to c:\myfolder then it should be as follows:

    @"c:\myfolder\hhreg.exe" /s "$OUTPUT-PATH$\$PROJECT-NAME$.chm"

 

Start generating your .NET documentation now!
DOWNLOAD
Free, fully functional trial
VSdocman Tip
You can generate documentation in your automated builds. VSdocman supports command line mode.
Customers

Universities
Medical institutions
Government institutions
Large financial institutions
Thousands of SW companies

Deloitte & Touche
PricewaterhouseCoopers
Bloomberg
Wells Fargo
QBE

Caterpillar
Lear
DuPont
Pfizer

Boeing
Airbus
Rolls-Royce Naval Marine
Toyota Motorsport

Bose
Mitsubishi Electric
Johnson Controls
Bentley Systems

Intel
Hewlett Packard
Bosch (Australia)
Schneider Electric

Intergraph
Volvo Information Technology
SOPRA GROUP
Agilent Technologies
Tesco SW

Syncfusion
T-Systems
Verizon
Fraunhofer Heinrich-Hertz-Institut