DocProject Work Item Rss Feed

Commented Issue: 'value cannot be null' when adding new DocProject [19314]

davedev — Thu, 08 Oct 2009 01:20:34 GMT

Symptom:
The following occurs when adding a new DocProject project to a solution.
---
An error occurred while running the New Project Wizard:
System.ArgumentNullException: Value cannot be null.
Parameter name: path2
at System.IO.Path.Combine(String path1, String path2)
at DaveSexton.DocProject.VCProjectOutput.get_OutputFile()
at DaveSexton.DocProject.ProjectFactory.IsSourceProject(IAnyProject project)
at DaveSexton.DocProject.Wizards.ChooseSourcesStep.<get_SourceProjects>b__0(IAnyProject currentProject)
at DaveSexton.DocProject.DocProjectEnvironment.<FindProjectsInternal>d__7.MoveNext()
at DaveSexton.DocProject.MarshalByRefEnumerator`1.MoveNext()
at System.Collections.Generic.List`1..ctor(IEnumerable`1 collection)
at DaveSexton.DocProject.Wizards.ChooseSourcesStep.get_SourceProjects()
at DaveSexton.DocProject.Wizards.ChooseSourcesStep.get_Control()
at DaveSexton.DocProject.Wizards.ChooseSourcesStep.GetUserInterface(WizardController controller, Boolean preloading)
at DaveSexton.DocProject.Wizards.Foundation.WizardStep.GetUserInterfaceInternal(WizardController controller, Boolean preloading)
at DaveSexton.DocProject.Wizards.Foundation.WizardController.<Start>b__0(WizardStep step)
at DaveSexton.DocProject.Wizards.Foundation.WizardController.ForEachStep(Action`1 action)
at DaveSexton.DocProject.Wizards.Foundation.WizardController.Start(Boolean moveToVisible)
at DaveSexton.DocProject.Wizards.Foundation.WizardForm..ctor(String wizardName, WizardStep firstStep, WizardStep lastStep)
at DaveSexton.DocProject.Wizards.DocProjectConfigurationWizard.Run(IDocProject project, EventHandler`1 errorHandler)
at DaveSexton.DocProject.Wizards.VSWizard.ProjectFinishedGenerating(Project project)
---

Reproduction Steps:
1. VS2005, DocProject 1.11.0 (June 8 2008)
2. Create a new solution.
3. Add a new project of type: OtherLanguages -> Visual C++ -> General -> Makefile project
4. In the project properties, set the property; Configuration Properties -> NMake -> General -> Output to be empty.
5. Add a new DocProject project to the solution.
6. Fails with above message.

Notes:
We sometimes use projects like this for custom build steps, e.g. deploying a set of dlls, where there is no single output file.
Comments: ** Comment from web user: davedev **

Thanks for reporting your scenario. Note that the error occurs during the New Project Wizard, which VS starts after the project is created. If the New Project Wizard doesn't complete successfully then you will be left with a project that is an unknown state, hence the error when you try to open DocProject Properties for the corrupted project.

The initial error occurrs when a project does not define an output file. (See step #4 in the OP's repro instructions.) If you have a project of a supported project type (e.g., class library or application project in C#, VB.NET or C++/CLR) in your solution that does not produce an output file then it's not compatible with DocProject 1.11.0. This is because DocProject expects all projects of supported types to produce output and may fail otherwise. I'll probably just elliminate projects without any output from the list of sources in the Choose a Source step of the New Project Wizard (instead of crashing :). The source code is available if you don't want to wait until I can find the time...

How To Use the Source Code
http://docproject.codeplex.com/Wiki/View.aspx?title=How%20To%20Use%20The%20Source%20Code

Created Issue: A property cannot be set while building [24796]

davedev — Sat, 03 Oct 2009 15:52:51 GMT

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=69397

I found a way to make the problem disappear by changing some DocProject properties and excluding some files from the project.

I changed the "Include Project Output Dialog" settings to the following:Apply to all default: TrueInclude project output default: FalseDon't ask me this again: True

Next i excluded the "/bin" folder, the "/Help/html" and all the non folder items in "/Help" folder from the project.I also deleted these files and folders from the filesystem itself, but i don't think this was really needed as DocProject just puts them back and nothing bad comes from that.

It won't add the generated content to the project anymore now, but i actually like it that way so for me theres no problem there.

Commented Issue: 'value cannot be null' when adding new DocProject [19314]

Charlie47 — Fri, 02 Oct 2009 21:05:20 GMT

I'm getting the same error, but under slightly different circumstances.

I'm using Visual Studio 2008, XP SP2, DocProject 1.2.0.0, Sandcastle 2.4.10520, updated with the styles patch (http://www.codeplex.com/SandcastleStyles), I'm running as adminstrator, The variable DXROOT only exists in the System variables and is set to D:\XP Program Files\Sandcastle\, which is where I installed Sandcastle (I have never had either Sandcastle or DocProject on this machine before).

I have an existing solution to which I try to add a DocProject project, by choosing "Add/New Project" from the Solution Explorer,and then choosing DocProject as the project and DocProject as the template.

The DocProject gets created before the error occurs. If I choose "DocProject Properties" from solution explorer I get another error "The DocProject1 project is missing the name of the Sandcastle presentation style that it uses...".

I don't know how to proceed at this point. I'm down to trying various ways to start DocProject to see if I can get anything to work.

Commented Feature: Installer Option to Enable MAML IntelliSense

davedev — Sat, 29 Aug 2009 20:08:40 GMT

Add an option to the installer for enabling MAML IntelliSense globally. Test if the %DXROOT% environment variable can be used in place of a hard-coded path.

<SchemaCatalog xmlns="http://schemas.microsoft.com/xsd/catalog">
<Association extension="aml" schema="file://C:/Program Files/Sandcastle/Schemas/Authoring/developer.xsd" />
</SchemaCatalog>

Solution by clugsta in the comments of the following article:
http://docproject.codeplex.com/Wiki/View.aspx?title=How%20To%20Enable%20IntelliSense%20in%20Conceptual%20Topics
Comments: ** Comment from web user: davedev **

The New Project Wizard should also provide an option to have the schemas copied into the project. When MAML IntelliSense is enabled globally, this option should be disabled by default; otherwise, the option should be enabled by default.

Created Feature: Installer Option to Enable MAML IntelliSense

davedev — Sat, 29 Aug 2009 19:58:28 GMT

Commented Issue: Command-line build not reflecting the changes in DocProject configuration

davedev — Fri, 14 Aug 2009 14:10:56 GMT

I'm working on documentation for medium-size project. Unfortunately, I can't build documentation from Visual Studio because of System.OutOfMemory exception, as described in this post. I can build documentation using MSBuild, so it's just a minor nuisance.

However I've noticed another problem - when I change anything in DocProject properties for my project changes are not reflected using command-line build. I have to issue build from Visual Studio, wait for OutOfMemory exception and then issue MSBuild build to have desired effects. Of course I'm saving all changes in Visual Studio, before trying to build.

Bolek.
Comments: ** Comment from web user: davedev **

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=65561

Created Issue: Command-line build not reflecting the changes in DocProject configuration

davedev — Fri, 14 Aug 2009 14:10:13 GMT

Created Issue: MSBuild Concurrency Exception

davedev — Wed, 15 Jul 2009 12:16:57 GMT

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=53974

Sorry for the vagueness. I wrapped the code inside anonymous methods in a try catch block for each of the Trace* methods in BuildContext.cs, just as you had suggested for the SendOrPostCallback declaration above. On our build server we have multiple DocSite projects being kicked off in sequence by an msbuild script. Somewhere around the end of the first DocSite build being completed and the next starting, the exception occurs. I can only guess that the trace call attempts are from the first run, but I never was able to attach a debugger. If the exception was thrown from a exiting process, that might explain not being able to attach to it.

Here's a log off of our build server, toward the end of the first DocSite compilation.

2009-07-08 15:32:06,960 [Project - Server Sandcastle:DEBUG] Step 10 of 12: Execute ChmBuilder2009-07-08 15:32:06,960 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:32:06,960 [Project - Server Sandcastle:DEBUG] C:\Program Files\Sandcastle\ProductionTools\ChmBuilder /html:"C:\ClearCase_Views\Project\Project_src\DocSites\Dept\buildhelp\assembler\Output\html"

/toc:"C:\ClearCase_Views\Project\Project_src\DocSites\Dept\buildhelp\toc.xml" /project:"Dept" /lcid:1033 /metadata+ /out:Help\

/config:"C:\ClearCase_Views\Project\Project_src\DocSites\Dept\Help\Settings\Projects\help1x.config"2009-07-08 15:32:06,960 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:32:08,757 [Project - Server Sandcastle:DEBUG] ChmBuilder (v2.4.10520.1)2009-07-08 15:32:08,757 [Project - Server Sandcastle:DEBUG] Copyright c MS 20072009-07-08 15:42:03,539 [Project - Server Sandcastle:DEBUG] Processed 16703 files.2009-07-08 15:42:05,367 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:05,367 [Project - Server Sandcastle:DEBUG] Step 10 Time Elapsed: 00:09:58.40625002009-07-08 15:42:05,367 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:05,367 [Project - Server Sandcastle:DEBUG] Step 11 of 12: Execute DBCSFix2009-07-08 15:42:05,476 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:05,476 [Project - Server Sandcastle:DEBUG] C:\Program Files\Sandcastle\ProductionTools\DBCSFix /d:"Help\Html" /l:10332009-07-08 15:42:05,492 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:05,929 [Project - Server Sandcastle:DEBUG] DBCSFix (v2.4.10520.1)2009-07-08 15:42:05,929 [Project - Server Sandcastle:DEBUG] Copyright c 20072009-07-08 15:42:05,929 [Project - Server Sandcastle:DEBUG] Converting unsupported high-order characters to 7-bit ASCII equivalents.2009-07-08 15:42:05,976 [Project - Server Sandcastle:DEBUG] EncodingName: Windows-12522009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] Step 11 Time Elapsed: 00:00:00.82812502009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] Step 12 of 12: Compile Help 1.x2009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] C:\Program Files\Html Help Workshop\hhc.exe "C:\ClearCase_Views\Project\Project_src\DocSites\Dept\Help\Dept.hhp"2009-07-08 15:42:06,195 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:09,507 [Project - Server Sandcastle:DEBUG] Microsoft HTML Help Compiler 4.74.87022009-07-08 15:48:09,507 [Project - Server Sandcastle:DEBUG] Compiling c:\ClearCase_Views\Project\Project_src\DocSites\Dept\Help\Dept.chm2009-07-08 15:48:09,507 [Project - Server Sandcastle:DEBUG] HHC4003: Warning: The following option line does not contain an '=' character separating the option and its value: n++[OPTIONS].2009-07-08 15:48:09,507 [Project - Server Sandcastle:DEBUG] Compile time: 6 minutes, 1 second2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] 16,703 Topics2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] 157,806 Local links2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] 114,560 Internet links2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] 0 Graphics2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] Created c:\ClearCase_Views\Project\Project_src\DocSites\Dept\Help\Dept.chm, 20,506,334 bytes2009-07-08 15:48:09,523 [Project - Server Sandcastle:DEBUG] Compression decreased file by 182,177,338 bytes.2009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] Step 12 Time Elapsed: 00:06:03.45312502009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] Build step execution complete.2009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:09,648 [Project - Server Sandcastle:DEBUG] Building DocSite files...2009-07-08 15:48:09,679 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:09,867 [Project - Server Sandcastle:DEBUG] Creating DocSite TOC: C:\ClearCase_Views\Project\Project_src\DocSites\Dept\App_Data\DocSiteContents.xml2009-07-08 15:48:13,429 [Project - Server Sandcastle:DEBUG] Creating DocSite index: C:\ClearCase_Views\Project\Project_src\DocSites\Dept\App_Data\DocSiteIndex.xml2009-07-08 15:48:13,492 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:13,492 [Project - Server Sandcastle:DEBUG] Verifying output...2009-07-08 15:48:13,492 [Project - Server Sandcastle:DEBUG] Done.2009-07-08 15:48:13,507 [Project - Server Sandcastle:DEBUG] 2009-07-08 15:48:13,507 [Project - Server Sandcastle:DEBUG] Total Time Elapsed: 00:38:02.93750002009-07-08 15:48:13,507 [Project - Server Sandcastle:DEBUG] Done Building Project "C:\ClearCase_Views\Project\Project_src\DocSites\Dept\Dept.csproj" (default targets).2009-07-08 15:48:13,539 [Project - Server Sandcastle:DEBUG] Project "C:\ClearCase_Views\Project\Project_build\BuildScripts\DocSites\MakeDocSites.proj" (1) is building

"C:\ClearCase_Views\Project\Project_src\DocSites\Dept.Project.Database\Dept.Project.Database.csproj" (3:2) on node 0 (default targets).2009-07-08 15:48:13,539 [Project - Server Sandcastle:DEBUG] Processing 0 EDMX files.2009-07-08 15:48:13,539 [Project - Server Sandcastle:DEBUG] Finished processing 0 EDMX files.2009-07-08 15:48:13,539 [Project - Server Sandcastle:DEBUG] PrepareForBuild:2009-07-08 15:48:13,539 [Project - Server Sandcastle:DEBUG] Creating directory "bin\".2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] Unhandled Exception: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. --->

System.InvalidOperationException: A call is made on an inactive IBuildEngine interface corresponding to a task that already finished execution.2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Shared.ErrorUtilities.ThrowInvalidOperation(String resourceName, Object[] args)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.BuildEngine.EngineProxy.LogMessageEvent(BuildMessageEventArgs e)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Utilities.TaskLoggingHelper.LogMessage(MessageImportance importance, String message, Object[] messageArgs)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Utilities.TaskLoggingHelper.LogMessage(String message, Object[] messageArgs)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.MSBuild.MSBuildTrace.TraceLine(String message)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.BuildContext.<>c__DisplayClass13.<TraceLine>b__12()2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] --- End of inner exception stack trace ---2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.RuntimeMethodHandle._InvokeMethodFast(Object target, Object[] arguments, SignatureStruct& sig, MethodAttributes methodAttributes, RuntimeTypeHandle typeOwner)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.RuntimeMethodHandle.InvokeMethodFast(Object target, Object[] arguments, Signature sig, MethodAttributes methodAttributes, RuntimeTypeHandle typeOwner)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture, Boolean skipVisibilityChecks)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Delegate.DynamicInvokeImpl(Object[] args)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.BuildContext.<>c__DisplayClass2.<InvokeInternal>b__0(Object state)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.WaitCallback_Context(Object state)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.PerformWaitCallbackInternal(_ThreadPoolWaitCallback tpWaitCallBack)2009-07-08 15:48:14,757 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.PerformWaitCallback(Object state)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] Unhandled Exception: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: A call is made on an inactive IBuildEngine interface corresponding to a task that already finished execution.2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Shared.ErrorUtilities.ThrowInvalidOperation(String resourceName, Object[] args)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.BuildEngine.EngineProxy.LogMessageEvent(BuildMessageEventArgs e)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Utilities.TaskLoggingHelper.LogMessage(MessageImportance importance, String message, Object[] messageArgs)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at Microsoft.Build.Utilities.TaskLoggingHelper.LogMessage(String message, Object[] messageArgs)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.MSBuild.MSBuildTrace.TraceLine(String message)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.BuildContext.<>c__DisplayClass13.<TraceLine>b__12()2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] --- End of inner exception stack trace ---2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.RuntimeMethodHandle._InvokeMethodFast(Object target, Object[] arguments, SignatureStruct& sig, MethodAttributes methodAttributes, RuntimeTypeHandle typeOwner)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.RuntimeMethodHandle.InvokeMethodFast(Object target, Object[] arguments, Signature sig, MethodAttributes methodAttributes, RuntimeTypeHandle typeOwner)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture, Boolean skipVisibilityChecks)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Delegate.DynamicInvokeImpl(Object[] args)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at DaveSexton.DocProject.BuildContext.<>c__DisplayClass2.<InvokeInternal>b__0(Object state)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.WaitCallback_Context(Object state)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.PerformWaitCallbackInternal(_ThreadPoolWaitCallback tpWaitCallBack)2009-07-08 15:48:15,398 [Project - Server Sandcastle:DEBUG] at System.Threading._ThreadPoolWaitCallback.PerformWaitCallback(Object state)

Commented Feature: Cancel Help Build Gracefully

carl_cerecke — Fri, 10 Jul 2009 04:07:39 GMT

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=61788

In BuildProcess.cs, if I determine that the build need not continue, how do I finish gracefully? If I call System.Environment.Exit(0), and running in Visual Studio, Visual Studio disappears. If I call context.Cancel(), Cruisecontrol.net sees it as a failed build. How can I exit gracefully when run from either VS or CC.net?
Comments: ** Comment from web user: carl_cerecke **

A workaround is to simply remove all remaining BuildSteps:

BuildStepCollection steps = context.Steps;

while (steps.Count > context.CurrentStepIndex + 1) {
TraceLine("Removing step " + steps[context.CurrentStepIndex + 1].Name);
steps.Remove(steps[context.CurrentStepIndex + 1]);
}

Created Feature: Cancel Help Build Gracefully

davedev — Fri, 10 Jul 2009 03:49:14 GMT

Commented Issue: OutOfMemoryException during build step: Apply Dynamic Topic Filters

davedev — Sat, 04 Jul 2009 03:10:48 GMT

When we build our Docproject in Visual Studio 2008 it crashes with out of memory exception.

Stack trace from the Event log:

Step 4 System.OutOfMemoryException: Apply Dynamic Topic Filters:

System.OutOfMemoryException: Exception of type 'System.OutOfMemoryException' was thrown.
at DaveSexton.DocProject.Engine.BuildStepExecutionEngine.ExecuteStepAsync(IBuildStep step, Boolean outOfBand)
at DaveSexton.DocProject.Engine.BuildStepExecutionEngine.ExecuteStep(IBuildStep step, Int32 number, Boolean outOfBand, Exception& exception)

The dynamicFilters.xml contains:

<?xml version="1.0" encoding="utf-8"?>
<filters>
<filter type="DaveSexton.DocProject.Sandcastle.TopicManagement.CategoryTopicFilter">
<build>True</build>
<types></types>
<access>Internal, Private</access>
</filter>
<filter type="Omada.DocSiteCustomization.NamespaceMembersTopicFilter, Omada.DocSiteCustomization, Version=1.0.0.0, Culture=neutral, PublicKeyToken=fd90371937d85573">
<Namespace>Omada.OE.Web</Namespace>
</filter>
</filters>

Size of Reflection.xml is 175 MB.
Works ok with smaller amount of data.
Comments: ** Comment from web user: davedev **

OutOfMemoryException seems to happen randomly on some projects when building in VS. As far as I can tell, the cause is process memory fragmentation and it cannot be controlled.

Have you tried building in the DocProject External UI or on the command-line using MSBuild.exe?

Here are some related discussions:

http://docproject.codeplex.com/Thread/View.aspx?ThreadId=12222
http://social.msdn.microsoft.com/Forums/en-US/devdocs/thread/4e5820b9-5779-4464-905c-aceddd40f9ca/
http://social.msdn.microsoft.com/Forums/en-US/devdocs/thread/ea53a416-8e19-4417-8f03-ade4677ebe6c/
http://social.msdn.microsoft.com/forums/en-US/devdocs/thread/0ad646b1-290d-4053-8d11-d70fba560c4a/

Created Issue: OutOfMemoryException during build step: Apply Dynamic Topic Filters

hbeomadadk — Fri, 03 Jul 2009 12:38:37 GMT

Created Feature: Conceptual Image Sub-folders

davedev — Tue, 23 Jun 2009 03:04:19 GMT

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=60258

Update the comments in the conceptual_art.xml to remove the part about the file attribute supporting a relative path. Alternatively, consider updating and redistributing the ResolveArtLinksComponent.

Created Feature: Topic Preview and Option to Suppress Conceptual or Reference Builds

davedev — Sat, 20 Jun 2009 22:19:27 GMT

Original discussion:
http://docproject.codeplex.com/Thread/View.aspx?ThreadId=60116

I'm new to DocProject and Sandcastle. I noticed SHFB has "preview" feature that allows one to build a selected topic only, instead of the entire project. Does DocProject have a similar feature?

Right now, I have to build the entire project in order to see how a topic would look in the final output, but that is extremely unproductive, because the APIs can take some time to build. Maybe there is a way to skip building the reference API, but I haven't configured out how to do that.

Commented Issue: directory cpref_reflection not found

davedev — Wed, 17 Jun 2009 14:43:53 GMT

I don't know if this is a sandcastle or DocProject problem, but I reinstalled both from scratch and created a new project that referenced a new project with a single class and single comment. The build failed with a number of errors. The first error was about missing the cpref_reflection folder, and the other is about a missing type in the BuildComponents dll. Following is a fragment from the output:

Step 9 of 15: Build Assembler {sandcastle.help2x.config}

Info: Instantiating component.
Info: Loading data file '..\..\Help\Presentation\Style\Transforms\skeleton.xml'.
Info: Instantiating component.
Info: Searching for files that match 'reflection.xml'.
Info: Searching for files that match 'C:\Program Files\Sandcastle\\Data\cpref_reflection\*.xml'.
Error: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.IO.DirectoryNotFoundException: Could not find a part of the path 'C:\Program Files\Sandcastle\Data\cpref_reflection'.
at System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
at System.IO.Directory.InternalGetFileDirectoryNames(String path, String userPathOriginal, String searchPattern, Boolean includeFiles, Boolean includeDirs, SearchOption searchOption)
at System.IO.Directory.GetFiles(String path, String searchPattern, SearchOption searchOption)
at System.IO.Directory.GetFiles(String path, String searchPattern)
at Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocuments(String wildcardPath)
at Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocuments(String baseDirectory, String wildcardPath, Boolean recurse)
at Microsoft.Ddue.Tools.CopyFromIndexComponent..ctor(BuildAssembler assembler, XPathNavigator configuration)
Error: The type 'Microsoft.Ddue.Tools.CopyFromIndexComponent' was not found in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'.
Info: Instantiating component.
Error: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
at System.ThrowHelper.ThrowKeyNotFoundException()
at System.Collections.Generic.Dictionary`2.get_Item(TKey key)
at Microsoft.Ddue.Tools.CopyFromIndexComponent..ctor(BuildAssembler assembler, XPathNavigator configuration)
Error: The type 'Microsoft.Ddue.Tools.CopyFromIndexComponent' was not found in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'.
Info: Instantiating component.
Info: Loading subcomponents.
Info: Instantiating component.
Error: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
at System.ThrowHelper.ThrowKeyNotFoundException()
at System.Collections.Generic.Dictionary`2.get_Item(TKey key)
at Microsoft.Ddue.Tools.CopyFromIndexComponent..ctor(BuildAssembler assembler, XPathNavigator configuration)
Error: The type 'Microsoft.Ddue.Tools.CopyFromIndexComponent' was not found in the component assembly 'C:\Program Files\Sandcastle\\ProductionTools\BuildComponents.dll'.
Info: Loaded 1 subcomponents.
Comments: ** Comment from web user: davedev **

Try the following:

1. Uninstall Sandcastle and make sure that the entire directory is deleted.
2. Reinstall the latest version of Sandcastle from http://sandcastle.codeplex.com
3. If an SDK is installed, delete the DXROOT user environment variable.
4. Reboot.
5. Create a new DocProject or DocSite - this will ensure that the project imports the latest files from Sandcastle.

See the Latest Release Notes for details: http://docproject.codeplex.com/Wiki/View.aspx?title=Latest%20Release%20Notes

Commented Issue: directory cpref_reflection not found

davedev — Wed, 17 Jun 2009 14:37:52 GMT

Try the following:

See the Latest Release Notes for details: http://docproject.codeplex.com/Wiki/View.aspx?title=Latest%20Release%20Notes

Commented Issue: directory cpref_reflection not found

Bhavesh — Wed, 17 Jun 2009 05:01:07 GMT

I also removed DXROOT but it does not solve problem.
Can someone please help me?

Bhavesh

Commented Issue: directory cpref_reflection not found

Bhavesh — Tue, 16 Jun 2009 13:22:11 GMT

Hey,
I also get same error.
Could not find a part of the path 'C:\Program Files\Sandcastle\Data\Cpref_reflection'

Reinstalling does not solve the problem?
Dose sequence matter?

Closed Issue: Image files not displayed in HxS

davedev — Thu, 23 Apr 2009 08:44:12 GMT

When building an HxS file, image files with whitespace in the filenames are not displayed.

By decompressing the HxS file it can be seen that no image files from the DocProject's 'Art' directory are copied into the compiled HxS file's 'art' directory.
Comments: If you look in the build output window where the MS Help 2 compiler lists the files being saved, you'll see an error message like the following somewhere in the list:

Error: HXC3023: Failed to open file some%20name%20with%20spaces.jpg

The above error indicates that a file name contains URL-encoded spaces, which are obviously incorrect in a local file path. This seems to be an MS Help 2 compiler issue and not a DocProject or Sandcastle issue.

I attempted to verify this by running hxcomp.exe on the command line and passing in the .HxC file that Sandcastle generated for my test DocProject. The .HxC file seems standard and simply references the .HxT and other files in the project, all of which seem to be standard as well. And none of these files seem to be related to the URL-escaping of white spaces in the image URL unless there's some abstract MS Help 2 setting, of which I'm unaware, to control this. The XML documentation that I tested has a regular HTML image tag without escape characters in the path; e.g., . The only reference to this file that I've found is in the files.HxF file, and even that's simply a wildcard path; e.g., Url="art\*.jpg".

Therefore, I'm going to conclude that this is an MS Help 2 compiler issue that I cannot fix. We'll just have to refrain from using spaces in image file names unless somebody (probably not MS) can provide an alternative solution.

Commented Issue: Image files not displayed in HxS

davedev — Thu, 23 Apr 2009 07:49:39 GMT

Thanks for reporting this issue. I was able to reproduce it and I'm investigating whether it's a DocProject issue or an HxS compiler issue.