[LLVMbugs] [Bug 15068] New: -Wdocumentation assert with empty @param paragraph followed immediately by @param

[bugzilla-daemon at llvm.org]

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

             Bug #: 15068
           Summary: -Wdocumentation assert with empty @param paragraph
                    followed immediately by @param
           Product: clang
           Version: trunk
          Platform: PC
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P
         Component: Frontend
        AssignedTo: unassignedclangbugs at nondot.org
        ReportedBy: ptaylor at broadcom.com
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified


Reproduced on 3.2 release and on recent trunk (173180):


$ cat test.c
/**
@param x
@param y
**/
int f();

$ clang test.c -Wdocumentation
test.c:3:8: warning: empty paragraph passed to '\param' command
[-Wdocumentation]
@param y
~~~~~~~^
clang: /srv/users/ptaylor/clang/svn/llvm/include/llvm/Support/Casting.h:208:
typename llvm::cast_retty<To, From>::ret_type llvm::cast(const Y&) [with X =
clang::comments::ParagraphComment, Y = clang::comments::BlockContentComment*]:
Assertion `isa<X>(Val) && "cast<Ty>() argument of incompatible type!"' failed.


Adding anything (e.g. a space character) before the "@param y" appears to stop
the assertion failure.

-- 
Configure bugmail: http://llvm.org/bugs/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.