doxygen - Doxygen: コードリストの各行はアスタリスク (*) で始まります

Question

C++ ライブラリの HTML ドキュメントを作成するために doxygen を使用しています。

\code ... \endcode現在、各行がアスタリスクで始まるリストを生成するコードリストで作成された問題があります。

例：

Have a look at the following code sample:
\code
int a = 5;
int b = func(a);
\endcode

出力：

Have a look at the following code sample:
* int a = 5;
* int b = func(a);

この動作を説明することはできません。特に、行を doxygen ドキュメントとしてマークする///代わりに使用しているためです。/**ただし、問題は両方のフォーマットで発生します。これを解決する方法を知っている人はいますか？(doxygen 1.8.5 を使用しています)

score 3 · Accepted Answer

これは確かに 1.8.5 での残念なリグレッションです。

GitHub に修正をプッシュしました。問題が解決するかどうかお知らせください。

score 0 · Accepted Answer

これはバグのようです。Bugzilla エントリ. また、このバグが関連している可能性があります。

次のスニペットを変更することで回避策を得ることができました

/// Have a look at the following code sample:
/// \code
/// int a = 5;
/// int b = func(a);
/// \endcode

以下に (スラッシュが 2 つしかないことに注意してください):

/// Have a look at the following code sample:
// \code   
// int a = 5;
// int b = func(a);
/// \endcode

すべてのコメントを再レイアウトする必要があり、フォーマットが非常に不自然に感じられるため、これには満足していません。

doxygen - Doxygen: コード リストの各行はアスタリスク (*) で始まります