Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 22 May 2009 21:46:43 +1000 (EST)
From:      Bruce Evans <brde@optusnet.com.au>
To:        Robert Watson <rwatson@FreeBSD.org>
Cc:        unixmania@gmail.com, danfe@FreeBSD.org, src-committers@FreeBSD.org, peterjeremy@optushome.com.au, svn-src-all@FreeBSD.org, stas@FreeBSD.org, gnn@FreeBSD.org, Bruce Evans <brde@optusnet.com.au>, svn-src-head@FreeBSD.org, "M. Warner Losh" <imp@bsdimp.com>
Subject:   Re: svn commit: r192398 - in head/usr.bin: . perror
Message-ID:  <20090522205615.G2353@besplex.bde.org>
In-Reply-To: <alpine.BSF.2.00.0905221139020.17322@fledge.watson.org>
References:  <e71790db0905201558u1c8e3e90n1fbbfc4011e22909@mail.gmail.com> <20090521132404.cc5be268.stas@FreeBSD.org> <20090521110115.GA50355@FreeBSD.org> <20090521.085256.-1989816394.imp@bsdimp.com> <20090522195717.U22330@delplex.bde.org> <alpine.BSF.2.00.0905221139020.17322@fledge.watson.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090522205615.G2353>