Step 7 of 9: Build Assembler (pc reboot/hang)

Topics: DocSites, Help 1.x/2.x, Sandcastle
Mar 26, 2008 at 3:46 PM
hello everyone,

sorry to bother you. but i don't know where else to ask.

i have the Sandcastle January 2008 Release and visual studio 2k5 with sp1 and win xp pro and docproject 1.10.1 Release Candidate.

i have set the msbuild output to normal instead of minimal (default)
now here is my build output:

Build succeeded.

Time Elapsed 00:00:02.04
------ Build started: Project: docs, Configuration: Debug Any CPU ------
Build started 26-3-2008 15:24:42.
Target ResolveProjectReferences:
Target CoreCompile:
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.10.1.0_af1a4bab65cc4ece\DaveSexton.DocProject.dll /reference:C:\WINDOWS\assembly\GACMSIL\DaveSexton.DocProject.DocSites\1.0.1.0_af1a4bab65cc4ece\DaveSexton.DocProject.DocSites.dll /reference:D:\www\mysite\shop\bin\shop.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Configuration.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.Drawing.dll /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Web.dll /reference:"C:\Program Files\Microsoft ASP.NET\ASP.NET 2.0 AJAX Extensions\v1.0.61025\System.Web.Extensions.dll" /reference:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\System.Xml.dll /debug+ /debug:full /optimize- /out:obj\Debug\docs.dll /target:library Controls\DocSiteBreadcrumbs.ascx.cs Controls\DocSiteBreadcrumbs.ascx.designer.cs Controls\DocSiteContents.ascx.cs Controls\DocSiteContents.ascx.designer.cs Controls\DocSiteFooter.ascx.cs Controls\DocSiteFooter.ascx.designer.cs Controls\DocSiteHeader.ascx.cs Controls\DocSiteHeader.ascx.designer.cs Controls\DocSiteIndex.ascx.cs Controls\DocSiteIndex.ascx.designer.cs Controls\DocSiteLetterBar.ascx.cs Controls\DocSiteLetterBar.ascx.designer.cs Controls\DocSiteSidebar.ascx.cs Controls\DocSiteSidebar.ascx.designer.cs DocSiteAdmin.aspx.cs DocSiteAdmin.aspx.designer.cs DocSiteBrowseIndex.aspx.cs DocSiteBrowseIndex.aspx.designer.cs DocSiteSearch.aspx.cs DocSiteSearch.aspx.designer.cs DocSiteLogin.aspx.cs DocSiteLogin.aspx.designer.cs HelpFileNotFound.aspx.cs HelpFileNotFound.aspx.designer.cs Properties\AssemblyInfo.cs BuildProcess.cs Default.aspx.cs Default.aspx.designer.cs DocSite.Master.cs DocSite.Master.designer.cs

Compile complete -- 0 errors, 0 warnings
Target _CopyFilesMarkedCopyLocal:
Copying file from "C:\WINDOWS\assembly\GACMSIL\DaveSexton.DocProject.DocSites\1.0.1.0_af1a4bab65cc4ece\DaveSexton.DocProject.DocSites.dll" to "bin\DaveSexton.DocProject.DocSites.dll".
Copying file from "D:\www\mysite\shop\bin\shop.dll" to "bin\shop.dll".
Copying file from "D:\www\mysite\shop\bin\AjaxControlToolkit.dll" to "bin\AjaxControlToolkit.dll".
Copying file from "D:\www\mysite\shop\bin\shop.pdb" to "bin\shop.pdb".
Copying file from "D:\www\mysite\shop\bin\shop.xml" to "bin\shop.xml".
Target GetCopyToOutputDirectoryItems:
Target _CopyOutOfDateSourceItemsToOutputDirectoryAlways:
Copying file from "D:\www\mysite\shop\Bin\AjaxControlToolkit.dll" to "bin\Bin\AjaxControlToolkit.dll".
Target CopyFilesToOutputDirectory:
Copying file from "obj\Debug\docs.dll" to "bin\docs.dll".
docs -> D:\www\mysite\docs\bin\docs.dll
Copying file from "obj\Debug\docs.pdb" to "bin\docs.pdb".

