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

bugzilla-daemon at llvm.org bugzilla-daemon at llvm.org
Fri Jan 25 09:09:55 PST 2013


             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
@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.

More information about the llvm-bugs mailing list