Subject: lib/11171: the `roken' library is entirely undocumented
To: None <firstname.lastname@example.org>
From: Paul Kranenburg <email@example.com>
Date: 10/08/2000 15:03:29
>Synopsis: the `roken' library is entirely undocumented
>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.