NetBSD Problem Report #44761

From riz@netbsd-i386.localdomain  Wed Mar 23 19:02:41 2011
Return-Path: <riz@netbsd-i386.localdomain>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by www.NetBSD.org (Postfix) with ESMTP id E756063BABA
	for <gnats-bugs@gnats.NetBSD.org>; Wed, 23 Mar 2011 19:02:40 +0000 (UTC)
Message-Id: <20110323170308.AD4CEE0071@netbsd-i386.localdomain>
Date: Wed, 23 Mar 2011 10:03:08 -0700 (PDT)
From: riz@NetBSD.org
Reply-To: riz@NetBSD.org
To: gnats-bugs@gnats.NetBSD.org
Subject: config_cfdriver_attach() and other functions need documentation
X-Send-Pr-Version: 3.95

>Number:         44761
>Category:       kern
>Synopsis:       More autoconf(9) functions should be documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Mar 23 19:05:01 +0000 2011
>Originator:     Jeff Rizzo
>Release:        NetBSD 5.99.48
>Organization:

>Environment:


System: NetBSD netbsd-i386 5.99.48 NetBSD 5.99.48 (TUTORIAL) #1: Tue Mar 22 11:56:44 PDT 2011 riz@netbsd-i386:/usr/src/sys/arch/i386/compile/TUTORIAL i386
Architecture: i386
Machine: i386
>Description:
	Working with the driver tutorials in an effort to modernize them,
I came across some functions in vnd.c which should be documented somewhere
in section 9, probably autoconf(9).

Here are the functions I think should be documented:

config_cfdriver_attach
config_cfdriver_detach
config_cfdriver_lookup
config_cfattach_attach
config_cfattach_detach
config_cf_attach_lookup
config_cf_attach_lookup_cd
devsw_attach
devsw_detach
>How-To-Repeat:
	Try to learn about these functions without resorting to source code
and guesses about intent.

>Fix:
	Add documentation.  (sorry, none given yet)

>Unformatted:

Home	PR Database Search