This is the mail archive of the
mailing list for the GCC project.
Re: style convention: /*foo_p=*/ to annotate bool arguments
> On Oct 5, 2016, at 12:12 PM, Jeff Law <email@example.com> wrote:
> On 10/04/2016 03:08 PM, Jason Merrill wrote:
>> On Tue, Oct 4, 2016 at 4:29 PM, Zan Lynx <firstname.lastname@example.org> 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.