https://bugs.llvm.org/show_bug.cgi?id=38905
Bug ID: 38905
Summary: -Wdocumentation generates error with @see @ref
Product: clang
Version: 3.9
Hardware: PC
OS: Linux
Status: NEW
Severity: normal
Priority: P
Component: C++
Assignee: unassignedclangb...@nondot.org
Reporter: r...@r2air.com
CC: dgre...@apple.com, llvm-bugs@lists.llvm.org
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.
--
You are receiving this mail because:
You are on the CC list for the bug.
_______________________________________________
llvm-bugs mailing list
llvm-bugs@lists.llvm.org
http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-bugs