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: [email protected]
Reporter: [email protected]
CC: [email protected]
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.
_______________________________________________
LLVMbugs mailing list
[email protected]
http://lists.cs.uiuc.edu/mailman/listinfo/llvmbugs
