一部の C++/CX インターフェイスのドキュメントを XML コメントとして作成しようとしています。結果は、Doxygen と VC++ 独自のオプションによって解析され/doc
ます。
各インターフェイス メンバーのドキュメントでは、<see cref="..."/>
構文を使用して、同じインターフェイスのメンバーを相互参照したり、前方宣言された他の型を相互参照したりできます。しかし、別のインターフェイスのメンバーを参照するための適切な構文は何ですか?
私の試みはすべてコンパイラ警告を生成します:
C4638: XML ドキュメントのコメントが ... に適用されました: 不明なシンボルへの参照 ...
この質問とその回答を見てきましたが、インターフェイス クラスのメンバーを前方宣言することはできませんか? また、循環性のため、参照を含むインターフェイスの前に、参照される各インターフェイスの宣言を含めることを常に確認できるとは限りません。
インターフェイスがクラスである場合、XML コメントは関数の宣言ではなく実装に配置できると理解していますが、インターフェイスの場合、XML コメントを移動できるメンバーの実装はありません。