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 assign key shortcuts for VSdocman main window, comment editor or XML comment addition in Visual Studio.
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

VS Mag award

vsip logo

A few years ago, we gave a test to several products to document our source code. We finally chose VSdocman mostly because it was easy to use, from within the development environment, making training of programmers useless. It provides flexible features which enables producing complete documentation for people using our products and also for internal use. When technical support is required (we needed this when switching to VS 2015), Peter answered our emails very quickly. After more than 3 years with VSdocman, we strongly recommend the product which is amazingly easier to use than SandCastle.

Pierrick Combreau, Product Manager, Quotalys Ltd