Convertir a Doxygen comentarios XML

Question

Tenemos un proyecto de C # que por razones históricas utiliza tanto comentarios de estilo de Visual Studio Doxygen y en el mismo código. Alguien ha tratado de traducir sistemáticamente un estándar a otro, preferiblemente al subconjunto común XML?

supongo que no sería demasiado difícil escribir un guión para cubrir las características más comunes, pero no me gustaría volver a inventar la rueda.

Answer 1

Sé que ha sido un tiempo ya que lo preguntas, pero me encontré con el mismo problema. Aquí está mi proyecto de código abierto 10 minutos que debe hacer el convertir un poco menos doloroso. :-) Las extensiones son bienvenidos!

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

Answer 2

La respuesta original a esta cuestión también sólo incluía un enlace, por lo que yo hago lo mismo:

En primer lugar el enlace anterior es viejo, aquí hay una versión más nueva del enlace: Enlace ,

Además de que he añadido una nueva variante de secuencia de comandos de AWK de la solución: Enlace

Desde el guión original de Python no funcionó para mí porque en mi caso que tenía "\ breve" notación en lugar de "@brief", así que escribí mi propia. (No hablo pitón aún)

Una característica clave importante es que se puede añadir fácilmente la traducción de etiquetas, o pasar por alto algunos de ellos:

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

Más tarde también se encuentra la nueva versión del script en Python original, por lo que espero que nadie tiene que empezar desde cero otra vez!

Si hubiera encontrado “sólo el vínculo” para el nuevo guión anterior, podría protegerme de algunos dolores de cabeza.