Subject: lib/11171: the `roken' library is entirely undocumented
To: None <>
From: Paul Kranenburg <>
List: netbsd-bugs
Date: 10/08/2000 15:03:29
>Number:         11171
>Category:       lib
>Synopsis:       the `roken' library is entirely undocumented
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    lib-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun Oct 08 15:03:01 PDT 2000
>Originator:     Paul Kranenburg
>Release:        NetBSD-current & NetBSD 1.5ALPHA
System: NetBSD sam 1.5E NetBSD 1.5E (SAM) #74: Sun Sep 10 00:35:00 MEST 2000 pk@sam:/usr/src/sys/arch/sparc/compile/SAM sparc

	The `roken' library neither supplies a set of manual pages nor
	any other form of documentation that justifies its existence as part
	of the base installation. Note that not even its name provides
	the slightest cue on what it might contain..

	Inspection of the source directory learns that it provides lots of
	functions for which perfectly good alternatives exist in our
	existing C and utilities base libraries. One function - signal() -
	might even upset applications that are unaware of the gratuitous
	argument munging that is done by the `roken' version.
	Think long and hard about the reasons for libroken's existence
	in a NetBSD system. If, in the end, it is deemed indispensible,
	provide adequate documentation on its functionality.