<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 does not count @code / @endcode blocks as part of a paragraph."
href="http://llvm.org/bugs/show_bug.cgi?id=17828">17828</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>-Wdocumentation does not count @code / @endcode blocks as part of a paragraph.
</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>Frontend
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>toojays@toojays.net
</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>If the content of a Doxygen paragraph is entirely contained within an
@code/@endcode block, Clang treats the paragraph as being empty, and
incorrectly warns about it.
jscott@saaz:~$ cat /tmp/foo.c
/**
* Some function on x and y.
*
* @param[in] x The x.
* @param[in] y The y.
* @pre @code x < y @endcode.
*/
void f (int x, int y)
{
(void) x;
(void) y;
}
jscott@saaz:~$ clang -Wdocumentation -c /tmp/foo.c
/tmp/foo.c:6:8: warning: empty paragraph passed to '@pre' command
[-Wdocumentation]
* @pre @code x < y @endcode.
~~~~^
1 warning generated.
This is with a Clang snapshot from the llvm Debian snapshots repo at version
1:3.4~svn190912-1~exp1.</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>