From owner-svn-src-all@FreeBSD.ORG Fri May 22 11:46:51 2009 Return-Path: Delivered-To: svn-src-all@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E3363106568F; Fri, 22 May 2009 11:46:51 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from mail09.syd.optusnet.com.au (mail09.syd.optusnet.com.au [211.29.132.190]) by mx1.freebsd.org (Postfix) with ESMTP id 7376D8FC12; Fri, 22 May 2009 11:46:51 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from besplex.bde.org (c122-107-117-19.carlnfd1.nsw.optusnet.com.au [122.107.117.19]) by mail09.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id n4MBki1A022881 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 22 May 2009 21:46:45 +1000 Date: Fri, 22 May 2009 21:46:43 +1000 (EST) From: Bruce Evans X-X-Sender: bde@besplex.bde.org To: Robert Watson In-Reply-To: Message-ID: <20090522205615.G2353@besplex.bde.org> References: <20090521132404.cc5be268.stas@FreeBSD.org> <20090521110115.GA50355@FreeBSD.org> <20090521.085256.-1989816394.imp@bsdimp.com> <20090522195717.U22330@delplex.bde.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Mailman-Approved-At: Fri, 22 May 2009 11:57:40 +0000 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 , svn-src-head@FreeBSD.org, "M. Warner Losh" Subject: Re: svn commit: r192398 - in head/usr.bin: . perror X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 22 May 2009 11:46:52 -0000 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