GNOME Bugzilla – Bug 152990
Allow to document unnamed function arguments in prototypes.
Last modified: 2018-07-30 10:33:02 UTC
The paramters in the following example can not be documented, since they have no names. This is unfortumate, since for prototypes in header files it is recommended not to add names to the parameters. extern unsigned int function1 ( long, /**< This is the description of the first argument */ float /**< This is the description of the second argument */ );
I vote for this enhancement too! I think it would be easy to implement it to allow just one argument of each type, if no label is present, just put the type in the hash. If there are multiple arguments of the same type, they should be named so they can be referred to in the documentation.
I also noticed this bug. It's still present in v1.5.2 on Windows XP. Is anyone actually working on these bugs? Some of them are years old.
This is not a bug, it is an enhancement request (and correctly marked as such). And yes I'm still working on fixing bugs, but I seem to be the only one, or are you volunteering to help? You could add a patch that adds this feature for instance...
Apologies Dimitri, I didn't mean to imply you were lazy or anything. It just seems like a very long time since this was added, and you know how impatient we users are. I hope I have time to work on this. We should have a race to see who can fix^H^H^H add this first. ;) I do have a lot of projects on right now, but if I can help I will. Not knowing the code at all, it would help if you could point me towards the right source file.
I'm sorry digging up this old ticket, but this exact issue is still not fixed. Is there any work in progress? (I guess not :-) ) I'd suggest to allow something like "@anon1, @anon2, ..." instead of an actual parameter name...
There has been a small discussion on stackexchange regarding this problem as well, with some workaround, see: http://stackoverflow.com/questions/27003694/how-to-get-doxygen-to-use-and-recognize-commented-out-argument-names
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!