Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 10 Nov 2012 14:29:00 -0800
From:      Alfred Perlstein <bright@mu.org>
To:        Ian Lepore <freebsd@damnhippie.dyndns.org>
Cc:        svn-src-head@freebsd.org, svn-src-all@freebsd.org, Alfred Perlstein <alfred@freebsd.org>, Eitan Adler <eadler@freebsd.org>, src-committers@freebsd.org
Subject:   Re: svn commit: r242847 - in head/sys: i386/include kern
Message-ID:  <509ED52C.3030308@mu.org>
In-Reply-To: <1352568275.17290.85.camel@revolution.hippie.lan>
References:  <201211100208.qAA28e0v004842@svn.freebsd.org> <CAF6rxg=HPmQS1T-LFsZ=DuKEqH30iJFpkz%2BJGhLr4OBL8nohjg@mail.gmail.com> <509DC25E.5030306@mu.org> <509E3162.5020702@FreeBSD.org> <509E7E7C.9000104@mu.org> <CAF6rxgmV8dx-gsQceQKuMQEsJ%2BGkExcKYxEvQ3kY%2B5_nSjvA3w@mail.gmail.com> <509E830D.5080006@mu.org> <1352568275.17290.85.camel@revolution.hippie.lan>

next in thread | previous in thread | raw e-mail | index | archive | help
On 11/10/12 9:24 AM, Ian Lepore wrote:
> On Sat, 2012-11-10 at 08:38 -0800, Alfred Perlstein wrote:
>> On 11/10/12 8:25 AM, Eitan Adler wrote:
>>> On 10 November 2012 11:19, Alfred Perlstein <bright@mu.org> wrote:
>>>> Please consult the svn log for this file, it's relatively clear
>> just in the
>>>> commit logs/comments.  Grep for 384/512 and look around.
>>> Can this reasoning be added as a comment? I did grep for 384 in the
>> log, but
>>> a) I didn't find the answer
>>> b) one shouldn't have to.
>>>
>>>
>> It probably could be added, but then a bunch of other people would
>> complain about the comment being too wordy or "not in English".
> The fact that such a thing could happen explains much about the current
> state of the code.  An outsider could easily come to the conclusion that
> the FreeBSD motto is something along the lines of "It should be as hard
> to read as it was to write."
>
> -- Ian
>
>
Ian,

I am very much in favor of commenting code.  In fact I would like to 
have more "story like" comments
that explain things in the code.

Unfortunately, EVERY TIME I DO THIS I get a bikeshed on it and it soaks 
up a whole day if not more.

FreeBSD community needs to rally behind people, not block them for 
making changes like these.

Why do you think no one had the balls to touch maxusers in the first place?
... If you guessed "not worth the bikeshed" you'd be right.

-Alfred




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?509ED52C.3030308>