将Doxygen转换为XML注释

时间:2010-03-23 11:34:04

标签: c# .net visual-studio doxygen xml-comments

我们有一个C#项目,由于历史原因,在同一代码中使用Doxygen和Visual Studio样式注释。 有没有人试图系统地将一个标准翻译成另一个标准,最好是普通的XML子集?

我想编写一个脚本来覆盖最常见的功能并不太难, 但我不想重新发明轮子。

2 个答案:

答案 0 :(得分:3)

我知道你提问已经有一段时间了,但我遇到了同样的问题。这是我的10分钟开源项目,应该使转换变得不那么轻松。 :-)欢迎扩展!

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

答案 1 :(得分:3)

这个问题的原始答案也只包含一个链接,所以我也这样做:

首先上面的链接是旧的,这是链接的更新版本:Link

除了我添加了解决方案的全新AWK脚本变体:Link

由于原始的python脚本对我不起作用,因为在我的情况下我们有“\ brief”符号而不是“@brief”,所以我自己写了。 (我还不会说python)

一个重要的关键功能是您可以轻松添加标签翻译,或跳过其中一些:

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";

后来我也找到了原版python脚本的新版本,所以我希望没有人再从头开始吧!

如果我之前找到了“只是链接”到新脚本,它可以保护我免受一些麻烦。