>Number:         9770
>Category:       kern
>Synopsis:       wscons(9) is missing
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Apr 04 04:54:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Paul Kranenburg
>Release:        NetBSD 1.4X<NetBSD-current source date>
>Organization:
	
>Environment:
	sparc NetBSD/1.4X


>Description:
	While wscons(4) et.al. paints the overall position of the wscons
	subsystem within the kernel, it does not nearly contain enough
	information to actually write code to use its functionality.

	There should be a wscons(9) document describing the kernel API
	provided by this subsystem, containing at least:

		- the external functions provided to clients

		- a description of the data structures exposed and the
		  header files that expose them

		- which part of those data structures are mandatory,
		  which are optional, and which are private.

		- cross-reference on other subsystems that currently
		  depend on (part of) this implementation
		  (e.g. rasops, see also PR#9754).

	
>How-To-Repeat:
	Try to write an interface to wscons from scratch.
	
>Fix:
	
>Release-Note:
>Audit-Trail:
>Unformatted: