This is the mail archive of the
mailing list for the GCC project.
Re: style convention: /*foo_p=*/ to annotate bool arguments
On Wed, Oct 5, 2016 at 12:18 PM, <Paul.Koning@dell.com> wrote:
>> On Oct 5, 2016, at 12:12 PM, Jeff Law <firstname.lastname@example.org> wrote:
>> On 10/04/2016 03:08 PM, Jason Merrill wrote:
>>> On Tue, Oct 4, 2016 at 4:29 PM, Zan Lynx <email@example.com> wrote:
>>> In GCC sources, I think users look at the function definition more
>>> often than the declaration in the header, the latter of which
>>> typically has neither comments nor parameter names.
>> So true. One could claim that our coding standards made a fundamental mistake -- by having all the API documentation at the implementation rather than at the declaration. Sigh....
> Yes, though the mistake started in C and C++ which allow declarations with only types, not names.
C++ does allow names, they just haven't been added to GCC headers yet.