title: how to hide parts of doxygen comments to doxygen?
body: <p>Suppose you have a rather complicated README you want Doxygen to process to produce the mainpage of the documentation, something along the lines of</p>
  
  <pre><code>/*! 
      \mainpage Welcome to this code
  
      \section S1 Introduction
      Some stuff to explain why you coded all this
  
      \section S2 Examples
      Many examples of how the code can be used
      !!! some line which you wouldn't write in a documentation
  
      \section S3 Some other stuff
  */
  </code></pre>
  
  <p>AND you want doxygen to ignore the line beginning with !!! BUT you don't want to erase the line because you plan on editing it later.</p>
  
  <p>Well, how can you do that?</p>
  
  <p>EDIT: The following:</p>
  
  <pre><code>/*! 
      \mainpage Welcome to this code
  
      \section S1 Introduction
      Some stuff to explain why you coded all this
  
      \section S2 Examples
      Many examples of how the code can be used
      \cond NEVER
      !!! some line which you wouldn't write in a documentation
      \endcond
  
      \section S3 Some other stuff
  */
  </code></pre>
  
  <p>fails to put section <code>S3</code> in the mainpage...</p>