views:

37

answers:

1

Hi,

I'm mystified: I'm using Visual Studio 2008 with C++ (non-CLI), and I can't for the life of me work out how to build the help file with Sandcastle.

Once its installed, and its generating an .xml file, shouldn't there be a menu option somewhere to switch on the build of the docs? Or at least a menu option to trigger the build of the docs?

+1  A: 

I don't believe sandcastle works with doxygen.

Sandcastle actually has nothing to do with managed or unmanaged projects. Sandcastle works against a set of XML documents that are typically generated during the build process. If you manually built the xml, you could make it generate docs for Smalltalk.

That said, while its most common usage is in the managed world, it is certainly supported for native C++ as well. The key is that the visual studio supports pulling xml documentation out of C++ compiled without the /clr switch, and those same XML files can be provided to Sandcastle for your document generation.

Greg D
Yes, sandcastle is separate from doxygen. I'm already using doxygen, but I'd like to try Sandcastle. I'm thinking that Sandcastle may *only* be for .NET projects (i.e. not for C++ projects that do not use .NET). Is this a valid assumption?
Gravitas
@Gravitas: I edited my answer to address your question.
Greg D