2010-03-23 5 views
4

У нас есть проект C#, который по историческим причинам использует как комментарии Doxygen, так и Visual Studio в том же коде. Кто-нибудь пытался систематически переводить один стандарт в другой, предпочтительно в общий подмножество XML?Преобразование Doxygen в XML-комментарии

Я думаю, было бы не слишком сложно написать сценарий для покрытия наиболее распространенных функций, , но я бы не хотел изобретать колесо.

ответ

3

Я знаю, что прошло некоторое время с тех пор, как вы спросили, но я столкнулся с той же проблемой. Вот мой 10-минутный проект с открытым исходным кодом, который должен сделать преобразование немного менее безболезненным. :-) Расширения приветствуются!

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

3

оригинальный ответ на этот вопрос тоже включен только ссылку, так что я сделать то же самое:

Сначала выше ссылка старая, вот новая версия ссылка: Link,

Рядом я добавил совершенно новый AWK вариант сценария решения: Link

Поскольку исходный питон скрипт не работает для меня, потому что в моем случае мы имели «\ краткое "обозначение вместо" @brief ", поэтому я написал свое. (Я не говорю питон пока)

Одной из важных особенностей ключ является то, что вы можете легко добавить перевод тегов, или пропустить некоторые из них:

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

Позже я нашел новую версию оригинального питона сценарий, поэтому я надеюсь, что никто не должен снова начинать с нуля!

Если бы я нашел «только ссылку» на новый скрипт раньше, он мог бы защитить меня от некоторой головной боли.