代码之家  ›  专栏  ›  技术社区  ›  Stefan

Doxygen:代码列表中的每一行都以星号(*)开头

  •  1
  • Stefan  · 技术社区  · 11 年前

    我正在使用doxygen为C++库创建一个HTML文档。

    现在我有一个问题,用 \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文档。不过,这两种格式都会出现问题。 有人知道如何解决这个问题吗? (我使用的是1.8.5的脱氧核糖核酸)

    2 回复  |  直到 11 年前
        1
  •  3
  •   doxygen    11 年前

    这确实是1.8.5中的一个不幸的回归。

    我刚刚对GitHub进行了修复。如果它能解决问题,请告诉我。

        2
  •  0
  •   Stefan    11 年前

    这似乎是一个bug。 Bugzilla entry . 而且 this bug 可能是相关的。

    我设法通过更改以下片段找到了一个变通方法

    /// 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:
    // \code   
    // int a = 5;
    // int b = func(a);
    /// \endcode
    

    我对此不满意,因为它需要重新布局所有评论,而且格式非常不自然。