Отчет Doxygen "Потенциальная рекурсивная классовая связь" - PullRequest
Новая
       5

Отчет Doxygen "Потенциальная рекурсивная классовая связь"

16 голосов
/ 02 марта 2011

У меня есть шаблонный класс C ++ base::Foo<class T>, и в другом файле у меня есть класс base::bar::Foo : public base::Foo<Baz>.Doxygen, похоже, не нравится, так как он выдает ошибку 

<unknown>:1: Detected potential recursive class relation between class snLib::mocTwod::DsaCell and base class DsaCell< snLib::mocTwod::ProblemTraits, detLib::cellDiffusionTwod::ProblemTraits >!

Есть ли способ предотвратить это?Документация Doxygen не говорит об этой ошибке или о «потенциальной рекурсивной взаимосвязи классов».

«Базовый» класс: 

/*! \file snlib/DsaCell.hpp
 */
#ifndef snlib_DsaCell_hpp
#define snlib_DsaCell_hpp
#include "Dsa.hpp"

namespace snLib {
/*!
 * \brief  Implementation of naive cell-centered DSA
 */
template <class HoTraits_T, class LoTraits_T>
class DsaCell : public snLib::Dsa< HoTraits_T, LoTraits_T >
{
    [snip]
};
}
#endif

один из его потомков, который вызывает проблему: 

/*! \file snlib/twod/moc/DsaCell.hpp
 */
#ifndef snlib_twod_moc_DsaCell_hpp
#define snlib_twod_moc_DsaCell_hpp
#include "snlib/DsaCell.hpp"

#include "ProblemTraits.hpp"
#include "detlib/twod/celldiffusion/ProblemTraits.hpp"

namespace snLib { namespace mocTwod {
/*!
 * \brief Inconsistent DSA for MOC
 */
class DsaCell : public snLib::DsaCell<
                        snLib::mocTwod::ProblemTraits,
                        detLib::cellDiffusionTwod::ProblemTraits
                        >
{
    [snip]
};
} } // end namespace snLib::mocTwod
#endif

В файле конфигурации My Doxygen задано много параметров, включая конфигурацию пути: STRIP_FROM_PATH (установлен в корневой каталог), STRIP_FROM_INC_PATH (то же самое), INCLUDE_PATH (то же самое).

Редактировать: похоже, что ошибка была фактически выдана в другом Doxy-файле, который использовал теги XML, созданные с конфликтующим именем, поэтому проблема была связана с этим.В любом случае, я просто переименовал базовый класс в другое, и все снова стало хорошо.

1 Ответ

1 голос
/ 21 сентября 2011

Doxygen имеет функцию, которая проверяет, есть ли у классов A и B отношение наследования (прямой или косвенный), который является рекурсивным. Функция проверки рекурсии на предельную глубину 256.

Возможно, doxygen перепутан с вашим кодом (поскольку совпадение имен), и подумайте, что класс A зависит от B, а B снова зависит от A.

Это может быть ошибка Doxygen, но лучшим подходом может быть переименование класса.

...