comments - 如何注释掉 Doxygen 文档中的注释

Question

我正在使用 Doxygen 的 \page、\subpage 和 \section 结构来为我的应用程序制作概述文档。在此的某个地方，我正在使用 HTML 创建一个格式良好的表格。

但是，我想在输出中删除表格的一部分，而不删除注释本身。例如

/*!
\page MAINPAGE Main Page

<table>
   <tr>
      <td>Do This</td>
      <td>100</td>
   </tr>
   <tr>
      <td>Do That</td>
      <td>200</td>
   </tr>
   <tr>
      <td>Yet another one</td>
      <td>300</td>
   </tr>
</table>

我想删除包含“Do That”的行而不从文件中删除“文本”本身。

如果这是简单的源代码，我可以简单地使用 // 或 /* */ 将其注释掉。

我发现我可以使用 \if 或 \latexonly (我们只生成 html 输出)但两者似乎都是一种解决方法(看起来像使用 if( false) 在代码中注释掉一个 block )。

在 Doxygen 中是否有一种干净的方法来注释掉注释？

Answer 1

你试过\cond\endcond 标签了吗？这里描述了http://www.doxygen.nl/manual/commands.html#cmdcond http://www.doxygen.nl/manual/commands.html#cmdendcond