問題タブ [doxygen]

GUIからC計算コードを分割するためにリファクタリングしているレガシーCコードのコレクションがあります。これは、K&R スタイルの宣言である非常に再帰的な数学的コア コードによって複雑になります。関数パラメーターのネストされた使用のために、これらをANSI宣言に変換する試みをすでに放棄しました（最後の4つのコンパイラエラーを取得できませんでした）。

いくつかのファイルを純粋な DLL に移動し、公開する最小限のインターフェイスを決定する必要があります。これには、型付きインターフェイスを公開するためのラッパー関数の書き込みが必要になります。

重要なソース ファイルを Doxygen @callergraph マークアップでマークアップしたので、個々の関数について有益なグラフが生成されます。それを超えてやりたいことは、これらのグラフを統合して、外の世界に公開される関数の最も狭い境界を決定できるようにすることです。

元のヘッダー ファイルは役に立ちません。すべてが型指定されていない C 関数として公開されます。

何百もの関数があるため、生成されたコーラーグラフを簡単に検査するのは大変です。

ある種の DOT マージ ツールを作成することを検討しています。

これがグラフィカルなソリューションであることに執着しているわけではありません。誰かが別の分析ツール (無料または比較的安価) または Doxygen の XML 出力を使用して同じ目標を達成する手法を提案できれば、非常に嬉しく思います。

ファイル レベルで融合された callergraph は、単純なリストよりもクライアントのドキュメントに一定の魅力があります :-)

The html documentation generated by doxygen for enums lists the enum to the left and the documentation to the right. However I need quite detailed documentation for each value and some of the names are very long thus making the right column with the documentation appear far out to the right and it looks very bad. Is there no possibility to make the documentation for each value appear below or above the value instead of to the right ?

以前は C++ に doxygen ロットを使用していましたが、関数やメソッドの引数を///<, またはバリエーションを使用してインラインでドキュメント化する機能が本当に気に入っています。逆に、インライン スタイルを使用していないときにコメントで引数を繰り返さなければならないのは本当に嫌いです (ほとんどのオーバー コード ドキュメント システムのみがサポートされているため)。

そのため、最近、Objective-C コードで doxygen をセットアップしましたが、インライン引数のドキュメント化が機能していないようです!

@param を使用したアウト オブ ライン ドキュメントは機能しているようです。そのため、Objective-C メソッドのインライン構文はサポートされていないとしか言​​えません。これは本当に残念です。

誰か違いを知っていますか？これを機能させたいです。

私はDoxygenを使用して、C＃で記述されたAPIのドキュメントを生成しています。ただし、プライベート/保護されたメンバーを公開します。それらを隠す方法はありますか？

ファイルを非表示にする方法を理解しました：EXCLUDE=ファイル名のリスト

それでも、より細かくする必要があるため、ユーザーを不要なAPIノイズから保護します。サンプルのDoxygenファイルとヒント/コツをいただければ幸いです。

ソースコードからAPIを生成するためにどのツールを使用していますか？

私はC++を介してC＃でDoxygenを使用しているので、18世紀にはやや取り残されたように感じます。

Boost ライブラリの doxygen ドキュメントは Web のどこかにありますか?

自分で作成することもできますが、Web 上のどこかに既に存在していると思いますか? ありがとう！

javadocを使用してからdoxygenに来た場合、クラスからクラスへ、メソッドからメソッドへのジャンプを容易にする階層（フレームベース）ビューが見当たらないと言ったときに、私が何を意味するかを知っているかもしれません。（これを見たことがない人のために、IDEまたはファイルシステム上のツリーナビゲーターを想像してみてください）。

可能であれば、Doxygenにナビゲーションツリーを含めるにはどうすればよいですか？

同様の質問が10月に行われましたが、それはスタイルシートの代替案に関するものであり、1つだけが判明しました。もっとメジャーなものを探していると思います。

doxygen が生成された html ファイルにコメントを入れることができるように、関数 (c、c++、java) にいくつかのコメントを含めることができるかどうかを知りたいです。

例えば：

Qt スタイルのドキュメント (Trolltech の C++ Qt または Riverbank の PyQt ドキュメント) を Doxygen で作成するにはどうすればよいですか? 私は Python を文書化しています。Python が生成するデフォルトの関数概要を改善できるようにしたいと考えています。

特に、戻り値の型 (ユーザーが指定できる) と関数の概要でパラメーターを確認できるようにしたいと考えています。

例えば：

ソースを変更せずにこれが不可能な場合、この種の方法で Python ドキュメントを処理する Doxygen 以外のツールがあるでしょうか?