This is the mail archive of the
gcc@gcc.gnu.org
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 <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