[LLVMbugs] [Bug 17304] New: -Wdocumentation warning text caret off-by-one for 'empty paragraph passed to '@param''

[bugzilla-daemon at llvm.org]

http://llvm.org/bugs/show_bug.cgi?id=17304

            Bug ID: 17304
           Summary: -Wdocumentation warning text caret off-by-one for
                    'empty paragraph passed to '@param''
           Product: new-bugs
           Version: trunk
          Hardware: Macintosh
                OS: MacOS X
            Status: NEW
          Severity: normal
          Priority: P
         Component: new bugs
          Assignee: unassignedbugs at nondot.org
          Reporter: sean at rogue-research.com
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified

Created attachment 11247
  --> http://llvm.org/bugs/attachment.cgi?id=11247&action=edit
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

-- 
You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20130920/afdd52fd/attachment.html>