No html created -> empty chm Help1.x

Topics: General Questions, Help 1.x/2.x
Jun 21, 2007 at 4:43 PM
First off all, thanks for this project.

But I have a little problem that it is not working. There is no html created and for that reason I think also no working chm file. In addition I get a nice error.
What I did:
  • I had already Visual Studio 2005 ENU with Service Pack 1 installed
  • Read the releases notes, but as I could understand there was nothing to pay special attention for
  • I installed the Sandcastle - June 2007 Community Technology Preview (CTP)
  • I installed the lasted RC of DocProject 1.6.1
  • Opened an existing solution with C# projects containing XML documentation. Added a C# DocProject to the solution and added the existing project to it as reference. I didn't select any of the two output formats (Help 1.x or Help 2.x) because I just want a bunch of html files like NDoc or Doxygen generates.
  • I build the DocProject. There was an empty Html folder created.
  • I enabled the Help 1.x and then there was an empty chm file generated.
  • I checked the DXROOT user environment variable, which was set correctly
  • I build the solution and get the following error when building the documentation:
Step 13 of 14: Compile Help 1.x

C:\Program Files\Html Help Workshop\hhc.exe "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.hhp"

Microsoft HTML Help Compiler 4.74.8702
Compiling e:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.chm
HHC5003: Error: Compilation failed while compiling html\.htm.
HHC6000: Error: An internal file could not be created. Make certain there is enough disk space on the drive where you are compiling your file.
HHC5007: Error: Fatal navigational compilation error. This is likely the result of an invalid contents (.hhc) file.
The following files were not compiled:
html\.htm
Non-zero exit code: 1
And there is off course plenty of space on my hard disk.
  • I also restarted Visual Studio a few times to see it makes difference. I also read a few posts on the discussion board here, didn't see the same error or problem.

Does someone know how to solve this? Thanks in advance.

Christophe
Jun 21, 2007 at 4:51 PM
Hi Christophe,

It would be really helpful to see the information in the Output window since the problem is probably occurring at one of the earlier build steps even though there is no error. Would you mind posting it here?

Thanks,
Dave
Jun 21, 2007 at 4:55 PM
This is the entire output:

------ Rebuild All started: Project: getools, Configuration: Debug Any CPU ------
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Csc.exe /noconfig /nowarn:1701,1702 /errorreport:prompt /warn:4 /doc:bin\Debug\getools.XML /define:DEBUG;TRACE /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Data.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Xml.dll /reference:C:\WINDOWS\assembly\GAC\stdole\7.0.3300.0__b03f5f7f11d50a3a\stdole.dll /reference:obj\Debug\Interop.EARTHLib.dll /debug+ /debug:full /optimize- /out:obj\Debug\getools.dll /target:library HookMouse.cs Properties\AssemblyInfo.cs win32.cs

Compile complete -- 0 errors, 0 warnings
getools -> E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\getools\bin\Debug\getools.dll
------ Rebuild All started: Project: geapis, Configuration: Debug Any CPU ------
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Csc.exe /noconfig /nowarn:1701,1702 /errorreport:prompt /warn:4 /doc:bin\Debug\geapis.XML /define:DEBUG;TRACE /reference:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\getools\bin\Debug\getools.dll" /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Data.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Windows.Forms.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Xml.dll /reference:C:\WINDOWS\assembly\GAC\stdole\7.0.3300.0__b03f5f7f11d50a3a\stdole.dll /reference:obj\Debug\Interop.EARTHLib.dll /debug+ /debug:full /optimize- /out:obj\Debug\geapis.exe /target:exe ClickCatcher.cs Program.cs Properties\AssemblyInfo.cs

