6

根据文档,这应该足以将文档授予类的相同成员

//@{
/** Same documentation for both members. Details */
void member1();
void member2();
//@}

我的情况非常相似。我有

  //@{
  /*! \brief comment blah blah
   *  \param one param
   *  \param two param
   *  \return return
   Foo &member1(MyEnum one, Foo & two)
   Bar &member2(MyEnum one, Bar & two)
   Baz &member3(MyEnum one, Baz & two)
   //@}

我试过了,但我只得到第一个的描述。我错过了什么吗?

编辑:好的,我试过他们的例子

/** A class. Details */
class Test
{
  public:
    //@{
    /** Same documentation for both members. Details */
    void func1InGroup1();
    void func2InGroup1();
    //@}

    /** Function without group. Details. */
    void ungroupedFunction();
    void func1InGroup2();
  protected:
    void func2InGroup2();
};

void Test::func1InGroup1() {}
void Test::func2InGroup1() {}

/** @name Group2
 *  Description of group 2. 
 */
///@{
/** Function 2 in group 2. Details. */
void Test::func2InGroup2() {}
/** Function 1 in group 2. Details. */
void Test::func1InGroup2() {}
///@}

/*! \file 
 *  docs for this file
 */

//!@{
//! one description for all members of this group 
//! (because DISTRIBUTE_GROUP_DOC is YES in the config file)
#define A 1
#define B 2
void glob_func();
//!@}

它产生的结果与他们提出的结果不同。同样,我没有看到任何分组,也没有看到许多其他描述(例如“A 类”不存在)。在这一点上我不知道。我正在使用最新版本。

4

1 回答 1

15

请记住将 DISTRIBUTE_GROUP_DOC 设置为 YES。

我将其发布为答案,因为看起来@doxygen 不会这样做,信用到期

于 2013-11-20T12:57:11.503 回答