C++ Doxygen 隐藏注释

Question

我正在尝试弄清楚如何将 cmets 放置在我的源（或头）文件中，这样它们就不会出现在我的 Doxygen 文档中。 目前，我不太清楚哪些 cmets 出现了，哪些没有出现。

我的一个源文件 (.cpp) 中经常有这样的代码：

///* OCBA P(CS) implementation for "max" problems */
//void OCBA_PCS() {
//    
// Code goes here...
//
//}     


/*! OCBA minimize simulation cost for "max" problems */
void OCBA_SC() {
// Code goes here...
}

在这里，您可以看到函数 OCBA_PCS() 目前已被注释掉，可能是因为它不起作用，我希望将其从构建中排除。但是，当我运行 Doxygen 时，它会放

* OCBA P(CS) implementation for "max" problems */ 

进入OCBA_SC() 的详细文档部分。 如何防止这种情况发生？

以下是我正在使用的相关 Doxygen 配置设置：

#---------------------------------------------------------------------------
# Build related configuration options
#---------------------------------------------------------------------------
EXTRACT_ALL            = YES
EXTRACT_PRIVATE        = YES
EXTRACT_STATIC         = YES
EXTRACT_LOCAL_CLASSES  = YES
EXTRACT_LOCAL_METHODS  = NO
EXTRACT_ANON_NSPACES   = YES
HIDE_UNDOC_MEMBERS     = YES
HIDE_UNDOC_CLASSES     = NO
HIDE_FRIEND_COMPOUNDS  = NO
HIDE_IN_BODY_DOCS      = YES
INTERNAL_DOCS          = NO
CASE_SENSE_NAMES       = NO
HIDE_SCOPE_NAMES       = NO
SHOW_INCLUDE_FILES     = YES
FORCE_LOCAL_INCLUDES   = YES
INLINE_INFO            = YES
SORT_MEMBER_DOCS       = YES
SORT_BRIEF_DOCS        = NO
SORT_MEMBERS_CTORS_1ST = NO
SORT_GROUP_NAMES       = NO
SORT_BY_SCOPE_NAME     = NO
GENERATE_TODOLIST      = YES
GENERATE_TESTLIST      = YES
GENERATE_BUGLIST       = YES
GENERATE_DEPRECATEDLIST= YES
ENABLED_SECTIONS       = 
MAX_INITIALIZER_LINES  = 30
SHOW_USED_FILES        = YES
SHOW_DIRECTORIES       = NO
SHOW_FILES             = YES
SHOW_NAMESPACES        = YES
FILE_VERSION_FILTER    = 
LAYOUT_FILE            = 

Answer 1

如果您只是用// 发表评论，它将不会出现在 doxygen 上。 Doxygen 仅解析以某些标记开头的 cmets，例如 /** 或 /*!。

已解析的令牌在doxygen documentation 中进行了描述。