1

SLED 10.4 (Linux) で doxygen 1.8.3.1 を実行しており、次のような構造体を含む C ヘッダー ファイルを文書化しようとしています。

/** Test struct definition */
typedef struct
{
    int member_1;  /**< Single-line detailed description */
    int member_2;  /**< Multi-line detailed description.  Blah
                        blah blah */
} TEST_S;

Doxyfile は によって生成されたデフォルトですがdoxygen -g、唯一の変更点は、ソースを指すように INPUT タグを編集したことです。

Doxygen は期待どおりに単一行の説明から単純な memdoc 段落を生成しますが、複数行の説明は何らかの方法で処理され、最初の行がコード フラグメントとしてフォーマットされます。理由がわかりません。実際に生成される HTML は次のとおりです。

<pre class="fragment">  Multi-line detailed description.  Blah
</pre><p> blah blah </p>

Doxygen が単純な段落を生成しないのはなぜですか?

4

1 に答える 1

1

これは、1.8.3.1 リリースにおける Doxygen の Markdown サポートのバグのようです (Doxygen 1.8.2 では問題を再現できませんでした)。構成ファイルでマークダウン サポートを無効にした場合:

MARKDOWN_SUPPORT = NO

ページが正しく表示されます。

または、コメントを先頭の doxygen コメントに切り替える場合:

/** Multi-line detailed description.  Blah
    blah blah */
int member_2;

または、コメントを次の行に移動します。

int member_2;
/**< Multi-line detailed description.  Blah
     blah blah */

正しくレンダリングする必要があります。

この問題は、Doxygen 開発グループ ( https://bugzilla.gnome.org/show_bug.cgi?id=699437 )に報告されています。

于 2013-05-02T05:16:33.367 に答える