Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 14 Jul 2001 21:10:33 -0500
From:      Alfred Perlstein <alfred@FreeBSD.org>
To:        John Baldwin <jhb@FreeBSD.org>
Cc:        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:  <20010714211033.D15299@sneakerz.org>
In-Reply-To: <XFMail.010714170326.jhb@FreeBSD.org>; from jhb@FreeBSD.org on Sat, Jul 14, 2001 at 05:03:26PM -0700
References:  <20010710073050.4F2D33E32@bazooka.unixfreak.org> <XFMail.010714170326.jhb@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
* 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.)
> 
> 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.

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? :)

-- 
-Alfred Perlstein [alfred@freebsd.org]
Ok, who wrote this damn function called '??'?
And why do my programs keep crashing in it?

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?20010714211033.D15299>