[llvm-bugs] [Bug 27947] New: -Wdocumentation gives warnings on HTML tags split across multiple lines, when Doxygen does not

via llvm-bugs llvm-bugs at lists.llvm.org
Sun Aug 4 11:04:06 PDT 2019


https://bugs.llvm.org/show_bug.cgi?id=27947

            Bug ID: 27947
           Summary: -Wdocumentation gives warnings on HTML tags split
                    across multiple lines, when Doxygen does not
           Product: clang
           Version: 3.8
          Hardware: PC
                OS: Linux
            Status: CONFIRMED
          Severity: normal
          Priority: P
         Component: Frontend
          Assignee: koraq at xs4all.nl
          Reporter: abigail.buccaneer at gmail.com
                CC: koraq at xs4all.nl, llvm-bugs at lists.llvm.org
            Status: CONFIRMED
                CC: koraq at xs4all.nl
          Assignee: koraq at xs4all.nl

The following code is parsed fine by Doxygen and correctly rendered as a
hyperlink without any warnings - but -Wdocumentation gives a warning.

$ cat test.c
/**
 * <a
 * href="http://example.com/">test</a>
 */
int main(void) {
    return 0;
}
$ clang -Werror=documentation test.c
test.c:3:2: error: HTML start tag prematurely ended, expected attribute name or
'>' [-Werror,-Wdocumentation]
 * href="http://example.com/">test</a>
 ^
test.c:2:5: note: HTML tag started here
 * <a
    ^
1 error generated.
$ clang --version
clang version 3.8.0-2ubuntu3 (tags/RELEASE_380/final)
Target: x86_64-pc-linux-gnu
Thread model: posix
InstalledDir: /usr/bin

-- 
You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20190804/3184c256/attachment.html>


More information about the llvm-bugs mailing list