Compile complete -- 0 errors, 0 warnings
geapis -> E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geapis\bin\Debug\geapis.exe
------ Rebuild All started: Project: gewindow, Configuration: Debug Any CPU ------
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Csc.exe /noconfig /nowarn:1701,1702 /errorreport:prompt /warn:4 /define:DEBUG;TRACE /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Data.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Deployment.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Drawing.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Windows.Forms.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Xml.dll /reference:C:\WINDOWS\assembly\GAC\stdole\7.0.3300.0__b03f5f7f11d50a3a\stdole.dll /reference:obj\Debug\Interop.EARTHLib.dll /debug+ /debug:full /optimize- /out:obj\Debug\GEWindow.exe /resource:obj\Debug\GEWindow.Properties.Resources.resources /target:exe Program.cs Properties\AssemblyInfo.cs Properties\Resources.Designer.cs Properties\Settings.Designer.cs ScreenCapture.cs UserActivityHook.cs

Compile complete -- 0 errors, 0 warnings
gewindow -> E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\gewindow\bin\Debug\GEWindow.exe
------ Rebuild All started: Project: hooktest, Configuration: Debug Any CPU ------
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Csc.exe /noconfig /nowarn:1701,1702 /errorreport:prompt /warn:4 /define:DEBUG;TRACE /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Data.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Deployment.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Drawing.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Windows.Forms.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Xml.dll /debug+ /debug:full /optimize- /out:obj\Debug\hooktest.exe /resource:obj\Debug\hooktest.Properties.Resources.resources /target:winexe Form1.cs Properties\AssemblyInfo.cs Properties\Resources.Designer.cs Properties\Settings.Designer.cs UserActivityHook.cs

Compile complete -- 0 errors, 0 warnings
hooktest -> E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\hooktest\bin\Debug\hooktest.exe
------ Rebuild All started: Project: geDoc, Configuration: Debug Any CPU ------
Help project cleaned.

C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Csc.exe /noconfig /nowarn:1701,1702 /errorreport:prompt /warn:4 /define:DEBUG;TRACE /reference:C:\WINDOWS\assembly\GACMSIL\DaveSexton.DocProject\1.6.1.0_af1a4bab65cc4ece\DaveSexton.DocProject.dll /reference:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geapis\bin\Debug\geapis.exe" /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.dll /debug+ /debug:full /optimize- /out:obj\Debug\geDoc.dll /target:library Properties\AssemblyInfo.cs BuildProcess.cs

Compile complete -- 0 errors, 0 warnings
geDoc -> E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\bin\Debug\geDoc.dll

Starting help build for geDoc...
Preparing target directory...
Building documentation for geDoc...

Step 1 of 14: Change Directory

Changing current directory from "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\" to "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp"

Step 1 Time Elapsed: 00:00:00

Step 2 of 14: Execute MRefBuilder

C:\Program Files\Sandcastle\\ProductionTools\MRefBuilder /config:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\Configuration\MRefBuilder.config" /out:reflection.org /internal- /dep:"C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\mscorlib.dll","C:\WINDOWS\assembly\GACMSIL\System\2.0.0.0_b77a5c561934e089\System.dll","C:\WINDOWS\assembly\GACMSIL\System.Configuration\2.0.0.0_b03f5f7f11d50a3a\System.Configuration.dll","C:\WINDOWS\assembly\GACMSIL\System.Xml\2.0.0.0_b77a5c561934e089\System.Xml.dll","C:\WINDOWS\assembly\GACMSIL\System.Data.SqlXml\2.0.0.0_b77a5c561934e089\System.Data.SqlXml.dll","C:\WINDOWS\assembly\GACMSIL\System.Security\2.0.0.0_b03f5f7f11d50a3a\System.Security.dll" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geapis\bin\Debug\geapis.exe"

MrefBuilder (v2.2.64000.4)
Copyright ¸ Microsoft 2006
Info: Loaded 1 assemblies for reflection and 6 dependency assemblies.
Info: Wrote information on 0 namespaces, 0 types, and 0 members

Step 2 Time Elapsed: 00:00:01.6223328

