SHFB really slow, but no CPU usage...

Topics: Developer Forum, User Forum
Jan 17, 2010 at 1:12 PM

Building the html 1 help for some .NET 3.5 library takes ages, and looking at the CPU usage in task manager, suggests that BuildAssembler.exe doesnt do anything, (neither does something else). So most pages take 10-20 seconds to complete if not longer but nothing is going on CPU wise. This IMHO means that something is waiting for something else, which seriously hurts performance overall.

Am I alone in this? Is it sandcastle's cruft that's not really doing anything or is it SHFB's internal process that's slow? I'm on Windows XP SP3, .net 3.5 sp1.

Jan 17, 2010 at 5:21 PM

Sandcastle's BuildAssembler tool uses the MSDN web service to resolve links to the online content for the base framework members.  Your connection speed and how the web service is doing at any given point in time will affect the build time.  You can mitigate this to a certain extent by adding the cached build components to your project.  The cached MSDN URL references component will cache the URLs returned from the web service on subsequent builds so that they don't have to be looked up using the web service.  You add the components via the project's ComponentConfigurations property.  See the Cached Build Components topic for more information.