Date: Tue, 10 Jul 2001 10:49:21 -0600 From: Chad David <davidc@acns.ab.ca> To: Alfred Perlstein <alfred@FreeBSD.org> Cc: Dima Dorfman <dima@unixfreak.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, Chad David <davidc@acns.ab.ca> Subject: Re: cvs commit: src/share/man/man9 cdevsw_add.9 cdevsw_remove.9 devsw.9 major.9 minor.9 umajor.9 uminor.9 vn_isdisk.9 Message-ID: <20010710104921.A60485@colnta.acns.ab.ca> In-Reply-To: <20010710024604.M1894@sneakerz.org>; from alfred@FreeBSD.org on Tue, Jul 10, 2001 at 02:46:04AM -0500 References: <200107100725.f6A7PI652032@freefall.freebsd.org> <20010710073050.4F2D33E32@bazooka.unixfreak.org> <20010710024604.M1894@sneakerz.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Jul 10, 2001 at 02:46:04AM -0500, Alfred Perlstein wrote: > * Dima Dorfman <dima@unixfreak.org> [010710 02:30] 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.) > > I'm not much of a fan of overcrowded manpages, however you do have > good point. I'll leave it to Chad to make that call. I'm not really sure what I like. I don't really like how FreeBSD formats [some] large man pages (I need to take another look at AIX as I recall I liked that way they did it). I do agree that pages like major.9 could easily be merged, but I didn't really know what to name it (I've been reading man pages for eight years, but I just started writing them last week .. Any suggestions would be welcome :-)). To speed the process of writing these things I am going to throw together a little Swing app that will dump out the same format everytime, and I will try and come up with a layout that is easy to scan for what you want while maintaining the look and feel of older pages. Thanks again. 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?20010710104921.A60485>