<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 - -fcomment-block-commands wrongly assumes that those commands take paragraphs as arguments"
href="https://bugs.llvm.org/show_bug.cgi?id=32909">32909</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>-fcomment-block-commands wrongly assumes that those commands take paragraphs as arguments
</td>
</tr>
<tr>
<th>Product</th>
<td>clang
</td>
</tr>
<tr>
<th>Version</th>
<td>trunk
</td>
</tr>
<tr>
<th>Hardware</th>
<td>All
</td>
</tr>
<tr>
<th>OS</th>
<td>All
</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>Frontend
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>m-llvm@bodyfour.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org
</td>
</tr></table>
<p>
<div>
<pre>Created <span class=""><a href="attachment.cgi?id=18403" name="attach_18403" title="Trivial C program with some doxygen commands clang doesn't recognize by default">attachment 18403</a> <a href="attachment.cgi?id=18403&action=edit" title="Trivial C program with some doxygen commands clang doesn't recognize by default">[details]</a></span>
Trivial C program with some doxygen commands clang doesn't recognize by default
There are already some open bugs about how -Wdocumentation-unknown-command
isn't well-sycned with the current list of doxygen commands (#17437, #19581,
maybe others?) A work around for this is to list them as "local" commands via
-fcomment-block-commands.
However, this doesn't work for commands that *don't* take arguments. For
instance, this simple case including some normal doxygen commands that clang
doesn't recognize out-of-the box (@file,@cond,@endcond)
/**
* @file test-comment-block-commands.c
*
* @brief Stuff here
*
* @cond FOO
* @note Something
* @endcond
*/
extern int a;
int a = 99;
If you compile with:
$ clang -Wdocumentation -Wdocumentation-unknown-command
-fcomment-block-commands=file,cond,endcond -fsyntax-only
test-comment-block-commands.c
You get the bogus warning:
test-comment-block-commands.c:8:12: warning: empty paragraph passed to
'@endcond' command [-Wdocumentation]
There are lots of doxygen commands that don't take arguments, so
"-fcomment-block-commands" shouldn't be making assumptions about what type of
arguments such a command would take.</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>