[llvm-bugs] [Bug 35144] New: -Wdocumentation produces false positive for \tparam with instantiated function

via llvm-bugs llvm-bugs at lists.llvm.org
Tue Oct 31 05:11:06 PDT 2017


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

            Bug ID: 35144
           Summary: -Wdocumentation produces false positive for \tparam
                    with instantiated function
           Product: clang
           Version: 5.0
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P
         Component: C++
          Assignee: unassignedclangbugs at nondot.org
          Reporter: techmeology at techmeology.co.uk
                CC: dgregor at apple.com, llvm-bugs at lists.llvm.org

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

Steps to reproduce:
1) Compile the `bug.cpp` with `clang++ -Wdocumentation -c bug.cpp` using Clang
5.0
2) Comment out line 7, and recompile as in step 1.

Expected results:
No warning should be emitted for either of the two steps above.

Actual results:
The following warning is emitted at step 1, but not step 2:

bug.cpp:2:5: warning: '\tparam' command used in a comment that is not attached
to a template declaration [-Wdocumentation]
 * \tparam T The type of the inputs' elements.
    ^~~~~~
1 warning generated.

-- 
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/20171031/d5739835/attachment.html>


More information about the llvm-bugs mailing list