Code documentation tool (C++ to XML)
-
Hi! I'm looking for a source documentation tool that uses a Doxygen like documenting syntax (/** or /// or /!* etc) but produces XML-files that are compatible to the default C#-xml-documentation. I'd like to use the output in NDoc to create the final chm-files. Does anybody know about such a tool? - Andre
-
Hi! I'm looking for a source documentation tool that uses a Doxygen like documenting syntax (/** or /// or /!* etc) but produces XML-files that are compatible to the default C#-xml-documentation. I'd like to use the output in NDoc to create the final chm-files. Does anybody know about such a tool? - Andre
I seem to remember reading somewhere in the documentation that Doxygen could do this already. It might be worth doing a bit more digging. Having said that I've only looked at it briefly! Anna :rose: www.annasplace.me.uk
"Be yourself - not what others think you should be"
- Marcia GraeschTrouble with resource IDs? Try the Resource ID Organiser Add-In for Visual C++
-
I seem to remember reading somewhere in the documentation that Doxygen could do this already. It might be worth doing a bit more digging. Having said that I've only looked at it briefly! Anna :rose: www.annasplace.me.uk
"Be yourself - not what others think you should be"
- Marcia GraeschTrouble with resource IDs? Try the Resource ID Organiser Add-In for Visual C++
doxygen can output xml, but of course it has a different structure than the xml output by c# compiler. e.g.: C# compiler: [code] CSDocTest Brief description for Foo Main entry point. Commandline-parameters This is a test This function is not tested yet [/code] Class doc by doxygen:[code] CSDocTest::Foo CSDocTest::FooMain void void CSDocTest::Foo::Main (string[] args) Main string args [] Main entry point. args Commandline-parameters This is a test! This function is not tested yet Brief description for FooFoo. [/code] You see, not very s
-
doxygen can output xml, but of course it has a different structure than the xml output by c# compiler. e.g.: C# compiler: [code] CSDocTest Brief description for Foo Main entry point. Commandline-parameters This is a test This function is not tested yet [/code] Class doc by doxygen:[code] CSDocTest::Foo CSDocTest::FooMain void void CSDocTest::Foo::Main (string[] args) Main string args [] Main entry point. args Commandline-parameters This is a test! This function is not tested yet Brief description for FooFoo. [/code] You see, not very s
I see what you mean. Having said that, it may well be feasible to use XSLT to transform the Doxygen style XML to a more useful format. :cool: It might be worth reading up on XSLT transformations. There's a bunch of articles on MSDN - just do a search. Good luck. Anna :rose: www.annasplace.me.uk
"Be yourself - not what others think you should be"
- Marcia GraeschTrouble with resource IDs? Try the Resource ID Organiser Add-In for Visual C++