<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 --- - False positive warning from -Wdocumentation-unknown-command"
href="http://llvm.org/bugs/show_bug.cgi?id=16092">16092</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>False positive warning from -Wdocumentation-unknown-command
</td>
</tr>
<tr>
<th>Product</th>
<td>new-bugs
</td>
</tr>
<tr>
<th>Version</th>
<td>trunk
</td>
</tr>
<tr>
<th>Hardware</th>
<td>Macintosh
</td>
</tr>
<tr>
<th>OS</th>
<td>MacOS X
</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>unassignedbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>sean@rogue-research.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>clang's -Wdocumentation-unknown-command is giving what seems to be a false
positive warning.
Consider the example from the doxygen website itself:
<a href="http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdrelates">http://www.stack.nl/~dimitri/doxygen/manual/commands.html#cmdrelates</a>
---------------------
/*!
* A String class.
*/
class String
{
friend int strcmp(const String &,const String &);
};
/*!
* Compares two strings.
*/
int strcmp(const String &s1,const String &s2)
{
}
/*! \relates String
* A string debug function.
*/
void stringDebug()
{
}
---------------------
then:
$ clang -Weverything -fsyntax-only ~/Desktop/test.cxx
/Users/sean/Desktop/test.cxx:19:5: warning: unknown command tag name
[-Wdocumentation-unknown-command]
/*! \relates String
^
Strangely, no warnings are generated if I use "-Wdocumentation-unknown-command"
or "-Wdocumentation" in place of -Weverything...
This is all with:
clang version 3.4 (182384)
Target: x86_64-apple-darwin12.4.0
Thread model: posix
ie trunk from just now.</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>