<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 - -Wdocumentation generates error with @see @ref"
href="https://bugs.llvm.org/show_bug.cgi?id=38905">38905</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>-Wdocumentation generates error with @see @ref
</td>
</tr>
<tr>
<th>Product</th>
<td>clang
</td>
</tr>
<tr>
<th>Version</th>
<td>3.9
</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>C++
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedclangbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>rose@r2air.com
</td>
</tr>
<tr>
<th>CC</th>
<td>dgregor@apple.com, llvm-bugs@lists.llvm.org
</td>
</tr></table>
<p>
<div>
<pre>clang++ generates an error on a valid doxygen block that uses the @see tag.
Steps to reproduce:
$ cat docbug.cc
/**
* @see @ref FOO
*/
int function() {
return 0;
}
$ clang++ -Werror -Wdocumentation -c docbug.cc -o docbug.o
Actual result:
docbug.cc:3:8: warning: empty paragraph passed to '@see' command
[-Wdocumentation]
* @see @ref FOO
Expected result:
<no error>
Doxygen (tested versions 1.8.11 and 1.8.13) interpret this as valid markup.</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>