Marcar funciones anuladas

Question

¿Existe un comando, como \deprecated, pero para marcar funciones anuladas?

Java tiene una anotación @override para las funciones que ha anulado. Me gustaría hacer lo mismo en C++, para poder ver las funciones de superclase que he anulado. En el mejor de los casos, la página de documentación también debe mostrar todas las funciones de miembros de la clase, que son heredadas, pero no anuladas explícitamente con hipervínculos a las funciones de la superclase.

Sé que hay una manera de copiar la documentación del método de la superclase. Pero no quiero copiar todo el documento. Solo quiero saber que una función es heredada. El comportamiento debe ser similar a la opción obsoleta para marcar esas funciones antiguas con una barra.

Answer 1

Cada función anulada recibe automáticamente un aviso de que se ha vuelto a implementar. Por ejemplo, la función anulada en una clase derivada recibe el aviso "Reimplemented from MyBaseClass".

También pone un aviso en la documentación de la clase base. Se menciona "Reimplementado en prueba"

Para mostrar todas las funciones, incluidas las heredadas, puede establecer INLINE_INHERITED_MEMB en YES. Luego Doxygen copia la documentación de cada función heredada, pero no reemplazada, en la documentación de la clase derivada.

Por ejemplo, al utilizar esta fuente:

class TestBase 
{ 
    public: 
     /** 
     * Base class function. 
     */ 
     virtual void function(); 

     /** 
     * Another function. 
     */ 
     virtual void another(); 
}; 

class Test: public TestBase 
{   
    public: 
     /** 
     * Overridden function. 
     */ 
     virtual void function(); 
}; 

Y la creación INLINE_INHERITED_MEMB-YES dará lugar a la siguiente documentación para la clase Derived: (Con Doxygen 1.7.6)

miembro Documentación de función

virtual void TestBase::another ( ) [virtual, inherited]
Otra función.

virtual void Test::function ( ) [virtual]
Derivado.
Reimplementado desde TestBase.

Creo que esto es lo que estás buscando.

Answer 2

Desde C++ 11 puede utilizar la anulación especificador:

class A { 
    virtual void jump() = 0; 
    void talk() {} 
}; 

class B: public A { 
    void jump() const override {...} // Error: B:: jump does Not overrides A:: jump (A::Jump is not const...) 
    void jump() override {...} // OK: B:: jump overrides A:: jump 
    void talk() override {...} // Error: A::talk is not virtual 
}; 

original Ejemplo y doc oficial: http://en.cppreference.com/w/cpp/language/override