From owner-cvs-all Wed Mar 1 14:56:24 2000 Delivered-To: cvs-all@freebsd.org Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by hub.freebsd.org (Postfix) with ESMTP id 1A1EF37BCBA; Wed, 1 Mar 2000 14:56:09 -0800 (PST) (envelope-from grog@freebie.lemis.com) Received: (from grog@localhost) by freebie.lemis.com (8.9.3/8.9.0) id JAA02885; Thu, 2 Mar 2000 09:26:05 +1030 (CST) Date: Thu, 2 Mar 2000 09:26:05 +1030 From: Greg Lehey To: Brian Feldman Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: style (was: cvs commit: src/bin/dd dd.1) Message-ID: <20000302092605.Q87829@freebie.lemis.com> References: <200003010528.VAA26252@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre2i In-Reply-To: <200003010528.VAA26252@freefall.freebsd.org> WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk On Tuesday, 29 February 2000 at 21:28:46 -0800, Brian Feldman wrote: > green 2000/02/29 21:28:46 PST > > Modified files: > bin/dd dd.1 > Log: > After Bruce kindly explained the whole groff "sentence" idea to me, I've > put the whitespace in the right place. OK, I'll risk starting another flame war. Do we really need to revert to style guidelines that were probably outmoded 15 years ago? People were obviously actively leaving them already. As I understand it, the main objection to writing text "normally" is that it produces less repo bloat. Instead, the guidelines insist on a line break for every new sentence. This is just plain contrary to normal literary style. Like many aspects of style(9), it seems to have no better justification than "that's the way our grandfathers did it". This smacks of elitism or some such. I'm all for consistency, but does this consistency have to be of such a nature that it creates a style which is contrary to normal use? I've checked the repo bloat aspect; it's not always clear that this style does reduce bloat. Certainly it adds more lines. Consider the following rendition of this paragraph: OK, I'll risk starting another flame war. Do we really need to revert to style guidelines that were probably outmoded 15 years ago? People were obviously actively leaving them already. As I understand it, the main objection to writing text "normally" is that it produces less repo bloat. Instead, the guidelines insist on a line break for every new sentence. This is just plain contrary to normal literary style. Like many aspects of style(9), it seems to have no better justification than "that's the way our grandfathers did it". This smacks of elitism or some such. I'm all for consistency, but does this consistency have to be of such a nature that it creates a style which is contrary to normal use? I've checked the repo bloat aspect; it's not always clear that this style does reduce bloat. Certainly it adds more lines. Consider the following rendition of this paragraph: Does that really make sense? I think it's time to reconsider style and agree to change with the times. Greg -- Finger grog@lemis.com for PGP public key See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message