title: Is it a bad practice to use C-style comments in C++ code?
body: <p>While reading <a href="http://en.wikipedia.org/wiki/Doxygen" rel="noreferrer">this</a> wikipedia article about <a href="/questions/tagged/doxygen" class="post-tag" title="show questions tagged &#39;doxygen&#39;" rel="tag">doxygen</a>, I came across this statement:</p>
  
  <blockquote>
    <p>Many programmers avoid using C-style comments and instead use C++
    style single line comments.</p>
  </blockquote>
  
  <p>Is this correct? If so, why is that? Is it just a habit or there are some technical and rational reasons behind this?</p>
  
  <hr>
  
  <p>Examples from aforementioned article:</p>
  
  <pre><code>/**
   * &lt;A short one line description&gt;
   *
   * &lt;Longer description&gt;
   * &lt;May span multiple lines or paragraphs as needed&gt;
   *
   * @param  Description of method's or function's input parameter
   * @param  ...
   * @return Description of the return value
   */
  </code></pre>
  
  <p>vs.</p>
  
  <pre><code>/// &lt;A short one line description&gt;
  ///
  /// &lt;Longer description&gt;
  /// &lt;May span multiple lines or paragraphs as needed&gt;
  ///
  /// @param  Description of method's or function's input parameter
  /// @param  ...
  /// @return Description of the return value
  </code></pre>