From owner-cvs-all Thu Dec 6 14:47: 7 2001 Delivered-To: cvs-all@freebsd.org Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by hub.freebsd.org (Postfix) with ESMTP id 3D21337B405; Thu, 6 Dec 2001 14:47:00 -0800 (PST) Received: from fledge.watson.org (robert@fledge.pr.watson.org [192.0.2.3]) by fledge.watson.org (8.11.6/8.11.5) with SMTP id fB6Mkai30155; Thu, 6 Dec 2001 17:46:36 -0500 (EST) (envelope-from robert@fledge.watson.org) Date: Thu, 6 Dec 2001 17:46:35 -0500 (EST) From: Robert Watson X-Sender: robert@fledge.watson.org To: Chad David Cc: Luigi Rizzo , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man7 tuning.7 In-Reply-To: <20011206154216.A94670@colnta.acns.ab.ca> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII 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, 6 Dec 2001, Chad David wrote: > How is something like this? It isn't quite as broken out as it could > be, mostly because I tried to use as much of the original text as > possible. I have fixed a few spelling mistakes etc. but it still needs > work. I did add a litte text around the keepalive section. > > The question I struggled with while putting this together was do we > group by system (disk, memory, network etc.), or do we group by tunable > section (filesystem layout etc., sysctl's and tunables, kernel config, > etc.)? Now that I've gone through it all, I think it should be > structured more like was suggested then how I updated it. By trying to > group it by tunable section I ended up with some data spread all over > the file. I think the proposed strategy of sorting by topic may be the best approach--in a sense, I don't care so much about the vehicle by which I optimize performance, as the effect of the optimization, or how it relates to a problem I've identified. > Another question was if we wanted to maintain Matt's informal tone? > Some terms like "network suds" give the manual a more playful feeling > which I tried not to kill (although I did change a lot of 'I's to > 'we's). I cleaned up a little of that in my recent commits, and I suspect continuing to move gradually in the direction of formalism might be a good thing. But maybe I'm old and dusty. One of the concerns I did have was about the "currency" of the information: for example, the manpage advises the reader not to use IDE tagged stuff. It should probably qualify such statements with "at the time this document was written". These statements have a tendency to get old fast, and not get updated for long periods of time. Robert N M Watson FreeBSD Core Team, TrustedBSD Project robert@fledge.watson.org NAI Labs, Safeport Network Services To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message