From owner-cvs-all Thu Dec 6 20:23:57 2001 Delivered-To: cvs-all@freebsd.org Received: from technokratis.com (modemcable099.144-201-24.mtl.mc.videotron.ca [24.201.144.99]) by hub.freebsd.org (Postfix) with ESMTP id F3D9A37B416; Thu, 6 Dec 2001 20:23:35 -0800 (PST) Received: (from bmilekic@localhost) by technokratis.com (8.11.4/8.11.3) id fB74OZd39079; Thu, 6 Dec 2001 23:24:35 -0500 (EST) (envelope-from bmilekic) Date: Thu, 6 Dec 2001 23:24:35 -0500 From: Bosko Milekic To: Mike Silbersack Cc: Robert Watson , Matthew Dillon , Chad David , Luigi Rizzo , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man7 tuning.7 Message-ID: <20011206232435.A39016@technokratis.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: ; from silby@silby.com on Thu, Dec 06, 2001 at 10:34:49PM -0500 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Thu, Dec 06, 2001 at 10:34:49PM -0500, Mike Silbersack wrote: > On Thu, 6 Dec 2001, Robert Watson wrote: > > > "FreeBSD 4.3 flirted with turning off IDE write caching" doesn't necessary > > come across more clearly than "In FreeBSD 4.3, we experimented with > > disabling IDE write caching by default." Optionally adding "to address > > legitimate concerns with data integrity". It's still written in an > > informal tone (use of "we", et al) but it may be more clear. It not only > > makes us look more professional, but it also makes it seems like we don't > > consider our system a joke: we didn't flirt, we weighed the choices, > > decided on something, and later changed our minds based on available > > evidence and user needs. > > Yeesh, we're getting quite uptight here. Matt's word choice was, well, > Matt's word choice because he wrote the page. While some of it may be > funny, none of it is offensive. Let's quit the nitpicking and leave it > alone unless there are technical details to be changed. I'm sure the rest > of us have better things to do. I don't get it. What's the big deal with nitpicking on something like this? If it sounds unprofessional, it certainly *should* be changed; this is a man page we're talking about, not a comment! It seems that the actual `nitpicking' is occuring in response to the commit, not in the commit itself. :-) In summary, we shouldn't be opposed to seeing other people make man pages sound more professional; the only time I would be opposed and comment on it is if someone asked me to stop whatever technical thing I'm working on so that I can "turn my man page text more professional," which clearly isn't the case here. The case here is that of someone else coming in and fixing it *for* me. How can anyone complain about that? > Mike "Silby" Silbersack Cheerio, -- Bosko Milekic bmilekic@technokratis.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message