Doxygen C#XMLコメントと汎用学はHTML出力でリンクを生成しません
-
12-12-2019 - |
質問
私はネット上で何かを見つけることができませんでした、そして私はdoxygenのXMLコメントサポートに非常に無知です。
私の問題はこれと同じくらい簡単です:
/// <see cref="GenericClass{TTypeparam}"/>
.
XMLコメントでオープンジェネリックを参照する正しい方法であると思われるは、Doxygenの出力にリンクを生成しません。Cref属性から出力にテキストをコピーします。
GenericSetagCodeを使用して、GenericsへのリンクがカスタムページからDoXygenで機能することを知っています。これは既知のバグですか、それとも何か明白なものが恋しいですか?
btw。Doxygen 1.8.2 を使用しています
解決
doxygenは現時点でCref内の{..}構文をサポートしていません。これをバグとして考えることができます。Doxygenのバグトラッカーでバグレポートをお気軽に送信してください。
他のヒント
Doxygenは現時点でのジェネリックを処理するための良い方法があるようではないようです(1.8.8)標準のマイクロソフトサポートXML形式({...}構文を使用しています))そして「GenericClass」または「\ ref GenericClass」を使用するように切り替えます(どちらも、Visual Studioツールが不正でないという無効なXMLはもちろんです)。
Doxygenのバグ https://bugzilla.gnome.org/show_bug.cgi?ID= 738173 、 https://bugzilla.gnome.org/show_bug.cgi?ID= 738167 と https://bugzilla.gnome.org/show_bug.cgi.?ID= 704090
所属していません StackOverflow