<html>
    <head>
      <base href="http://llvm.org/bugs/" />
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW --- - -Wdocumentation warning text caret off-by-one for 'empty paragraph passed to '@param''"
   href="http://llvm.org/bugs/show_bug.cgi?id=17304">17304</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>-Wdocumentation warning text caret off-by-one for 'empty paragraph passed to '@param''
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>new-bugs
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>trunk
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>Macintosh
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>MacOS X
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>normal
          </td>
        </tr>

        <tr>
          <th>Priority</th>
          <td>P
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>new bugs
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>unassignedbugs@nondot.org
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>sean@rogue-research.com
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>llvmbugs@cs.uiuc.edu
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr></table>
      <p>
        <div>
        <pre>Created <span class=""><a href="attachment.cgi?id=11247" name="attach_11247" title="repro case">attachment 11247</a> <a href="attachment.cgi?id=11247&action=edit" title="repro case">[details]</a></span>
repro case

Perhaps this is subjective, but I think this warning text is off-by-one:

test.c:5:18: warning: empty paragraph passed to '@param' command
[-Wdocumentation]
 * @param[in]  src  
   ~~~~~~~~~~~~~~^

Why point to the letter 'c' in 'src'?  I think it should point to the space
right after 'c', similar to this:

  t.c:4:8: error: expected ';' after expression
    bar()
         ^
         ;

Test case attached.  With clang trunk 191092:

clang -fsyntax-only -Wdocumentation test.c</pre>
        </div>
      </p>
      <hr>
      <span>You are receiving this mail because:</span>
      
      <ul>
          <li>You are on the CC list for the bug.</li>
      </ul>
    </body>
</html>