From owner-freebsd-arch Fri Sep 28 16:23:31 2001 Delivered-To: freebsd-arch@freebsd.org Received: from InterJet.elischer.org (c421509-a.pinol1.sfba.home.com [24.7.86.9]) by hub.freebsd.org (Postfix) with ESMTP id C253837B40C; Fri, 28 Sep 2001 16:23:28 -0700 (PDT) Received: from localhost (localhost.elischer.org [127.0.0.1]) by InterJet.elischer.org (8.9.1a/8.9.1) with ESMTP id RAA72766; Fri, 28 Sep 2001 17:17:13 -0700 (PDT) Date: Fri, 28 Sep 2001 17:17:12 -0700 (PDT) From: Julian Elischer To: Paul Richards Cc: John Baldwin , Warner Losh , arch@FreeBSD.org Subject: Re: Style Wars In-Reply-To: <441890000.1001717107@lobster.originative.co.uk> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-arch@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Fri, 28 Sep 2001, Paul Richards wrote: > Could we perhaps modify style to state intent rather than the method. > > The intent here is to align the names; attempting to formulate a set method > is too rigid and causes people to leap up and down when style isn't > followed to the letter even when the outcome is not good looking code. > > Can't we change the general tone of style to say things like > > "names should be aligned for ease of readibility" > > rather than the rigid "one tab after type" etc. > > To avoid lots of whitespace problems there can be a general guidline that > "tabs will be used as much as possible and the tabstop is 8" or something > so that the previous statement that "names should be aligned" will lead to > the minimum number of tabs plus additional spacing being used to do the > alignment. > > I think stating intent, rather than method will reduce a lot of the > quibbling over style issues because people will understand what's being > aimed for and won't bridle so much over dogmatic rules. Not a bad idea. "When defining sub elements of a structure, tabs should be used to allign the name parts so as to ease reading." e.g. [example given in previous mail] (end quote) " > > > Paul Richards > FreeBSD Services Ltd > http://www.freebsd-services.com > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-arch" in the body of the message > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message