Конвертировать Doxygen в XML комментарии - PullRequest
4 голосов
/ 23 марта 2010

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

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

Ответы [ 2 ]

3 голосов
/ 19 марта 2016

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

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

Кроме того, я добавил совершенно новый вариант решения AWK-сценария: Ссылка

Так как оригинальный скрипт на python у меня не работал, потому что в моем случае у нас была «\ краткая» запись вместо «@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";

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

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

3 голосов
/ 18 марта 2011

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

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

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...