Convert Doxygen to XML Comments

Question

We have a C # project that, for historical reasons, uses both Doxygen and Visual Studio comments in the same code. Has anyone tried to systematically translate one standard into another, preferably into a common subset of XML?

I think it would not be easy to write a script to cover the most common functions, but I would not want to reinvent the wheel.

Answer 1

I know that some time has passed since you asked, but I ran into the same problem. Here is my 10 minute open source project, which should make the conversion a little less painless. :-) Extensions are welcome!

https://code.google.com/p/doxygentoxmlconverter/

Answer 2

The original answer to this question also included only the link, so I am doing the same thing:

First, the link above is old, here is the newer version of the link: Link ,

In addition, I added a completely new AWK script solution: Link

Since the original python script did not work for me, because in my case we had a "\ short" notation instead of "@brief", so I wrote my own. (I'm not speaking python yet)

One important key feature is that you can easily add tag translations or skip some of them:

translate["\\fn"] = "skip"; translate["\\def"] = "skip"; translate["\\class"] = "skip"; translate["\\enum"] = "skip"; translate["\\struct"] = "skip"; translate["\\author"] = "skip"; translate["\\brief"] = "summary"; translate["\\param"] = "param"; translate["\\return"] = "returns"; 

Later, I also found a new version of the original python script, so I hope that no one should run it again from scratch!

If I found a “link only” to a new script before, it could protect me from some headache.