我正在尝试在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