Date: Sat, 14 Jul 2001 23:55:59 -0600 From: Chad David <davidc@acns.ab.ca> To: Alfred Perlstein <alfred@FreeBSD.org> Cc: John Baldwin <jhb@FreeBSD.org>, Dima Dorfman <dima@unixfreak.org>, Chad David <davidc@acns.ab.ca>, cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org Subject: Re: cvs commit: src/share/man/man9 cdevsw_add.9 cdevsw_remove.9 Message-ID: <20010714235559.A40654@colnta.acns.ab.ca> In-Reply-To: <20010714211033.D15299@sneakerz.org>; from alfred@FreeBSD.org on Sat, Jul 14, 2001 at 09:10:33PM -0500 References: <20010710073050.4F2D33E32@bazooka.unixfreak.org> <XFMail.010714170326.jhb@FreeBSD.org> <20010714211033.D15299@sneakerz.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jul 14, 2001 at 09:10:33PM -0500, Alfred Perlstein wrote: > * John Baldwin <jhb@FreeBSD.org> [010714 19:05] wrote: > > > > On 10-Jul-01 Dima Dorfman wrote: > > > Alfred Perlstein <alfred@FreeBSD.org> writes: > > >> alfred 2001/07/10 00:25:18 PDT > > >> > > >> Added files: > > >> share/man/man9 cdevsw_add.9 cdevsw_remove.9 devsw.9 > > >> major.9 minor.9 umajor.9 uminor.9 > > >> vn_isdisk.9 > > > > > > This is great stuff, but wouldn't it be better to merge some of these > > > into one man page? Stuff like major.9 and minor.9 definitely don't > > > below in separate files. Same for umajor/uminor and > > > cdevsw_add/cdevsw_remove. Same might apply to some of the other man > > > pages (I thought I saw something similar, but can't recall right now.) Not this message again :-(. It and some others cost me about 24hrs of mdoc studying, document rewritting and repository merging... Actually I have been very happy with the support I've received from various sources; notibly alfred, ru and shealdonh. Thank you all again. > > > > I agree, having lockmgr.9 contain all the lockmgr related functions, and a > > cdevsw.9 would be nice. It keeps all the related material in one place so you > > can browse an API easily in one place. See atomic.9, kthread.9, mutex.9, etc. > > as examples of this. I agree that a bunch of the ones I have written could be grouped, but I have to struggle with two evils; one, write every man page on the subject before I submit any thing or two, create one big page with a bunch of holes in it and then have to justify that... What I would prefer to do is start out with individual pages and then merge them when their bulk begins to demand it, or my rewritting the same intro over and over starts to drive me crazy. > > Well I'm proud to state that all this 'discussion' seems to have > scared Chad away from wrinting manpages that don't conform to all > of our 200 developers' ideas of perfection. Meaning I haven't > heard from him since these useless suggestions started pouring in. > > So with the threat of rouge manpages gone, we can all sleep a little > easier, right? :) Actually Alfred I am suprised to hear you say that you have not heard from me. I have kept you on the cc list during my discussions with ru over the last few days, and I sent you at least one private email yesterday. You should also have received an email last night that was cc'd to ru and sheldonh containing my latest pages. If you are not receiving these then that is a problem that we should resolve ASAP. Chad To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010714235559.A40654>