Làm cách nào để ghi lại các hàm được ghi đè/triển khai mà không có Doxygens @copydoc?

Question

Làm cách nào để ghi lại phương thức ghi đè hoặc phương thức ảo được triển khai của lớp phụ? Tôi có nên sử dụng @copydoc không?

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

Nếu phương pháp bị ghi đè, nó có thể có hành vi khác với triển khai lớp con. Trong trường hợp đó, bạn chỉ cần viết lại tài liệu cho phương thức đó.

Nếu bạn muốn tài liệu giống nhau bất kể, bạn có thể sử dụng tùy chọn INHERIT_DOCS.