我如何配置Doxygen在“类索引”网页中包含类的typedef?例如,如果代码具有
typedef std::map<std::string /* month name */, std::string /* yield */> MonthlyYieldMap;
在某个地方,MonthlyYieldMap
就像一个类,因此将其包括在类索引中似乎是合理的,就像引用该类的其他名称一样。
如果我正在检查其他人的代码,并且看到了像类一样但对我不熟悉的东西的名称,那么我将拉出类索引以查找该类的详细信息,但是如果该名称是然后输入typedef即可。
我仍然可以通过Class Index网页上的Doxygen搜索栏找到有关神秘名称的信息,但是如果在Class Index中提到它,将会更加方便。
我浏览了配置文件,发现其中有两个提到typedef(INLINE_SIMPLE_STRUCTS和TYPEDEF_HIDE_STRUCT),但是它们并不能解决我的问题。
添加2018-07-05:
如果我可以编辑代码,则可以将typedef更改为继承另一个类的类:
class MonthlyYieldMap : public std::map<std::string, std::string> { }
,然后将其包含在类索引中。我不知道这样做是否会影响性能或可执行文件的大小。如果我无法编辑代码,这将无济于事。
答案 0 :(得分:0)
typedef
不是class
,并且没有预见到。
一个不太好的解决方案,因为它没有提到MonthlyYieldMap
是typedef
而是说它是一个函数(我不接受您的情况):
/**
* @class MonthlyYieldMap
*/
/**
* some documentation
* \relates MonthlyYieldMap
*/
typedef std::map<std::string /* month name */, std::string /* yield */> MonthlyYieldMap;