1

多くの typedef と#defines. 次のように、Doxygen が同じ行でコメントを受け入れるようにしたいと考えています。

typedef uint32_t   U_NUM_LOGPLTNTRY;        //!< Number of U_LOGPLTENTRY
typedef uint32_t   U_NUM_RECTL;             //!< Number of U_RECTL

この:

#define U_SRCCOPY     0xcc0020  //!< info for srccopy
#define U_SRCPAINT    0xee0086  //!< info for srcpaint

ただし、これらの形式はどちらも機能しません。typedef の場合、コメントは次の行に適用されます。s の場合#define、コメントはエーテルに消えます。//!行が の前にある場合、#defineそのコメントは次の に関連付けられます#define。しかし、すべてのコメントを 1 行ずらす必要はありません

これを行うための Doxygen 構文はありますか? Windowsで実行されているDoxygen 1.8.1.1を使用しています。

4

2 に答える 2

3

これは私にとってはうまくいきます。私の推測では、問題はあなたが私たちに見せているスニペットの上の何かによって引き起こされているということです. のすぐ上に Doxygen コメント ブロックがある場合、Doxygen はそれをインライン コメントではなく にtypedef関連付けている可能性があります。typdef周囲の Doxygen のコメントを見て、このようなことが起こっていないことを確認してください。

typedef を単独でヘッダーに配置して、Doxygen がそれらを正しく処理するかどうかを確認することもできます。その場合、問題は、影響を受ける typedef の上のファイルにある可能性が最も高いです。

また、Doxygen はコマンドラインで有用な出力を生成していますか? そうでない場合は、で次のように設定してみてください.doxyfile

  • QUIET=NO
  • WARNINGS=YES
  • WARN_IF_DOC_ERROR=YES
于 2012-07-02T23:16:29.893 に答える
0

私はまだ実際のインクルード ファイルを完全に処理していませんが、これは非常に大きいですが、小さなテスト ファイルでは、この形式はグループの説明と行ごとの説明を正しく関連付けています。

/** \defgroup ABC Description of ABC group
  More information on the ABC group.
  And yet more.
  @{
*/
typedef uint32_t   U_ONE_NAME;        //!< One name
typedef uint32_t   U_TWO_NAME;        //!< Two name
/** @} */

元のファイルには、次のような「グループの説明」行がありました。

//! Describe the next few lines

論理グループだった行の前。その形式は適切ではありませんでした。説明を次の行にのみ関連付けており、おそらく説明が多すぎると、最終的にシフトの問題が発生しました。

于 2012-07-03T15:45:38.783 に答える