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 14335 - [-Wdocumentation] Multiple identifiers (comma,separated) are not recognized on \param
Summary: [-Wdocumentation] Multiple identifiers (comma,separated) are not recognized o...
Status: CONFIRMED
Alias: None
Product: clang
Classification: Unclassified
Component: Frontend (show other bugs)
Version: trunk
Hardware: All All
: P normal
Assignee: Mark de Wever
URL:
Keywords:
: 25751 (view as bug list)
Depends on:
Blocks:
 
Reported: 2012-11-13 20:17 PST by NAKAMURA Takumi
Modified: 2019-12-28 11:18 PST (History)
8 users (show)

See Also:
Fixed By Commit(s):


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description NAKAMURA Takumi 2012-11-13 20:17:44 PST
clang/lib/CodeGen/CGClass.cpp:1092:12: error:
      parameter 'argBegin,argEnd' not found in the function declaration
      [-Werror,-Wdocumentation]
/// \param argBegin,argEnd the arguments to evaluate and pass to the
           ^~~~~~~~~~~~~~~
IMO it is well-known description.
Comment 1 NAKAMURA Takumi 2012-12-23 20:05:09 PST
I have made them pruned in r171015, for now.
I will leave this open.


--- a/lib/CodeGen/CGClass.cpp
+++ b/lib/CodeGen/CGClass.cpp
@@ -1089,8 +1089,6 @@ void CodeGenFunction::EnterDtorCleanups(const CXXDestructorDecl *DD,
 /// constructor for each of several members of an array.
 ///
 /// \param ctor the constructor to call for each element
-/// \param argBegin,argEnd the arguments to evaluate and pass to the
-///   constructor
 /// \param arrayType the type of the array to initialize
 /// \param arrayBegin an arrayType*
 /// \param zeroInitialize true if each element should be
@@ -1116,8 +1114,6 @@ CodeGenFunction::EmitCXXAggrConstructorCall(const CXXConstructorDecl *ctor,
 /// \param ctor the constructor to call for each element
 /// \param numElements the number of elements in the array;
 ///   may be zero
-/// \param argBegin,argEnd the arguments to evaluate and pass to the
-///   constructor
 /// \param arrayBegin a T*, where T is the type constructed by ctor
 /// \param zeroInitialize true if each element should be
 ///   zero-initialized before it is constructed
Comment 2 Roberto Bagnara 2015-12-04 22:16:10 PST
This very annoying bug is still present:

$ clang-3.8 -Weverything -c p.c
p.c:4:11: warning: parameter 'a,b' not found in the function declaration
      [-Wdocumentation]
 * @param a,b parameters
          ^~~
1 warning generated.
Comment 3 NAKAMURA Takumi 2015-12-05 02:04:42 PST
*** Bug 25751 has been marked as a duplicate of this bug. ***
Comment 4 Teodor Petrov 2018-02-28 05:20:25 PST
Still present. Any chance for a fix for it?
Comment 5 Roman Lebedev 2018-02-28 05:27:24 PST
+1 i guess it will be nice/important for upcoming clang-doc
Comment 6 Mark de Wever 2019-12-28 11:18:28 PST
I posted a patch https://reviews.llvm.org/D71966