From owner-cvs-all@FreeBSD.ORG  Sun May  4 23:55:07 2003
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id D322737B404; Sun,  4 May 2003 23:55:07 -0700 (PDT)
Received: from zibbi.icomtek.csir.co.za (zibbi.icomtek.csir.co.za
	[146.64.24.58])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 81A4043FCB; Sun,  4 May 2003 23:55:05 -0700 (PDT)
	(envelope-from jhay@zibbi.icomtek.csir.co.za)
Received: from zibbi.icomtek.csir.co.za (localhost [IPv6:::1])
	h456sx5v025344;	Mon, 5 May 2003 08:54:59 +0200 (SAST)
	(envelope-from jhay@zibbi.icomtek.csir.co.za)
Received: (from jhay@localhost)
	by zibbi.icomtek.csir.co.za (8.12.9/8.12.9/Submit) id h456swuI025343;
	Mon, 5 May 2003 08:54:58 +0200 (SAST)
	(envelope-from jhay)
Date: Mon, 5 May 2003 08:54:58 +0200
From: John Hay <jhay@icomtek.csir.co.za>
To: Poul-Henning Kamp <phk@phk.freebsd.dk>
Message-ID: <20030505065458.GA24741@zibbi.icomtek.csir.co.za>
References: <20030505055618.GA84427@wantadilla.lemis.com>
	<36667.1052116481@critter.freebsd.dk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <36667.1052116481@critter.freebsd.dk>
User-Agent: Mutt/1.4i
cc: Greg 'groggy' Lehey <grog@FreeBSD.org>
cc: cvs-src@FreeBSD.org
cc: src-committers@FreeBSD.org
cc: cvs-all@FreeBSD.org
Subject: Re: Deliberately breaking software (was: cvs commit:
	src/sys/dev/vinum vinumioctl.c)
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 05 May 2003 06:55:08 -0000

May I hijack this a little?

> Right now, you still do not use disk_create() to create proper
> disk-device in vinum, and that means that features which work with
> other disk devices in the system do not work with vinum.

#####
beast:~ > man disk_create
No manual entry for disk_create
#####

This has been bothering me a bit lately. We seem to add new APIs for
the kernel, that device drivers etc. should use, but by not documenting
them. How should one know which to use and which are not to be used?
Think of all the bus_* and other functions too. I think we make life
unnecessarily difficult for other device driver writers / mainatiners.
Remember there are third party drivers too.

John
-- 
John Hay -- John.Hay@icomtek.csir.co.za / jhay@FreeBSD.org