草庐IT

c++ - 在主页中嵌入自述文件(doxygen)

有没有办法将纯文本文件(README.txt)嵌入到doxygen的主页中?(我正在用cmake处理它,所以我可以转储变量,但我认为这种类型的东西会内置)。 最佳答案 当然。在您的mainpage.dox(或您所称的任何名称)中,放置一个指向您的README.txt的链接作为单独的doxygen页面。\mainpageFooBar...\sectionother_docsAdditionalDocumentation`...Keyfeaturesthatdistinguishthecurrentrelease,buildinstru

c++ - 如何使用 doxygen 记录好友注入(inject)功能?

给定如下示例中的一些代码:classMyClass;classInjector{/***@briefMyClassaddition.*/friendMyClassoperator+(MyClassa,MyClassb){...}};classMyClass:privateInjector{};如何让doxygen在MyClass类的文档页面包含operator+()的文档?从功能上讲,它显然属于那里。是否有一些通用方法可以通过ADL提供doxygen文档功能?现实世界中的一个有用示例:我希望doxygen包含boost/operators.hpp中的基类提供的运算符。

c++ - Doxygen 和长类名

我有一个很好的C++项目,其中广泛使用了模板编程,但这真的不是重点。关键是我的一些类名(带有所有模板参数)变得很长。我将Doxygen用于文档。这通常不是问题,但最近我注意到类列表不可读,因为长类名使其太宽而无法显示在屏幕上。有没有办法让Doxygen将类列表中的类名分成更多行?有没有办法在保留通用模板类的同时从类列表中隐藏模板类的特化?有更好的解决方案吗?我设法通过将类隐藏在命名空间中然后立即将此命名空间导入全局命名空间来找到一个愚蠢的解决方法,这样这些类的名称就不会出现在列表中,除非单击或细节水平增加。明显的缺点是这些类(class)现在没有出现在列表中(其中一些相当重要,我希望它

c++ - 我可以在函数头中包含 cppcheck 抑制吗?

我添加了一个内联注释来抑制函数的cppcheckunusedFunction警告,但我想将其包含在函数头中,以便Doxygen可以记录所有未使用的函数(我正在实现一个API,所以我有许多函数不会在我的源代码中使用)。我不希望抑制所有unusedFunction错误,而是基于每个函数。我想做这样的事情:/***APIfunctiondescription**@paramp1functionpointertothe...*@return0ifsuccessful,-1otherwise.*//cppcheck-suppressunusedFunction*/intCreateTask(Ta

c++ - Doxygen 未记录的字符串值

Doxygen(1.8.10)提示我的字符串的值没有记录。这是一个演示问题的最小示例#includestructMyStruct///这会导致警告/tmp/example.cpp:10:warning:MemberfirstVal(variable)ofclassMyClassisnotdocumented.如果我将结构缩减为单个成员并从初始化程序中删除“secondVal”,则警告消失,但显然这不是解决方案... 最佳答案 只需删除多余的struct。如:#includestructMyStruct///C++不要求您使用stru

c++ - 在 C++ 中使用 Doxygen 和 GraphViz 的错误调用/调用者图

所以我开始使用Doxygen1.8.13(Windows10,64位)记录一个C++项目,并遇到了GraphViz的调用/调用者图生成问题。如果使用以下代码生成文档,Doxygen将生成如下所示的调用图:但如代码所示,Path()不调用任何函数(空主体)。structPath{Path(constNode*source_node,constNode*target_node,constunsignedlongcost,conststd::vectorpath):source_node(source_node),target_node(target_node),cost(cost),pat

c++ - 你如何用 doxygen 记录 QFlags?

我有这样的东西(来自QFlags文档的示例):public://!EnumdocenumOption{NoOptions=0x0,//!ValuedocShowTabs=0x1,ShowAll=0x2,};Q_DECLARE_FLAGS(Options,Option)现在我可以记录Option及其值,doxygen会很好地显示它们。但是我不能让doxygen为Options生成任何东西。在Qt文档中它看起来像this,他们在枚举文档的顶部和底部添加了注释,并将其列为索引部分中的单独类型。更重要的是,Qt能够链接到用作函数参数的QFlags(例如QObject::findChild())

c++ - 氧气/C++ : Global namespace in namespace list

我可以在用Doxygen生成的文档的命名空间列表中显示全局命名空间吗?我有一些函数是extern"C",它们出现在声明它们的头文件的文档中,但不在namespace列表中,给人的印象是它们实际上并不存在。. 最佳答案 据我所知,Doxygen仍然缺少此功能。一种不太冗长的解决方法是使用@defgroupMyGlobals并将extern"C"函数放在该组中:/*!@ingroupMyGlobals*@{*///...functions/*!@}*/这会将函数添加到Modules选项卡上名为MyGlobals的条目中。Thisblog

c++ - Doxygen:如何记录没有#defined 的宏?

我正在尝试使用Doxygen来记录一些选项控制宏符号的功能,例如://!\defBOOST_SOMEFEATURE/*!\briefOptionmacrothatisnotnormallydefined*butcanoptionallybedefinedbyconsumerstoactivatetheoption.*/但这不会被索引并且评论将被忽略,因为宏未定义。只有当有#definelike时,才会在文档中生成Doxygen宏符号条目#defineBOOST_SOMEFEATURE在头文件和其他文件中。除了像这样的讨厌的软糖之外,我可以强制宏符号的文档吗#undefBOOST_SOM

c++ - 使用 Doxygen 单独提取类的公共(public)方法列表

我正在为我的C++项目使用Doxygen,该项目将托管在github中。我想在自述文件中包含一个类的方法列表,并且我正在考虑使其自动化的方法。我将在repo中包含整个生成的html页面,但我认为通过在自述文件中包含主类的成员来提供API的概念会很好。到目前为止,我找不到生成Markdown文件的方法。我的下一个想法是编写一些shell脚本,它会自动复制成员列表并将其包含在自述文件中,为此我需要单独生成一个类的成员函数列表。是否可以配置doxygen来单独输出一个类的成员列表? 最佳答案 我最近有一个项目,我想将几​​个函数确定为公共