Deliberately breaking software (was: cvs commit: src/sys/dev/vinum vinumioctl.c)

[John Hay]

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 at icomtek.csir.co.za / jhay at FreeBSD.org