6

だから私はDoxygenを使うのが初めてで、スムーズに動作させることができました。クラスと構造体を文書化することができ、HTMLファイルが完全に生成されます。私が遭遇している問題は、main.cppファイルを解析しないことです。すべてのクラスと構造体には独自の.hファイルと.cppファイルがあり、正常に処理されます。Doxygenにmain.cppのドキュメントを作成させるにはどうすればよいですか?プログラムが開始および終了する場所であるため、.hファイルはありません。mainの.hファイルに何を入れるべきかさえわかりません。私はWindowsでDoxywizardを使用しています。

編集:

これをメインに配置すると、メインページが生成されます。

/**
@mainpage

This is a test application.

@author Alex
@date 10/21/2010
@version 1.0
*/

しかし、関数プロトタイプがあるファイルのさらに下にこれがあり、解析されません。

/**
@brief Error handler for the PDF writer.

It does nothing. It just has to exist.
*/
void error_handler (HPDF_STATUS   error_no,
                    HPDF_STATUS   detail_no,
                    void         *user_data)
{
}
4

3 に答える 3

7

これをmain.cppの先頭に配置すると、機能しました。図に行きます。

/**
@file main.cpp
*/
于 2010-10-22T19:33:36.350 に答える
2

INPUTおよびが空の場合FILE_PATTERNS、現在のディレクトリで* .cppファイル(および他の多くのパターン)を検索する必要があります。(これはdoxygenマニュアルから。)

あなたのものは空なので、main.cppのドキュメントを入手していない場合は、次の2つのいずれかが起こっていると思います。

  1. main.cppが現在のディレクトリにありません。これを除外するには、構成ファイルとmain.cppの両方と同じディレクトリからdoxygenを実行していることを確認してください。
  2. main.cppドキュメントに構文エラーがあります。doxygenは通常、エラーが発生しても中止されないため、これらを見つけるのは難しい場合があります。代わりに、先にスキップするだけです。これが問題である場合は、ドキュメントを1行ずつ生成するときに、doxygenの出力をくまなく調べてください。

これらのアイデアのどちらも問題を解決しない場合は、さらに情報が必要になる可能性があります。の出力ls -R、doxygen runの出力など。頑張ってください!

于 2010-10-21T20:18:43.980 に答える
1

私はこれについていくつかの研究をしました... doxygenマニュアルから:

重要:グローバル関数、変数、typedef、および列挙型のドキュメントは、それらが含まれるファイルもドキュメント化されている場合にのみ出力に含まれます。

どうぞ!

于 2011-04-13T18:09:01.660 に答える