Comment documenter des fonctions substituées/implémentées sans Doxygens @copydoc?

Question

Comment puis-je documenter une méthode substituée ou une méthode virtuelle implémentée d'une sous-classe? Devrais-je utiliser @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

Si la méthode est surchargée, elle a probablement un comportement différent de celui de l'implémentation de la sous-classe. Dans ce cas, vous devez juste réécrire la documentation pour cette méthode.

Si vous voulez malgré tout la même documentation, vous pouvez utiliser l'option INHERIT_DOCS.