Converti Doxygen in commenti XML

Question

Abbiamo un progetto C# che per ragioni storiche utilizza commenti in stile Doxygen e Visual Studio nello stesso codice.Qualcuno ha provato a tradurre sistematicamente uno standard in un altro, preferibilmente nel sottoinsieme XML comune?

Immagino che non sarebbe troppo difficile scrivere una sceneggiatura per coprire le caratteristiche più comuni, ma non vorrei reinventare la ruota.

Answer 1

So che è passato un po' di tempo dall'ultima volta che me lo hai chiesto, ma ho riscontrato lo stesso problema.Ecco il mio progetto open source di 10 minuti che dovrebbe rendere la conversione un po' meno indolore.:-) Le estensioni sono benvenute!

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

Answer 2

Anche la risposta originale a questa domanda includeva solo un collegamento, quindi faccio lo stesso:

Innanzitutto il collegamento sopra è vecchio, ecco una versione più recente del collegamento: Collegamento,

Inoltre ho aggiunto una variante dello script AWK completamente nuova della soluzione: Collegamento

Dato che lo script Python originale non ha funzionato per me perché nel mio caso avevamo la notazione "\brief" invece di "@brief", quindi ho scritto il mio.(Non parlo ancora Python)

Una caratteristica chiave importante è che puoi aggiungere facilmente la traduzione dei tag o saltarne alcuni:

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

Più tardi ho trovato anche la nuova versione dello script Python originale, quindi spero che nessuno debba ricominciarlo da zero!

Se avessi trovato prima "solo il collegamento" al nuovo script, questo potrebbe proteggermi da qualche mal di testa.