Search code examples
msbuildsandcastle

Using Sandcastle Help File Builder with MSBuild


How can I make Sandcastle Help File Builder create help files from projects being built using MSBuild?


Solution

  • I have an MSBuild Target that builds my documentation in my build-script.

    This target uses Sandcastle Helpfile Builder.

    It is done like this:

    <Target name="builddoc" DependsOnTargets="buildall">
    
       <ItemGroup>
          <Assemblies Include="-assembly=$(outputdir)\myassembly.dll" />
          <Assemblies Include="-assembly=$(outputdir)\anotherassembly.dll" />
       </ItemGroup>
    
       <Exec Command="$(double_quote)$(SandcastleHFBCmd)$(double_quote) sandcastleproj.shfb$(double_quote) @(assemblies, ' ') outputpath=$(outdir)
    </Target>