This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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 <law@redhat.com> wrote:
>> On 10/04/2016 03:08 PM, Jason Merrill wrote:
>>> On Tue, Oct 4, 2016 at 4:29 PM, Zan Lynx <zlynx@acm.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.

C++ does allow names, they just haven't been added to GCC headers yet.

Jason


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]