Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 21 Jan 2000 17:42:20 +0000 (GMT)
From:      Jonathon McKitrick <jcm@dogma.freebsd-uk.eu.org>
To:        Greg Lehey <grog@lemis.com>
Cc:        keramida@ceid.upatras.gr, "Matthew D. Fuller" <fullermd@futuresouth.com>, freebsd-chat@freebsd.org
Subject:   Re: Pico, indentation (was: Re: The 3.4-STABLE sources ...)
Message-ID:  <Pine.BSF.4.21.0001211738230.28772-100000@dogma.freebsd-uk.eu.org>
In-Reply-To: <20000121224739.J918@mojave.worldwide.lemis.com>

next in thread | previous in thread | raw e-mail | index | archive | help


On Fri, 21 Jan 2000, Greg Lehey wrote:

>I don't fight style(9), because it makes for a uniform style in the
>project, and that makes it easier for people to find their way around.
>But I do regret that we're still tied to such tiny views of our code.

I agree.  I'm not an experienced programmer, nor do i remember punched
card readers (actually, i do, i just never used them.  I also remember
when harddrive heads we the size of dimes.  (:  But it seems to me
that there are many ways to format C code that makes it readable,
maintainable, and reasonably consistent.

>overview my assembler code.  In C, with indentation, the width is even
>more important, yet style(9) limits us to an absolute maximum of 9
>nesting levels, and effectively bars comments to the right of code.
>Both of these restrictions appear counterproductive to me.  They can
>result in gratuitous creation of subfunctions called only once in
>order to satisfy the layout requirements.

I've seen it said that the only comments should be at the beginning of
the function, and that if it requires more docs, then it should be
broken up.  I disagree.  SOmetimes there may be a few lines of code
that do something out of the ordinary that could be explained in a
line or two of comments, but that doesn't necessitate a new function
just for those lines.

-=> jm <=-

Actual penalty by referee in an American Football game:
"Unsportsmanlike conduct: giving him the business!  Fifteen yard
penalty, automatic first down!"



To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-chat" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.21.0001211738230.28772-100000>