私は、C++ のような言語を使用してさまざまなメソッドを定義する独自のツールに取り組んでいます。このツールは、これらのメソッドを .so ファイルにコンパイルするための独自のコンパイラを提供します。C++ の「宣言定義」構文には従いませんが、それ以外は非常に似ています。コード例は次のようになります。
method _foo::bar(var message) {
// do something with 'message' here
}
次のようにdoxygenを使用してこの方法を文書化しようとしました:
/**
* @brief this method does something with @a message.
*/
method _foo::bar(var message) {
// do something with 'message' here
}
しかし、これは私に警告を与えました:
warning: documented function `method _foo::bar' was not declared or defined.
@fn method _foo::bar()
、@fn _foo::bar
、および@fn bar
をコメント ブロックに (1 つずつ)追加しようとしましたが、どちらも@brief
ドキュメントにメッセージが追加されませんでした。
ここで Stack Overflow を検索しましたが、このポストDoxygen コメント with undeclared functions in C++ headersが私の質問に最も近いですが、私の問題にはまったく対応していません。
宣言されていないという事実に関係なく、関数のドキュメントを生成するように doxygen を構成する方法はありますか?