Step 3 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\ApplyVSDocModel.xsl" reflection.org /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\AddGuidFilenames.xsl" /out:"reflection.xml" /arg:IncludeAllMembersTopic=true /arg:IncludeInheritedOverloadTopics=true

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\ApplyVSDocModel.xsl'.
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\AddGuidFilenames.xsl'.

Step 3 Time Elapsed: 00:00:00.8211808

Step 4 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToManifest.xsl" "reflection.xml" /out:manifest.xml

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToManifest.xsl'.

Step 4 Time Elapsed: 00:00:00.3505040

Step 5 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\CreateVSToc.xsl" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\reflection.xml" /out:"toc.xml"

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\CreateVSToc.xsl'.

Step 5 Time Elapsed: 00:00:00.4306192

Step 6 of 14: Copy File

Copy "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\reflection.xml" to "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\assembler\reflection.xml" and overwrite.

Step 6 Time Elapsed: 00:00:00.0100144

Step 7 of 14: Change Directory

Changing current directory from "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp" to "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\assembler"

Step 7 Time Elapsed: 00:00:00

Step 8 of 14: Build Assembler {sandcastle.help1x.config}
Jun 21, 2007 at 4:55 PM
Info: Instantiating component.
Info: Loading data file '..\..\Presentation\Style\Transforms\skeleton.xml'.
Info: Instantiating component.
Info: Searching for files that match '*.xml'.
Info: Searching for files that match '.\reflection.xml'.
Info: Indexed 188528 elements in 65 files.
Info: Instantiating component.
Info: Instantiating component.
Info: Loading subcomponents.
Info: Instantiating component.
Info: Loaded 1 subcomponents.
Info: Instantiating component.
Info: Loading subcomponents.
Info: Instantiating component.
Info: Loaded 1 subcomponents.
Info: Instantiating component.
Info: Instantiating component.
Info: Loaded 3 syntax generators.
Info: Instantiating component.
Info: Searching for files that match '*.xml'.
Info: Searching for files that match 'Comments\*.xml'.
Info: Indexed 75464 elements in 67 files.
Info: Instantiating component.
Info: Loading subcomponents.
Info: Instantiating component.
Info: Instantiating component.
Info: Instantiating component.
Info: Loaded 2 subcomponents.
Info: Instantiating component.
Info: Instantiating component.
Info: Instantiating component.
Info: Searching for files that match '..\..\Presentation\Style\content\shared_content.xml'.
Info: Loading shared content file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\shared_content.xml'.
Info: Found 1 files in ..\..\Presentation\Style\content\shared_content.xml.
Info: Searching for files that match '..\..\Presentation\Style\content\reference_content.xml'.
Info: Loading shared content file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Overriding shared content item 'methodindexentry' with value in file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Overriding shared content item 'remarkstitle' with value in file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Overriding shared content item 'exceptionstitle' with value in file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Overriding shared content item 'namespacenameheader' with value in file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Overriding shared content item 'runningheadertext' with value in file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\content\reference_content.xml'.
Info: Found 1 files in ..\..\Presentation\Style\content\reference_content.xml.
Info: Searching for files that match '..\..\Presentation\Shared\content\syntax_content.xml'.
Info: Loading shared content file 'E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Shared\content\syntax_content.xml'.
Info: Found 1 files in ..\..\Presentation\Shared\content\syntax_content.xml.
Info: Loaded 477 shared content items.
Info: Instantiating component.
Info: Creating MSDN URL resolver.
Info: Searching directory 'C:\Program Files\Sandcastle\Data\Reflection' for targets files of the form '*.xml'.
Info: Searching directory '.' for targets files of the form 'reflection.xml'.
Info: Loaded 188528 reference targets.
Info: Instantiating component.

Topics processed: 0

Step 8 Time Elapsed: 00:01:41.7062464

Step 9 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToChmProject.xsl" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\reflection.xml" /arg:"project=geDoc" /out:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.hhp"

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToChmProject.xsl'.

