title: Why do I get an "unexpected token" error in Doxygen?
body: <p>I'm a relative neophyte to Doxygen, but I thought I understood how to write a comment. I have a few stragglers now, complaining of "warning: unexpected token in comment block while parsing the argument of command param" on the following comment, complaining about the @brief line.</p>
  
  <pre><code>/**
    * @brief  Converts ADC reading to battery voltage
    * @param  adcVal raw ADC reading
    * @retval Battery voltage as float
    * @note   Assumes 12 bit ADC and 3.3 volt VCC
    * @note   Broken out for testability
    */
  </code></pre>
  
  <p>Can anybody tell me what might be the unexpected token? I've even resorted to retyping the comment block thinking I had an invisible character in there. (It's happened before...).</p>
  
  <p>I didn't find anything in the Doxygen documentation that mentioned error messages.</p>
  
  <p>And of course I assume I'm being particularly dense and stupid today...</p>