From owner-cvs-all  Tue Jul 10  9:49:30 2001
Delivered-To: cvs-all@freebsd.org
Received: from colnta.acns.ab.ca (h24-68-206-125.sbm.shawcable.net [24.68.206.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id E2F2C37B401; Tue, 10 Jul 2001 09:49:24 -0700 (PDT)
	(envelope-from davidc@colnta.acns.ab.ca)
Received: (from davidc@localhost)
	by colnta.acns.ab.ca (8.11.4/8.11.3) id f6AGnLs60590;
	Tue, 10 Jul 2001 10:49:21 -0600 (MDT)
	(envelope-from davidc)
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>
References: <200107100725.f6A7PI652032@freefall.freebsd.org> <20010710073050.4F2D33E32@bazooka.unixfreak.org> <20010710024604.M1894@sneakerz.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20010710024604.M1894@sneakerz.org>; from alfred@FreeBSD.org on Tue, Jul 10, 2001 at 02:46:04AM -0500
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

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