LLVM Bugzilla is read-only and represents the historical archive of all LLVM issues filled before November 26, 2021. Use github to submit LLVM bugs

Bug 35144 - -Wdocumentation produces false positive for \tparam with instantiated function
Summary: -Wdocumentation produces false positive for \tparam with instantiated function
Status: NEW
Alias: None
Product: clang
Classification: Unclassified
Component: C++ (show other bugs)
Version: 5.0
Hardware: PC Linux
: P enhancement
Assignee: Unassigned Clang Bugs
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-10-31 05:11 PDT by techmeology
Modified: 2021-10-19 16:59 PDT (History)
3 users (show)

See Also:
Fixed By Commit(s):

Attachments
Reproducer (572 bytes, text/x-c++src)
2017-10-31 05:11 PDT, techmeology 		Details
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description techmeology 2017-10-31 05:11:06 PDT 
Created attachment 19363 [details]
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.
Comment 1 tln 2021-10-19 16:59:21 PDT 
Hi there. This bug still affects me with Clang 11.