c++ - 如何在没有 Doxygens @copydoc 的情况下记录重写/实现的函数？

Question

如何记录子类的重写方法或实现的虚方法？我应该使用 @copydoc 吗？ ？

class A {
   /**
    * A detailed description........
    */
   virtual int foo(int i);
}

class B : public A {
   /** {I won't write the same description again.} */
   int foo(int i);
}

Answer 1

如果该方法被覆盖，它可能具有与子类实现不同的行为。在那种情况下，您应该重写该方法的文档。

如果您无论如何都想要相同的文档，可以使用 INHERIT_DOCS选项。