<html>
<head>
<base href="https://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] spurious `warning: empty paragraph passed to '\returns' command`"
href="https://llvm.org/bugs/show_bug.cgi?id=24881">24881</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>[-Wdocumentation] spurious `warning: empty paragraph passed to '\returns' command`
</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>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>chisophugis@gmail.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org
</td>
</tr>
<tr>
<th>Classification</th>
<td>Unclassified
</td>
</tr></table>
<p>
<div>
<pre>Created <span class=""><a href="attachment.cgi?id=14906" name="attach_14906" title="reproducer">attachment 14906</a> <a href="attachment.cgi?id=14906&action=edit" title="reproducer">[details]</a></span>
reproducer
See the attachment for the full reproducer, but clang is spuriously warning on
the `\li` inside `\returns` for constructs like this:
/// \brief does foo
///
/// \returns \li true, never
/// \li false, always
Doxygen accepts this and seems to do the right/expected thing.
This is used a fair amount in clang-tools-extra, causing spurious warnings,
e.g. <a href="http://reviews.llvm.org/P125">http://reviews.llvm.org/P125</a></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>