From owner-freebsd-hackers Tue Nov 7 15:35:31 2000 Delivered-To: freebsd-hackers@freebsd.org Received: from fw.wintelcom.net (ns1.wintelcom.net [209.1.153.20]) by hub.freebsd.org (Postfix) with ESMTP id 9CBB737B4C5; Tue, 7 Nov 2000 15:35:28 -0800 (PST) Received: (from bright@localhost) by fw.wintelcom.net (8.10.0/8.10.0) id eA7NZSP14249; Tue, 7 Nov 2000 15:35:28 -0800 (PST) Date: Tue, 7 Nov 2000 15:35:27 -0800 From: Alfred Perlstein To: John Baldwin Cc: hackers@FreeBSD.ORG, jkh@FreeBSD.ORG Subject: Re: Documenting sysV IPC tunables. Message-ID: <20001107153527.J5112@fw.wintelcom.net> References: <20001107152711.H5112@fw.wintelcom.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.4i In-Reply-To: ; from jhb@FreeBSD.ORG on Tue, Nov 07, 2000 at 03:32:48PM -0800 Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG * John Baldwin [001107 15:33] wrote: > > On 07-Nov-00 Alfred Perlstein wrote: > > * Alfred Perlstein [001107 14:58] wrote: > >> I have a patch here that I'd like to get into LINT for 4.2, > >> it _finally_ documents the sysV IPC tunables. > >> > >> I'll also be applying this patch to NOTES for -current. > > > > Bah, someone beat me for -current, but I like my patch better > > because it groups the options together with the "include support for" > > options. > > Why not reorder what is already in NOTES then rather than cutting out most of > the comments? The existing comments in -current are more verbose and helpful > to people trying to read it to learn. I don't think this really qualifies as a > bug fix, but it is up to Jordan if he'll let you MFC it. Actually, I'm up for MFC'ing the current set of documentation or applying my patch directly to LINT (and leaving NOTES alone). I'll let Jordan make the call on what he'd like to see in 4.x. I'd really like to see this get done because of what I see on the postrgresql lists and my own experiances not having fun trying to tune for semaphores and shared memory by having to grovel through the kernel source to get a clue as to what each tunable does. It would be a really nice 'feature' to be in 4.2 and not having these things documented almost qualifies as a bug. -- -Alfred Perlstein - [bright@wintelcom.net|alfred@freebsd.org] "I have the heart of a child; I keep it in a jar on my desk." To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message