title: How to write readme files that are automatically included into the Doxygen output?
body: <p>Conceptually along the lines of <a href="http://en.wikipedia.org/wiki/ReStructuredText" rel="nofollow noreferrer">restructuredtext</a>, I want to distribute readme files throughout my different source directories and then have <a href="http://en.wikipedia.org/wiki/Doxygen" rel="nofollow noreferrer">Doxygen</a> read and include those readme text files as part of the generated Doxygen output.</p>
  
  <p>How is this done? Or do I need to spoof Doxygen by creating a pseudo C file like:</p>
  
  <p>README.h:</p>
  
  <pre><code>/** 
  My big long readme file describing how this library 
  was created and how it should be used
  */
  namespace foo_readme { }
  </code></pre>