From owner-cvs-all@FreeBSD.ORG Wed May 7 18:59:51 2003 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0D7EB37B401; Wed, 7 May 2003 18:59:51 -0700 (PDT) Received: from smtp-relay.omnis.com (smtp-relay.omnis.com [216.239.128.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id 49C7E43FBD; Wed, 7 May 2003 18:59:47 -0700 (PDT) (envelope-from wes@softweyr.com) Received: from salty.rapid.stbernard.com (corp-2.ipinc.com [199.245.188.2]) by smtp-relay.omnis.com (Postfix) with ESMTP id 570CF1B483; Wed, 7 May 2003 18:59:45 -0700 (PDT) From: Wes Peters Organization: Softweyr.com To: John Baldwin , David Schultz Date: Wed, 7 May 2003 18:59:44 -0700 User-Agent: KMail/1.5 References: In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200305071859.44725.wes@softweyr.com> cc: Tom Rhodes cc: Doug Barton cc: des@FreeBSD.ORG cc: Hiten Pandya cc: doc-committers@FreeBSD.ORG cc: cvs-all@FreeBSD.ORG cc: cvs-doc@FreeBSD.ORG Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/disks chapter.sgml X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 May 2003 01:59:51 -0000 On Wednesday 07 May 2003 10:04, John Baldwin wrote: > On 07-May-2003 David Schultz wrote: > > > > I don't think that there's any requirement that FreeBSD > > documentation read like a Henry James novel. Some people have > > colorful writing styles that involve words such as > > ``automagical'', ``moot'', and ``kludge'', and I'm not convinced > > that this is a problem. Documentation isn't my domain, so I won't > > stick my nose into this any further, but unless our translators > > and other non-native English speakers have major qualms about > > this kind of detail, I do consider this to be gratuitous. > > Agreed. automagical is a favorite word of several folks and does > have a slightly different connotation from just 'automatic'. :) In general, documentation sweeps to "clean up" somewhat colorful uses of language are not a good idea. All whining about producing a professional product aside, most of us work on FreeBSD because it pleases us. One of these days I'm going to go put the BUGS sections back in the AIO man pages and behead anyone who removes them again, for instance. -- "Where am I, and what am I doing in this handbasket?" Wes Peters wes@softweyr.com