Could not find a part of the path 'C:\APIProject\Working\_2009)\'.

Topics: Developer Forum, Project Management Forum, User Forum
Aug 28, 2010 at 5:28 PM

Hi,

I'm having trouble getting SHFB to complile my api documentation. I have successfully built documentation on other machines, but this latest installation has some issues.

 

I'm running the latest builds of .NET 4.0, SHFB, Sandcastle, HTML Help Workshop....

This is the error that surfaces:

 

GenerateRefInfo:

MrefBuilder (v2.6.10621.1)

Copyright c Microsoft 2006

MREFBUILDER : error : An error occured while loading dependency assemblies. The error message is: Could not find a part of the path 'C:\APIProject\Working\_2009)\'.

Last step completed in 00:00:00.9191

-------------------------------

 

This is my SHFB configuration file:

 

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="3.5">
  <PropertyGroup>
    <!-- The configuration and platform will be used to determine which
         assemblies to include from solution and project documentation
         sources -->
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <SchemaVersion>2.0</SchemaVersion>
    <ProjectGuid>{b648c037-fd97-4d58-ae7b-571bfcfeda99}</ProjectGuid>
    <SHFBSchemaVersion>1.9.0.0</SHFBSchemaVersion>
    <!-- AssemblyName, Name, and RootNamespace are not used by SHFB but Visual
         Studio adds them anyway -->
    <AssemblyName>Documentation</AssemblyName>
    <RootNamespace>Documentation</RootNamespace>
    <Name>Documentation</Name>
    <!-- SHFB properties -->
    <OutputPath>C:\APIProject\Output\</OutputPath>
    <HtmlHelpName>ClearBelow</HtmlHelpName>
    <HtmlHelp2xCompilerPath>..\..\..\..\Program Files (x86)\HTML Help Workshop\</HtmlHelp2xCompilerPath>
    <DocumentationSources>
      <DocumentationSource sourceFile="attachments_2010_08_26\CloudPack.dll" />
      <DocumentationSource sourceFile="attachments_2010_08_26\CloudPack.xml" />
      <DocumentationSource sourceFile="attachments_2010_08_26\Common.dll" />
      <DocumentationSource sourceFile="attachments_2010_08_26\Common.xml" />
      <DocumentationSource sourceFile="attachments_2010_08_26\ResourceModel.dll" />
      <DocumentationSource sourceFile="attachments_2010_08_26\ResourceModel.xml" />
      <DocumentationSource sourceFile="attachments_2010_08_26\Utilities.dll" />
      <DocumentationSource sourceFile="attachments_2010_08_26\Utilities.xml" />
    </DocumentationSources>
    <HelpFileFormat>HtmlHelp1, Website</HelpFileFormat>
    <BuildLogFile>POCXmlDoc\AgreementManagement\AgreementManagement\bin\Debug\API.log</BuildLogFile>
    <CleanIntermediates>False</CleanIntermediates>
    <ComponentConfigurations>
      <ComponentConfig id="Cached Framework Comments Index Data" enabled="True">
        <component id="Cached Framework Comments Index Data" type="SandcastleBuilder.Components.CachedCopyFromIndexComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
          <index name="comments" value="/doc/members/member" key="@name" cache="100">
{@CachedFrameworkCommentList}
{@CommentFileList}
            </index>
          <copy name="comments" source="*" target="/document/comments" />
        </component>
      </ComponentConfig>
      <ComponentConfig id="Cached MSDN URL References" enabled="True">
        <component id="Cached MSDN URL References" type="SandcastleBuilder.Components.CachedResolveReferenceLinksComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll" locale="{@Locale}" linkTarget="{@SdkLinkTarget}">
          <cache filename="{@LocalDataFolder}Cache\MsdnUrl.cache" />
          <targets base="{@SandcastlePath}Data\Reflection" recurse="true" files="*.xml" type="{@SDKLinks}" />
          <targets files="reflection.xml" type="{@ProjectLinks}" />
        </component>
      </ComponentConfig>
      <ComponentConfig id="Cached Reflection Index Data" enabled="True">
        <component id="Cached Reflection Index Data" type="SandcastleBuilder.Components.CachedCopyFromIndexComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
          <index name="reflection" value="/reflection/apis/api" key="@id" cache="10">
            <cache base="{@SandcastlePath}Data\Reflection" recurse="true" files="*.xml" cacheFile="{@LocalDataFolder}Cache\Reflection.cache" />
            <data files="reflection.xml" />
          </index>
          <copy name="reflection" source="*" target="/document/reference" />
        </component>
      </ComponentConfig>
      <ComponentConfig id="Code Block Component" enabled="True">
        <component id="Code Block Component" type="SandcastleBuilder.Components.CodeBlockComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
          <!-- Base path for relative filenames in source attributes
                 (optional) -->
          <basePath value="{@HtmlEncProjectFolder}" />
          <!-- Connect to language filter (optional).  If omitted,
                 language filtering is enabled by default. -->
          <languageFilter value="true" />
          <!-- Allow missing source files (Optional).  If omitted,
                 it will generate errors if referenced source files
                 are missing. -->
          <allowMissingSource value="false" />
          <!-- Remove region markers from imported code blocks.  If omitted,
                 region markers in imported code blocks are left alone. -->
          <removeRegionMarkers value="false" />
          <!-- Code colorizer options (required).
                 Attributes:
                    Language syntax configuration file (required)
                    XSLT style file (required)
                    "Copy" image file URL (required)
                    Default language (optional)
                    Enable line numbering (optional)
                    Enable outlining (optional)
                    Keep XML comment "see" tags within the code (optional)
                    Tab size override (optional, 0 = Use syntax file setting)
                    Use language name as default title (optional) -->
          <colorizer syntaxFile="{@SHFBFolder}Colorizer\highlight.xml" styleFile="{@SHFBFolder}Colorizer\highlight.xsl" copyImageUrl="../icons/CopyCode.gif" language="cs" numberLines="false" outlining="false" keepSeeTags="false" tabSize="0" defaultTitle="true" />
        </component>
      </ComponentConfig>
      <ComponentConfig id="IntelliSense Component" enabled="True">
        <component id="IntelliSense Component" type="SandcastleBuilder.Components.IntelliSenseComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
          <!-- Output options (optional)
                 Attributes:
                    Include Namespaces (false by default)
                    Namespaces filename ("Namespaces" if not specified or empty)
                    Directory (current folder if not specified or empty) -->
          <output includeNamespaces="false" namespacesFile="Namespaces" folder="{@OutputFolder}" />
        </component>
      </ComponentConfig>
      <ComponentConfig id="Post-transform Component" enabled="True">
        <component id="Post-transform Component" type="SandcastleBuilder.Components.PostTransformComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
          <!-- Code colorizer files (required).
                 Attributes:
                    Stylesheet file (required)
                    Script file (required)
                    "Copy" image file (required) -->
          <colorizer stylesheet="{@SHFBFolder}Colorizer\highlight.css" scriptFile="{@SHFBFolder}Colorizer\highlight.js" copyImage="{@SHFBFolder}Colorizer\CopyCode.gif" />
          <!-- Base output path for the files (required).  This should match
                 the parent folder of the output path of the HTML files (see
                 SaveComponent). -->
          <outputPath value="Output\" />
          <!-- Logo image file (optional).  Filename is required. The height,
                 width, altText, placement, and alignment attributes are
                 optional. -->
          <logoFile filename="C:\Program Files\EWSoftware\Sandcastle Help File Builder\logo-accurate2.gif" height="0" width="0" altText="Irdeto Logo" placement="right" alignment="left" />
        </component>
      </ComponentConfig>
    </ComponentConfigurations>
    <MissingTags>AutoDocumentCtors, AutoDocumentDispose</MissingTags>
    <HelpFileVersion>62.13.0.5</HelpFileVersion>
    <HelpTitle>ClearBelow</HelpTitle>
    <FeedbackEMailAddress>support%40acoe.com</FeedbackEMailAddress>
    <CopyrightText>Copyright &amp;#169%3b 2010 APIProject</CopyrightText>
    <HtmlHelp1xCompilerPath>..\..\..\..\Program Files (x86)\HTML Help Workshop\</HtmlHelp1xCompilerPath>
    <SandcastlePath>..\..\..\..\Program Files (x86)\Sandcastle\</SandcastlePath>
    <WorkingPath>..\..\..\..\APIProject\Working\</WorkingPath>
    <FooterText>Copyright &amp;#169%3b 2010 APIProject</FooterText>
    <FeedbackEMailLinkText>API Reference Feedback</FeedbackEMailLinkText>
    <NewProperty1>
    </NewProperty1>
    <NamingMethod>MemberName</NamingMethod>
    <IncludeStopWordList>False</IncludeStopWordList>
    <FrameworkVersion>4.0.30319</FrameworkVersion>
  </PropertyGroup>
  <!-- There are no properties for these groups.  AnyCPU needs to appear in
       order for Visual Studio to perform the build.  The others are optional
       common platform types that may appear. -->
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|Win32' ">
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|Win32' ">
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="MSBuild">
      <HintPath>..\..\..\..\Windows\Microsoft.NET\Framework64\v3.5\MSBuild.exe</HintPath>
    </Reference>
    <Reference Include="Wintellect.Threading">
      <HintPath>..\Wintellect_Power_Threading_Library_(May_26,_2009)\Wintellect.Threading.dll</HintPath>
    </Reference>
    <Reference Include="Wintellect.Threading.CompactFx">
      <HintPath>..\Wintellect_Power_Threading_Library_(May_26,_2009)\Wintellect.Threading.CompactFx.dll</HintPath>
    </Reference>
    <Reference Include="Wintellect.Threading.Silverlight">
      <HintPath>..\Wintellect_Power_Threading_Library_(May_26,_2009)\Wintellect.Threading.Silverlight.dll</HintPath>
    </Reference>
  </ItemGroup>
  <!-- Import the SHFB build targets -->
  <Import Project="$(SHFBROOT)\SandcastleHelpFileBuilder.targets" />
