From owner-freebsd-doc Wed Oct 6 10:33:44 1999 Delivered-To: freebsd-doc@freebsd.org Received: from typhoon.mail.pipex.net (typhoon.mail.pipex.net [158.43.128.27]) by hub.freebsd.org (Postfix) with SMTP id 676C314C31 for ; Wed, 6 Oct 1999 10:33:31 -0700 (PDT) (envelope-from mark@dogma.freebsd-uk.eu.org) Received: (qmail 25212 invoked from network); 6 Oct 1999 17:33:27 -0000 Received: from userbq85.uk.uudial.com (HELO marder-1.) (62.188.146.179) by smtp.dial.pipex.com with SMTP; 6 Oct 1999 17:33:27 -0000 Received: (from mark@localhost) by marder-1. (8.9.3/8.8.8) id SAA01135; Wed, 6 Oct 1999 18:14:01 +0100 (BST) (envelope-from mark) Date: Wed, 6 Oct 1999 18:14:01 +0100 From: Mark Ovens To: John Baldwin Cc: Narvi , FreeBSD Documentation Project , Neil Blakey-Milner Subject: Re: Style Challenge! Message-ID: <19991006181401.B373@marder-1> References: <199910061555.LAA04859@server.baldwin.cx> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0pre2i In-Reply-To: <199910061555.LAA04859@server.baldwin.cx> Organization: Total lack of Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Oct 06, 1999 at 11:55:21AM -0400, John Baldwin wrote: > > On 06-Oct-99 Narvi wrote: > > > > On Wed, 6 Oct 1999, Neil Blakey-Milner wrote: > > > >> On Wed 1999-10-06 (16:39), Narvi wrote: > >> > > . Two spaces after '.' > >> > > > >> > > >> > No!!!! I can't see why you should even think about this. > >> > >> It's much more readable in my opinion, and it does seem to be the > >> way > >> things are being done currently. > >> > > > > They aren't. About half of the articles are that way. > > > > The same applies to the handbook. A lot of the periods have only one > > space > > following them. > > > > I would vote for removing the double periods, not expanding the > > others to > > two. Or leaving them alone. > > Check the archives; we've already had this discussion (is this going to > be the async-kernel syscalls debate of -doc?!?) and the final decision > was to use two (2) spaces between sentences. > I remember the debate, but I never understood why the hell it is so important. It seems to be that different countries have differing rules on this, but to be honest, when reading docs and e-mail I don't notice whether there are 2 spaces or only one (especially in proportional fonts). Having standards and adhering to them *is* important in any project but it is possible to go OTT and this seems to be a case in point. We have a similar thing at work with coding; the CoP states that line continuation \'s should have no preceding space ( if(blah)\ ) but half of us use one ( if(blah) \ ). > >> There are no translations, to my knowledge, that correspond to the > >> English articles, as opposed to the books (handbook, faq, &c.). > >> > > > > Handbook and articles should imho follow the same style. > > Umm.. his point above is about availability of translations, nothing > about style. :) > > --- > > John Baldwin -- http://www.cslab.vt.edu/~jobaldwi/ > PGP Key: http://www.cslab.vt.edu/~jobaldwi/pgpkey.asc > "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message -- STATE-OF-THE-ART: Any computer you can't afford. OBSOLETE: Any computer you own. ________________________________________________________________ FreeBSD - The Power To Serve http://www.freebsd.org My Webpage http://ukug.uk.freebsd.org/~mark/ mailto:mark@ukug.uk.freebsd.org http://www.radan.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message