2010-03-23 20 views
4

Nous avons un projet C# qui, pour des raisons historiques, utilise les commentaires de style Doxygen et Visual Studio dans le même code. Est-ce que quelqu'un a essayé de traduire systématiquement un standard à un autre, de préférence au sous-ensemble XML commun?Convertir Doxygen en commentaires XML

Je suppose qu'il ne serait pas trop difficile d'écrire un script pour couvrir les fonctionnalités les plus courantes, mais je ne voudrais pas réinventer la roue.

Répondre

3

Je sais que cela fait un moment que vous avez demandé, mais j'ai rencontré le même problème. Voici mon projet open source de 10 minutes qui devrait rendre la conversion un peu moins indolore. :-) Les extensions sont les bienvenues!

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

3

La réponse originale à cette question a également fait seulement inclus un lien, donc je fais la même chose:

D'abord le lien ci-dessus est vieux, voici une version plus récente du lien: Link,

a côté j'ai ajouté une toute nouvelle variante de script AWK de la solution: Link

Depuis le script python d'origine n'a pas fonctionné pour moi parce que, dans mon cas, nous avions « \ Bref "notation au lieu de" @brief ", alors j'ai écrit le mien. (Je ne parle pas python encore)

Une caractéristique clé importante est 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 python d'origine script, donc j'espère que personne ne doit recommencer à zéro!

Si j'avais trouvé "juste le lien" vers le nouveau script plus tôt, cela pourrait me protéger d'un mal de tête.