Question

I am using Doxygen’s \page, \subpage and \section constructions to make overview documentation for my application. Somewhere in this I am using HTML to create a nicely formatted table.

However, I want to remove a part of the table in the output, without removing the comment itself. E.g.

/*!
\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>

I want to remove the line containing ‘Do That’ without removing the ‘text’ itself from the file.

If this were simple source code, I could simply comment this out using // or /* */.

I found out that I could use \if or \latexonly (we only generate html output) but both seem a workaround (looks like using if(false) in code to comment out a block).

Isn’t there a clean way to comment out comment in Doxygen?

Answer 1

Did you try \cond \endcond tags? It’s described here http://www.doxygen.nl/manual/commands.html#cmdcond
http://www.doxygen.nl/manual/commands.html#cmdendcond