Doxygen C # XML-Kommentare und Generika generieren keine Links in der HTML-Ausgabe

Question

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

Answer 1

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.

Answer 2

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