title: Does commenting variables inline with Doxygen come with any penalties?
body: <p>I see most Doxygen docs for commenting c++ functions looking something akin to </p>
  
  <pre><code>/// a description of the function or method followed with comments, like so
  /// @return true=success, false=error
  /// @param[in] bar blah blah
  /// @param[out] baz blah blah
  /// @param[out] quux blah blah
  /// @param[out] quuux blah blah
  /// @param[out] quuuux blah blah
  static bool foo_one( int *bar, int *baz, int *quux, int *quuux, int *quuuux );
  </code></pre>
  
  <p>or the xml equivalent (roughly)</p>
  
  <pre><code>/// a description of the function or method, followed by
  /// &lt;returns&gt;true=success, false=error&lt;/returns&gt;
  /// &lt;param name=bar&gt;blah blah&lt;/param&gt;
  /// &lt;param name=baz&gt;blah blah&lt;/param&gt;
  /// &lt;param name=quux&gt;blah blah&lt;/param&gt;
  /// &lt;param name=quuux&gt;blah blah&lt;/param&gt;
  /// &lt;param name=quuuux&gt;blah blah&lt;/param&gt;
  static bool foo_two( int *bar, int *baz, int *quux, int *quuux, int *quuuux );
  </code></pre>
  
  <p>but I've been mostly commenting my parameters inline, like so</p>
  
  <pre><code>/// a description of the function or method, followed by
  /// @return true=success, false=error
  static bool foo_three(
      int *bar,               ///&lt; [in]  blah blah
      int *baz,               ///&lt; [out] blah blah
      int *quux,              ///&lt; [out] blah blah
      int *quuux,             ///&lt; [out] blah blah
      int *quuuux             ///&lt; [out] blah blah
  );
  </code></pre>
  
  <p>All three of these give identical output in the html file (with the exception of the middle one, which doesn't specify in/out). </p>
  
  <p>My question: Are there features of Doxygen, Visual Studio, or any other environment that I won't be able to utilize with my inline approach? I understand that there are personal preferences when writing and reading the comments in code itself and would prefer not to debate those. I'm only interest in know if there are Doxygen or other environment features or formatting I'll be missing out on.</p>