問題タブ [doxygen-addtogroup]

DSL (ドメイン固有言語) 用の Doxygen ドキュメントを生成したいと考えています。私の DSL 言語は C、C++、Java 言語とはまったく異なります。

基本的に私のものはEclipseプラグインプロジェクトであり、DSLプロジェクトからDoxygenを生成したいという点でDSL言語用のIDEを開発しています。

私はDoxygenのトピックに非常に慣れていません。続行するためのいくつかのアイデアを教えてください。

注: Java 用の Doxygen ドキュメントを生成できるように、依存関係を追加しました。私のDSL言語でそれを行う方法がわからないこと。

typedef 列挙型を含むヘッダー ファイルがあります。このヘッダーは変更できません。列挙型はプロジェクト内で使用されており、列挙型を文書化する必要があります。@enum doxygen コマンドを .dox ファイルに追加することでこれを行います。

これにより、INT_VALS のドキュメントのモジュール セクションにエントリが作成され、各列挙値がサブエントリとしてリストされます。各 enum 値も、個別のエントリとしてモジュールにリストされます。enum テーブルはドキュメントで正しく作成されます。

余分な個々の重複エントリではなく、INT_VALS エントリとその子エントリだけをモジュール インデックスに含めたいと考えています。

出力はhtmlです。

//私のdoxygenファイル:

EXTRACT_ALL = はい

EXTRACT_PRIVATE = いいえ

EXTRACT_PACKAGE = いいえ

EXTRACT_STATIC = いいえ

EXTRACT_LOCAL_CLASSES = はい

EXTRACT_LOCAL_METHODS = いいえ

HIDE_UNDOC_MEMBERS = はい

HIDE_UNDOC_CLASSES = いいえ

Doxygen が JavaScript ファイルをサポートしていないことは知っています。私はjs2doxy.plスクリプトとこれも見ました:

Doxygen で JavaScript を文書化する

最初のオプション (js2doxy.pl) は関連する C++ コードを生成せず、すべてのプロトタイプ メソッドをスキップして空白のままにします。2 番目のオプションは機能しますが、プロトタイプ ベースのプログラミングでは機能しません。プロトタイプ ベース (OOP) の JavaScript ファイルをサポートできるフィルターを探しています。私はそれについて多くのことを研究しましたが、より良いフィルターを見つけることができませんでした.

前もって感謝します！

この問題は、doxygen 解析の制約によるものです。組み込み C 開発用に、Kinetis Design Studio で Eclox (Eclipse プラグイン) とともに doxygen 1.8.11 を使用しています。

いくつかの非常に大きな静的配列が必要な場合を除いて、ほとんどすべての doxygen コンパイルが機能します。メイン コードを乱雑にしたくなかったので、これらのフォーラム ( https://stackoverflow.com/a/4645515/6776259 )で見つけたハックを使用しました。

残念ながら、そのハッキングが原因で、main.c のmain_moduleグループのコンパイルが失敗しています。次のエラーが発生します。

警告: グループ内でファイルの終わり

次のようなものを使用して、これらの定数をmain_moduleグループから除外しようとしました。

これにより、doxygen のコンパイル エラーは解消されますが、コンパイルされた doxygen のドキュメントには、Large_Array 宣言の後に何も含まれていません。したがって、2 番目の@addtogroupステートメントが機能していないようです。

簡単なものがありませんか？どんな助けでも大歓迎です。ありがとうございました。