[LLVMbugs] [Bug 19581] New: -Wdocumentation-unknown-command doesn't recognize doxygen's "@page"

[bugzilla-daemon at llvm.org]

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

            Bug ID: 19581
           Summary: -Wdocumentation-unknown-command doesn't recognize
                    doxygen's "@page"
           Product: clang
           Version: trunk
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P
         Component: -New Bugs
          Assignee: unassignedclangbugs at nondot.org
          Reporter: magnus.reftel at gmail.com
                CC: llvmbugs at cs.uiuc.edu
    Classification: Unclassified

Doxygen has support for a long list of commands (see
http://www.stack.nl/~dimitri/doxygen/manual/commands.html), some of which are
unknown to Clang. As an expample, the following file is parsed correctly by
Doxygen, generating an entry under "Related Pages", but Clang (as of version
207303) with -Wdocumentation and -Wdocumentation-unknown-command warns that
@page is not recognized:


$ cat test.c 
/** @page foo
 */
int a;
$ /opt/llvm/r207303/bin/clang -Wdocumentation -Wdocumentation-unknown-command
-c test.c
test.c:1:5: warning: unknown command tag name [-Wdocumentation-unknown-command]
/** @page foo
    ^
1 warning generated.


I would have expected that all Doxygen's documented commands would at least be
silently ignored by Clang, as -Wdocumentation-unknown-command otherwise becomes
essentially unusable for catching incorrect Doxygen commands.

-- 
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/20140428/35765f38/attachment.html>