missing namespaces

Topics: Bugs, General Questions, Help 1.x/2.x, Sandcastle
Apr 1, 2009 at 5:11 AM
To all-
     So far, I was unable to find help on this issue.  I have installed sandcastle, and DocProject.  I have created a new docproject in my sulutionspace, and I referenced 3 projects, 2 of them VB and 1 of them C#.  I used GhostDoc http://www.roland-weigelt.de/ghostdoc/ to comment my C# project.  However, I was hoping that my comments would show up in the compiled docproject .chm files.  I see namespaces available for the 2 vb projects, however some namespaces are not documented.

According to the output window, the build process was completely successful.  However, I do not understand why some namespaces were not compiled.

I'm fairly new to this, and would not know how to start debugging.  Any feedback would be greatly appreciated.

Thanks
Leor
Coordinator
Apr 1, 2009 at 1:43 PM
Hi Leor,

By default Sandcastle only documents public APIs.  If your APIs are internal then you can open the DocProject Properties window for your project and set the Build | Documentation scope property to Complete.

Please let me know if that solves your problem.

- Dave
Apr 1, 2009 at 6:24 PM
Wow, thanks, that worked.

I have generated VS2005 type docs.  However, I have not seen the comments found in the "summary" tag show up in the docs.  Any feedback on this one?  I went to the DocProject properties and did not notice any settings that I think would fix this...

thanks again
Coordinator
Apr 1, 2009 at 7:39 PM
Edited Apr 1, 2009 at 7:40 PM
Hi Leor,

Make sure that you enable XML documentation output on all of your source projects for the current solution configuration.

http://msdn.microsoft.com/en-us/library/x4sa0ak0.aspx

Both of these questions are answered in the How To Diagnose and Resolve Issues topic: 

 http://docproject.codeplex.com/Wiki/View.aspx?title=How%20to%20Diagnose%20and%20Resolve%20Issues

You can find additional topics in the Wikimap:

http://docproject.codeplex.com/Wiki/View.aspx?title=Wikimap 

- Dave