Step 9 Time Elapsed: 00:00:02.8040320

Step 10 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\TocToChmContents.xsl" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\toc.xml" /out:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.hhc"

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\TocToChmContents.xsl'.

Step 10 Time Elapsed: 00:00:02.0229088

Step 11 of 14: Execute XslTransform

C:\Program Files\Sandcastle\\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToChmIndex.xsl" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\reflection.xml" /out:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.hhk"

XslTransform (v2.2.64000.4)
Copyright ¸ Microsoft 2005-2006
Info: Applying XSL transformation 'C:\Program Files\Sandcastle\\ProductionTransforms\ReflectionToChmIndex.xsl'.

Step 11 Time Elapsed: 00:00:00.8011520

Step 12 of 14: Copy Directory

Deep move "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\buildhelp\assembler\Output\html" to "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Html".

Step 12 Time Elapsed: 00:00:00.6609504

Step 13 of 14: Compile Help 1.x

C:\Program Files\Html Help Workshop\hhc.exe "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.hhp"

Microsoft HTML Help Compiler 4.74.8702
Compiling e:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\geDoc.chm
HHC5003: Error: Compilation failed while compiling html\.htm.
HHC6000: Error: An internal file could not be created. Make certain there is enough disk space on the drive where you are compiling your file.
HHC5007: Error: Fatal navigational compilation error. This is likely the result of an invalid contents (.hhc) file.
The following files were not compiled:
html\.htm
Non-zero exit code: 1

Step 13 DaveSexton.DocProject.Engine.ExternalProcessException: Compile Help 1.x:
The "C:\Program Files\Html Help Workshop\hhc.exe" process failed with exit code: 1.

Total Time Elapsed: 00:03:19.1263296

Successful Steps: 12 of 14
Failed Steps: 1

geDoc help build failed.

========== Rebuild All: 4 succeeded, 1 failed, 0 skipped ==========

In two post because it doesn't fit in one. Hope it helps
Jun 21, 2007 at 5:04 PM
Hi Christophe,

Thank you for posting the information.

What's interesting to me is step #2:

Step 2 of 14: Execute MRefBuilder

C:\Program Files\Sandcastle\\ProductionTools\MRefBuilder /config:"E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geDoc\Presentation\Style\Configuration\MRefBuilder.config" /out:reflection.org /internal- /dep:"C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\mscorlib.dll","C:\WINDOWS\assembly\GACMSIL\System\2.0.0.0b77a5c561934e089\System.dll","C:\WINDOWS\assembly\GACMSIL\System.Configuration\2.0.0.0b03f5f7f11d50a3a\System.Configuration.dll","C:\WINDOWS\assembly\GACMSIL\System.Xml\2.0.0.0b77a5c561934e089\System.Xml.dll","C:\WINDOWS\assembly\GACMSIL\System.Data.SqlXml\2.0.0.0b77a5c561934e089\System.Data.SqlXml.dll","C:\WINDOWS\assembly\GACMSIL\System.Security\2.0.0.0_b03f5f7f11d50a3a\System.Security.dll" "E:\Christophe\My Documents\Diepenbeek 2006-2007\Sem. 2\Eindwerk\geapis\bin\Debug\geapis.exe"

MrefBuilder (v2.2.64000.4)
Copyright ¸ Microsoft 2006
Info: Loaded 1 assemblies for reflection and 6 dependency assemblies.
Info: Wrote information on 0 namespaces, 0 types, and 0 members

The last Info: line indicates that nothing was generated for the geapis.exe program although the command-line looks correct.

I have a feeling that the program has no public classes. Change the following setting to Complete and it should work:

Tools > Options > DocProject > Active Projects > Documentation scope

Thanks,
Dave

Jun 21, 2007 at 5:34 PM
This makes indeed a difference. Thanks for the real quick help. I forget that a class without any key word by default private is.