lin-club  

[Haifux] Re: Funny man pages [was Re: user-level threads: Signal Handler (fwd)]

Nadav Har'El
Tue, 16 Apr 2002 02:54:57 -0700

On Tue, Apr 16, 2002, Shlomi Fish wrote about "Funny man pages [was Re: user-level 
threads: Signal Handler (fwd)]":
> 
> >From the Linux getopt(3) manpage: "BUGS:
> This manpage is confusing."

I just noticed that the getopt(3) manpage on Redhat 7.2 no longer has that
line. I double-checked, and in Redhat 6.2 this line did exist. The strange
thing is that on both systems the manual is dated 8 May 1998, so apparently
someone went and deleted only that self-incriminating line :)

> Another favourite of mine is the strtok(3) man page:
> 
> BUGS: Never use these functions.

Some systems (I remember in Solaris, but also in NetBSD - maybe this came
from 4.2BSD) had the following in the BUGS section of tunefs(8):

        You can tune a file system, but you can't tune a fish.

(if you don't understand the pun, try reading it out loud with an American
accent).


-- 
Nadav Har'El                        |       Tuesday, Apr 16 2002, 4 Iyyar 5762
[EMAIL PROTECTED]             |-----------------------------------------
Phone: +972-53-245868, ICQ 13349191 |Recursive, adj.: See Recursive
http://nadav.harel.org.il           |

--------------------------------------------------------------------------
Haifa Linux Club Mailing List (http://linuxclub.il.eu.org)
To unsub send an empty message to [EMAIL PROTECTED]