[llvm-bugs] [Bug 24881] New: [-Wdocumentation] spurious `warning: empty paragraph passed to '\returns' command`

[via llvm-bugs]

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

            Bug ID: 24881
           Summary: [-Wdocumentation] spurious `warning: empty paragraph
                    passed to '\returns' command`
           Product: clang
           Version: trunk
          Hardware: PC
                OS: All
            Status: NEW
          Severity: normal
          Priority: P
         Component: Frontend
          Assignee: unassignedclangbugs at nondot.org
          Reporter: chisophugis at gmail.com
                CC: llvm-bugs at lists.llvm.org
    Classification: Unclassified

Created attachment 14906
  --> https://llvm.org/bugs/attachment.cgi?id=14906&action=edit
reproducer

See the attachment for the full reproducer, but clang is spuriously warning on
the `\li` inside `\returns` for constructs like this:

/// \brief does foo
///
/// \returns \li true, never
///          \li false, always

Doxygen accepts this and seems to do the right/expected thing.
This is used a fair amount in clang-tools-extra, causing spurious warnings,
e.g. http://reviews.llvm.org/P125

-- 
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/20150919/f36d3996/attachment.html>