Convertir Doxygen aux commentaires XML

Question

Nous avons un projet C # qui pour des raisons historiques et utilise à la fois Doxygen commentaires visuels de style Studio dans le même code. Quelqu'un at-il essayé de traduire systématiquement une norme à l'autre, de préférence au sous-ensemble XML commun?

Je suppose que ce ne serait pas trop difficile d'écrire un script pour couvrir les caractéristiques les plus communes, mais je ne voudrais pas réinventer la roue.

Answer 1

Je sais que cela a été un moment que vous avez demandé, mais je suis tombé sur le même problème. Voici mon projet open source de 10 minutes qui devrait faire la conversion d'un peu moins indolore. :-) Les extensions sont les bienvenus!

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

Answer 2

La réponse originale à cette question ne comprenait également que un lien, donc je fais la même chose:

Tout d'abord le lien ci-dessus est ancienne, voici une version plus récente du lien: lien ,

En plus j'ai ajouté une toute nouvelle variante de script AWK de la solution: Lien

Depuis le script python d'origine ne fonctionnait pas pour moi parce que, dans mon cas, nous avions « \ brève » notation au lieu de « @brief », donc je peux écrire mon propre. (Je ne parle pas encore python)

L'une des principales caractéristiques est importante que vous pouvez facilement ajouter une traduction de l'étiquette, ou sauter certains d'entre eux:

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

Plus tard j'ai aussi trouvé la nouvelle version du script python original, donc j'espère que personne ne à le démarrer à partir de zéro à nouveau!

Si je l'avais trouvé « juste le lien » pour le nouveau script plus tôt, il pourrait me protéger contre certains maux de tête.