Skip to content

-Wdocumentation gives warnings on HTML tags split across multiple lines, when Doxygen does not #28321

Closed
@llvmbot

Description

@llvmbot
Bugzilla Link 27947
Version 3.8
OS Linux
Reporter LLVM Bugzilla Contributor
CC @mordante

Extended Description

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
    */
    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
    ^
    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

Metadata

Metadata

Assignees

Labels

bugzillaIssues migrated from bugzillaclang:frontendLanguage frontend issues, e.g. anything involving "Sema"confirmedVerified by a second party

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions