Subject: kern/4268: audio(9) description different from prototypes
To: None <gnats-bugs@gnats.netbsd.org>
From: Ignatios Souvatzis <is@beverly.rhein.de>
List: netbsd-bugs
Date: 10/13/1997 22:41:31
>Number:         4268
>Category:       kern
>Synopsis:       Audio(9) description different from prototypes
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kern-bug-people (Kernel Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Oct 13 13:50:05 1997
>Last-Modified:
>Originator:     Ignatios Souvatzis
>Organization:
	
>Release:        $NetBSD: audio.9,v 1.3 1997/10/11 15:33:26 augustss Exp $
>Environment:
	
System: NetBSD jocelyn.rhein.de 1.2G NetBSD 1.2G (GENERIC) #231: Tue Oct 7 22:21:25 MEST 1997 is@jocelyn.rhein.de:/build/obj/kernel/GENERIC amiga


>Description:
	The description to the get_in_port() and get_out_port() methods
refers to filling in the port parameter. However, in the prototypes as well
as existing code in other (than the one I'm writing) prototypes there is
no such parameter.

	The description also mentions returning 0 or an error code. However,
existing drivers return the port number instead.
>How-To-Repeat:
	Try to write a audio backend driver.
>Fix:
	Fix description. Or fix audio.9, all existing driver, and 
/dev/ic/audio.c and /dev/ic/audio_if.h, if the documented behaviour was
intended.
>Audit-Trail:
>Unformatted: