Doxygen 1.8.13 ignoriert Parameter mit Standardwerten (C++)

Question

Wir machen derzeit unsere Kommentare Doxygen-kompatibel, sind aber auf ein Problem mit Standardparametern gestoßen.

Ein Beispiel wäre diese Funktion:

... 
class String : public Object 
{ 
    ... 
    /*! 
    * \brief Trim the string from the left while the characters matches any characters in the given string 
    * \param In_pChar - (optional) The array of characters to be trimmed 
    * \return The trimmed string object 
    */ 
    String& trim_left(const char * In_pChar=" \t"); 
    ... 
}; 
... 

Doxygen gerade auslässt vollständig den Parameter und sogar warnt darüber:

warning: argument 'In_pChar' of command @param is not found in the argument list of String::trim_left() 

Das resultierende HTML ist nicht wirklich das, was ich erwartet hatte :

Hat jemand eine Idee, wie man das repariert?

Answer 1

Ihr Problem ist fast sicher in einem Ihrer ... s oder Sie haben eine abgehört Version von Doxygen.

Der folgende Code funktioniert gut für mich:

class String : public Object                    
{                      
public:                         

/*!                          
* \brief Trim the string from the left while the characters matches any characters in the given string 
* \param In_pChar - (optional) The array of characters to be trimmed         
* \return The trimmed string object                  
*/                          
    String& trim_left(const char * In_pChar=" \t");              

};