Doxygen C # XML-Kommentare und Generika generieren keine Links in der HTML-Ausgabe
-
12-12-2019 - |
Frage
Ich konnte nichts über das Netz finden, und ich bin ziemlich ahnungslos für den XML-Kommentarunterstützung in Doxygen.
Mein Problem ist so einfach wie diese: generasacodicetagpre.
Das scheint mir der richtige Weg, um auf eine offene generische In XML-Kommentare zu referenzieren, erzeugt keine Verbindung in der Doxygen-Ausgabe.Es kopiert den Text einfach aus dem CREF-Attribut an den Ausgang.
Ich weiß, dass die Verknüpfung auf Generics in Doxygen von benutzerdefinierten Seiten unter Verwendung von GenericClass<TTypeParam>
arbeitet.So ist das ein bekannter Fehler, oder habe ich etwas offensichtlich vermisst?
btw.Ich benutze Doxygen 1.8.2
Lösung
doxygen unterstützt die {.} Syntax in der Syntax im Moment nicht.Sie könnten dies als Fehler betrachten.Fühlen Sie sich frei, einen Fehlerbericht in Doxygens Bug-Tracker für diese einzureichen.
Andere Tipps
doxygen scheint einfach nicht einen guten Weg zu haben, Generika im Moment (in 1.8.8) zu handhaben - es sei denn, Sie freuen sich, das Standard-Microsoft-unterstütztes XML-Format zu vergessen (welche {...} Syntax verwendet) und wechseln Sie zur Verwendung von "genericclass" oder "\ ref genericclass" (beide sind natürlich ungültig xml, dass das visuelle Studio-Tooling nicht gefällt).
siehe Doxygen Bugs https://bugzilla.gnome.org/show_bug.cgi?ID= 738173 , https://bugzilla.gnome.org/show_bug.cgi?ID= 738167 und https://bugzilla.gnome.org/show_bug.cgi? ID= 704090