<html>
<head>
<base href="https://bugs.llvm.org/">
</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 - clang++ -Wdocumentation-unknown-command incorrect warning generated, removed by adding hash (#)"
href="https://bugs.llvm.org/show_bug.cgi?id=44243">44243</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>clang++ -Wdocumentation-unknown-command incorrect warning generated, removed by adding hash (#)
</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>enhancement
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>Frontend
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>tomasz.g.markiewicz@gmail.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org, neeilans@live.com, richard-llvm@metafoo.co.uk
</td>
</tr></table>
<p>
<div>
<pre>clang++ incorrectly marks '@' in e-mail address and @file as unknown command
tag names. However, adding '#' (could be as a part of an include directive or
just placed as a comment) results in no false-positive warning.
Incorrect warnings are generated
------------------------------------
tgm@asus:/tmp/bug$ cat main-warning.cc && clang++
-Wdocumentation-unknown-command main-warning.cc -c
/**
* @file
* Copyright (C) 2019 Bugs H. Unter (<a href="mailto:email@domain.com">email@domain.com</a>)
*
* Created on Apr 9, 2019
*
*/
int main() {
return 0;
}
main-warning.cc:2:4: warning: unknown command tag name
[-Wdocumentation-unknown-command]
* @file
^~~~~
main-warning.cc:3:43: warning: unknown command tag name
[-Wdocumentation-unknown-command]
* Copyright (C) 2019 Bugs H. Unter (<a href="mailto:email@domain.com">email@domain.com</a>)
^~~~~~~
2 warnings generated.
No warning is generated
-----------------------------------
tgm@asus:/tmp/bug$ rm *.o; cat main-ok.cc && clang++
-Wdocumentation-unknown-command main-ok.cc
/**
* @file
* Copyright (C) 2019 Bugs H. Unter (<a href="mailto:email@domain.com">email@domain.com</a>)
*
* Created on Apr 9, 2019
*
*/
//# -- if there is at least one '#' between the comment and main, then no
warning is reported
int main() {
return 0;
}
Clang version
----------------------------------
tgm@asus:/tmp/bug$ clang++ --version
clang version 10.0.0 (<a href="https://github.com/llvm/llvm-project.git">https://github.com/llvm/llvm-project.git</a>
4650b2f36949407ef25686440e3d65ac47709deb)
Target: x86_64-unknown-linux-gnu
Thread model: posix</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>