Starting help build for docs...
Preparing target directory...
Merging XML documentation for shop.dll...
Building documentation for docs...

Step 1 of 9: Change Directory

Changing current directory from "D:\www\mysite\docs\Help\" to "D:\www\mysite\docs\buildhelp"

Step 1 Time Elapsed: 00:00:00

Step 2 of 9: Execute MRefBuilder

C:\Program Files\Sandcastle\ProductionTools\MRefBuilder /config:"D:\www\mysite\docs\Help\Presentation\Style\Configuration\MRefBuilder.config" /out:reflection.org /internal- /dep:"C:\WINDOWS\assembly\GAC32\System.Web\2.0.0.0_b03f5f7f11d50a3a\System.Web.dll","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","C:\WINDOWS\assembly\GACMSIL\System.Drawing\2.0.0.0_b03f5f7f11d50a3a\System.Drawing.dll","C:\WINDOWS\assembly\GAC32\System.Data\2.0.0.0_b77a5c561934e089\System.Data.dll","C:\WINDOWS\assembly\GACMSIL\Microsoft.VisualC\8.0.0.0_b03f5f7f11d50a3a\Microsoft.VisualC.dll","C:\WINDOWS\assembly\GAC32\System.Transactions\2.0.0.0_b77a5c561934e089\System.Transactions.dll","C:\WINDOWS\assembly\GAC32\System.EnterpriseServices\2.0.0.0_b03f5f7f11d50a3a\System.EnterpriseServices.dll","C:\WINDOWS\assembly\GACMSIL\System.DirectoryServices\2.0.0.0_b03f5f7f11d50a3a\System.DirectoryServices.dll","C:\WINDOWS\assembly\GACMSIL\System.Runtime.Remoting\2.0.0.0_b77a5c561934e089\System.Runtime.Remoting.dll","C:\WINDOWS\assembly\GACMSIL\System.Runtime.Serialization.Formatters.Soap\2.0.0.0_b03f5f7f11d50a3a\System.Runtime.Serialization.Formatters.Soap.dll","C:\WINDOWS\assembly\GACMSIL\System.Web.Services\2.0.0.0_b03f5f7f11d50a3a\System.Web.Services.dll","C:\WINDOWS\assembly\GACMSIL\System.Design\2.0.0.0_b03f5f7f11d50a3a\System.Design.dll","C:\WINDOWS\assembly\GACMSIL\System.Windows.Forms\2.0.0.0_b77a5c561934e089\System.Windows.Forms.dll","C:\WINDOWS\assembly\GACMSIL\Accessibility\2.0.0.0_b03f5f7f11d50a3a\Accessibility.dll","C:\WINDOWS\assembly\GACMSIL\System.Deployment\2.0.0.0_b03f5f7f11d50a3a\System.Deployment.dll","C:\WINDOWS\assembly\GACMSIL\System.Drawing.Design\2.0.0.0_b03f5f7f11d50a3a\System.Drawing.Design.dll","C:\WINDOWS\assembly\GAC32\System.Data.OracleClient\2.0.0.0_b77a5c561934e089\System.Data.OracleClient.dll","C:\WINDOWS\assembly\GACMSIL\System.Web.RegularExpressions\2.0.0.0_b03f5f7f11d50a3a\System.Web.RegularExpressions.dll","C:\WINDOWS\assembly\GACMSIL\System.DirectoryServices.Protocols\2.0.0.0_b03f5f7f11d50a3a\System.DirectoryServices.Protocols.dll","C:\WINDOWS\assembly\GACMSIL\System.ServiceProcess\2.0.0.0_b03f5f7f11d50a3a\System.ServiceProcess.dll","C:\WINDOWS\assembly\GACMSIL\System.Configuration.Install\2.0.0.0_b03f5f7f11d50a3a\System.Configuration.Install.dll","C:\WINDOWS\assembly\GACMSIL\System.Web.Extensions\1.0.61025.0_31bf3856ad364e35\System.Web.Extensions.dll" "D:\www\mysite\shop\bin\shop.dll"

