Converta doxygen em comentários XML
-
21-09-2019 - |
Pergunta
Temos um projeto C# que, por razões históricas, usa comentários no estilo doxygen e visual studio no mesmo código. Alguém tentou traduzir sistematicamente um padrão para outro, de preferência para o subconjunto XML comum?
Eu acho que não seria muito difícil escrever um script para cobrir os recursos mais comuns, mas eu não gostaria de reinventar a roda.
Solução
Eu sei que já faz um tempo desde que você perguntou, mas encontrei o mesmo problema. Aqui está o meu projeto de 10 minutos de código aberto que deve tornar a conversão um pouco menos indolor. :-) As extensões são bem-vindas!
Outras dicas
A resposta original a esta pergunta também incluiu apenas um link, então eu faço o mesmo:
Primeiro, o link acima é antigo, aqui está uma versão mais recente do link: Link,
Além disso, adicionei uma variante de script completamente nova da solução: Link
Como o script Python original não funcionou para mim porque, no meu caso, tínhamos notação " breve" em vez de "@brief", então eu escrevi o meu. (Eu não falo python ainda)
Um recurso importante importante é que você pode adicionar facilmente a tradução de tags ou pular alguns deles:
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";
Mais tarde, também encontrei a nova versão do script Python original, então espero que ninguém tenha que iniciá -lo do zero novamente!
Se eu tivesse encontrado "apenas o link" para o novo script anteriormente, isso poderia me proteger de alguma dor de cabeça.