svn commit: r192398 - in head/usr.bin: . perror

[Bruce Evans]

On Fri, 22 May 2009, Robert Watson wrote:

> On Fri, 22 May 2009, Bruce Evans wrote:

>> What about with "man errno".  Man pages are slightly more likely to be 
> ...
> ...  On the topic of man pages though -- I was interested 
> to see that Mac OS X does not ship with an errno(2), despite shipping with a 
> BSD-derived errno.h.

Under FreeBSD, errno.2 is only a link to intro.2.  This link was there in
libc/sys/Makefile.inc rev.1.1.  More than half of intro.2 is about error
numbers.

I expected to find error numbers described in strerror.3 or perror.3.
perror.3 is only a link to sterror.3 (so is sys_errlist.3, which is
probably the right place for documenting the list).  strerror.3 refers
to intro.2 but not errno.2.  errno.2 is referred to mainly in au_token(3)
and its 46 links.

apropos(1) does an especially poor job for errno since it gets spammed
more than usual by links, and errno isn't a function.  It doesn't find
errno(2), intro(2) or strerror(2), but it finds au_bsm_to_errno(3) and
many other functions with errno in their name, and then gets spammed
by links to these; it finds pcap_strerror(3) due to errno in its
description, and it finds perl's Errno(3).

Bruce