<html>
<head>
<base href="http://llvm.org/bugs/" />
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_NEW "
title="NEW --- - -Wdocumentation-unknown-command doesn't recognize doxygen's "@page""
href="http://llvm.org/bugs/show_bug.cgi?id=19581">19581</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>-Wdocumentation-unknown-command doesn't recognize doxygen's "@page"
</td>
</tr>
<tr>
<th>Product</th>
<td>clang
</td>
</tr>
<tr>
<th>Version</th>
<td>trunk
</td>
</tr>
<tr>
<th>Hardware</th>
<td>PC
</td>
</tr>
<tr>
<th>OS</th>
<td>Linux
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>normal
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>-New Bugs
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>magnus.reftel@gmail.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvmbugs@cs.uiuc.edu
</td>
</tr>
<tr>
<th>Classification</th>
<td>Unclassified
</td>
</tr></table>
<p>
<div>
<pre>Doxygen has support for a long list of commands (see
<a href="http://www.stack.nl/~dimitri/doxygen/manual/commands.html">http://www.stack.nl/~dimitri/doxygen/manual/commands.html</a>), 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.</pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are on the CC list for the bug.</li>
</ul>
</body>
</html>