</Project> 

Coordinator
Aug 28, 2010 at 7:47 PM

The failing reference path doesn't match what's in the project file so most likely, something is having an issue with the path names.  Try moving the reference assemblies to a folder with a different, simpler name or to a sub-folder within the project and reference them from there.  You can also try using the Visual Studio Solution or project file that builds the documentation source assemblies and let SHFB figure out the references from the project files.

Eric

 

Aug 29, 2010 at 10:54 PM

Hi Eric,

Your suggestion about moving the assemblies worked great...trouble is I'm getting a new error:

C:\APIProject\Working\sandcastle.config

Replaced configuration for 'Microsoft.Ddue.Tools.CopyFromIndexComponent' (instance 3) with configuration for 'Cached Framework Comments Index Data'

Last step completed in 00:00:00.0210

-------------------------------

SHFB: Error BE0020: Unknown field tag: 'SDKLinks'

  

What do you make of that one? 

 

I found another thread dealing with that erorr:  This is what you wrote:

 

you can fix it by opening your SHFB project in a text editor and deleting both the ProjectLinkType and SdkLinkType properties if they exist in your project file.

I don't have those properties in the sandcastle project file but I still get the error. 

Many, many thanks!

Phil

 

Coordinator
Aug 30, 2010 at 1:16 AM

You need to update your ComponentConfigurations settings for some of the build components and delete the cache files if using the cached build components.  See the Breaking Changes section of the release notes for details.

Eric

 

Aug 30, 2010 at 4:17 PM

Thanks Eric...it works!!!

Phil