This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc 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: Marking of functions with attributes like __wur


On Wed, Apr 11, 2012 at 3:36 PM, Roland McGrath <roland@hack.frob.com> wrote:
>> I had started working on this page earlier this week and it isn't
>> nearly complete or ready but it may be a good place to add this:
>>
>> http://sourceware.org/glibc/wiki/Style_and_Conventions
>
> Actually I think this is a separate and more serious subject than that one.
> Details about coding style are certainly good to document. Â(Though I don't
> think we should go into a lot of detail that is redundant with the GNU
> Coding Standards.) ÂBut errors in that sphere can always be fixed up later.
> API additions are a much more serious issue and many errors can be things
> we'll be stuck with for a long time once they appear in a release. Â(This
> is not true of things like __wur annotations, but still.)

I've removed the section on API additions (so it can be described in
detail elsewhere).  I've indicated that this page is not to be a
reiteration of the existing GNU coding standards but rather an
extension and clarification specific to GLIBC.

Ryan


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