title: How do I comment header files?
body: <pre><code>/* ----------------------------------------------------------
  ** functions used for converting between different data types
  ** ---------------------------------------------------------*/
  
  #ifndef TYPECONVERTER_H_INCLUDED
  #define TYPECONVERTER_H_INCLUDED
  
  
  /**
      converts binary to decimal
      @return converted decimal number
  */
  int toDecimal(bool binary[], int noOfNumbers);
  
  /**
      converts decimal to binary and stores it in a given array
  */
  void toBinary(int origin[], bool binary[], int noOfNumbers);
  
  #endif // TYPECONVERTER_H_INCLUDED
  </code></pre>
  
  <p>How do I comment what this header does, so Doxygen understands it? Right now it just assigns the top comment to the first function.</p>
  
  <p><a href="http://i.stack.imgur.com/1HHqo.png" rel="nofollow">This is what it looks like</a></p>