Doxygen将所有内容视为C ++项目中的详细描述

时间:2018-09-22 12:40:55

标签: documentation doxygen

我正在尝试在Qt C ++项目中设置Doxygen,我在.cpp文件中记录了每个类的方法,如下所示:

/**
 * @file fragmentsfactory.cpp
 * @author Dylan Van Assche
 * @date 09 Aug 2018
 * @brief Requests a page by URI
 * @param const QUrl &uri
 * @param QObject *caller
 * @package Fragments
 * @public
 * Starts the generation process of a QRail::Fragments::Page object by
 * requesting a page by URI. When the page is ready, the pageReady signal will
 * be emitted.
 */
void QRail::Fragments::Factory::getPage(const QUrl &uri, QObject *caller)
{
    // Use processing methods to allow other extensions in the future if needed
    this->getPageByURIFromNetworkManager(uri);
    QUrlQuery query = QUrlQuery(uri);
    QDateTime departureTime = QDateTime::fromString(query.queryItemValue("departureTime"), Qt::ISODate);
    this->dispatcher()->addTarget(departureTime, caller);
}

当我在终端中运行Doxygen时,会收到关于每种方法的很多警告。 Doxygen没有看到每种方法的注释。它假定注释是整个文件描述的一部分。

我的 DoxyFile https://gist.github.com/DylanVanAssche/c83c98e73f43cfb466b6d6f45da950f9

0 个答案:

没有答案