MrefBuilder (v2.4.10111.0)
Copyright ¸ Microsoft 2006
Info: Loaded 1 assemblies for reflection and 27 dependency assemblies.
Info: Wrote information on 25 namespaces, 256 types, and 2956 members

Step 2 Time Elapsed: 00:00:07.7187500

Step 3 of 9: Execute XslTransform

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

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

Step 3 Time Elapsed: 00:00:26

Step 4 of 9: Copy File

Copy "D:\www\mysite\docs\buildhelp\reflection.xml" to "D:\www\mysite\docs\buildhelp\assembler\reflection.xml" and overwrite.

Step 4 Time Elapsed: 00:00:01.0781250

Step 5 of 9: Execute XslTransform

C:\Program Files\Sandcastle\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\ReflectionToManifest.xsl" "D:\www\mysite\docs\buildhelp\assembler\reflection.xml" /out:"manifest.xml"

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

Step 5 Time Elapsed: 00:00:05.1093750

Step 6 of 9: Execute XslTransform

C:\Program Files\Sandcastle\ProductionTools\XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\CreateVSToc.xsl" "D:\www\mysite\docs\buildhelp\assembler\reflection.xml" /out:"toc.xml"

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

Step 6 Time Elapsed: 00:00:03.2968750

Step 7 of 9: Build Assembler {sandcastle.help1x.config}

Preparing...
Executing...
Canceling background step...

Topics processed: 0
Background step canceled.

Successful Steps: 7 of 9
Failed Steps: 0

docs help build canceled.



Step 7 Time Elapsed: 00:04:42.5781250

Total Time Elapsed: 00:05:30.3750000
Build FAILED.

Time Elapsed 00:05:34.68

as you can see, i've waited for almost 5 minutes for that step.
i've set produce help 1.x and help 2.x to false
also tried to enable both
or just nr.2 but my pc just hangs and sometimes even shutsdown!

i don't know what i am doing wrong... maybe someone else does
i hope so.

thanks in advanced for your time!
Mar 26, 2008 at 7:05 PM
Hi,

It's possible that you simply must wait longer. Large documentation sets can take longer than 5 minutes to build.

In the DocProject Properties window look under the Build category for Build assembler options, expand it and enable Trace all. The next time you build you'll see trace information for that step.

I've already submitted a feature request to the Sandcastle team to provide a progress notification that DocProject can use to update the VS progress bar during the build assembler step, but it's not available yet.
The work item is here. Hopefully they'll get to it in the next release.

As for your computer hanging or shutting down, I don't know what could cause that. You could try building your project on the command-line to see if it helps: msbuild.exe mydocproject.csproj

By the way, what is nr.2?

- Dave
Mar 27, 2008 at 9:44 AM
dave, thanks for your reply

by 'nr.2' i meant: that i only set help2.x to build and not 1.

i've set the trace all to enable and will post the output here soon.

thanks for your time and for submitting that usefull ticket for sandcastle :)

regards JP
Mar 27, 2008 at 10:17 AM
dave, i've enabled that setting 'trace all'
it seems to work now.

my laptop shutsdown if it get's to hot.

the docproject takes over 500mb and about 90% of cpu for a long time. i think that that is more of an issue for sandcastle then for docproject.

thanks for your support

regards JP
Mar 27, 2008 at 10:23 AM
Hi JP,

Thanks for the update. I'm glad to know that the issue is resolved.

Note that you may get better performance building on the command-line.

You can get better performance in Visual Studio and the DocProject External UI by disabling all build assembler options, including Cancelable, although you won't be able to cancel it then :)

- Dave
Mar 27, 2008 at 10:34 AM
Hi JP,

Also, you might want to check out Eric Woodruff's collection of Sandcastle Standalone build components, which you can use in your DocProject or DocSite. Note that it's a separate download from SHFB.

One of the components caches URLs to the MSDN online library (for reference links) so that web service calls don't have to be made for the same links each time you build.

I haven't tried it myself yet, but I think that you'll see a major performance improvement if you use it.

For instructions refer to the documentation that comes with the components and read How To Use Third-Party Build Components In DocProject to learn how to integrate it into your project.

- Dave