This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFC] Change coding style rule: 80 column "hard limit" for ChangeLogs
- From: Joel Brobecker <brobecker at adacore dot com>
- To: Doug Evans <dje at google dot com>
- Cc: Eli Zaretskii <eliz at gnu dot org>, gdb-patches <gdb-patches at sourceware dot org>
- Date: Thu, 9 Jan 2014 06:34:17 +0400
- Subject: Re: [RFC] Change coding style rule: 80 column "hard limit" for ChangeLogs
- Authentication-results: sourceware.org; auth=none
- References: <yjt261q0r886 dot fsf at ruffy dot mtv dot corp dot google dot com> <83bnzsw6ro dot fsf at gnu dot org> <20140105040005 dot GA3802 at adacore dot com> <CADPb22Tyt-r7CgtDL-f+k_MeWxfrwZrvpE8+dyJGh=WC=tK1gw at mail dot gmail dot com> <20140108114544 dot GN3802 at adacore dot com> <CADPb22R2ES=5S6sqUwfaRHcmCJCa5ssLWqgV3ZBaf1yUkJtA0g at mail dot gmail dot com>
> So how about a 74 soft limit and 80 hard limit for everything (modulo
> things like .exp files where we try to keep things under 80 but some
> lines are just long and best left as is).
>
> soft = "stay within the limit unless you have a reasonable reason to
> exceed, and we're not nitpicky on what reasonable is"
>
> hard = "do not exceed unless you just cannot do otherwise, and while
> there are exceptions, we are quite nitpicky on this one"
>
> Even that wording doesn't preclude different interpretations. I'm
> happy to tweak it. The high order bits for me are the same numbers
> for everything, and not being nitpicky on adherence to the soft limit.
I all works for me.
> If there are no objections, I will tweak your coding style cheat sheet
> wiki (just trying to save you the trouble, it's your page, feel free
> to edit as desired), and update other docs (the CodingStandards wiki
> doesn't exist, I'll create it and add something to get it going).
I don't consider it my property so feel free to edit and improve as
you see fit. The purpose is to have something as useful as possible
to others, and also as a way to keep track of past discussions that
lead to the various rules (hence HTML instead of texi). I initially
created it and put my name next to it to make it extra clear that
it's unofficial and WIP.
Now that gdbint has been moved to the wiki, I should probably think
of merging this with the rest of gdbinit at some point.
Thanks!
--
Joel