From owner-svn-src-head@FreeBSD.ORG Fri May 22 10:30:22 2009 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8B06E1065670; Fri, 22 May 2009 10:30:22 +0000 (UTC) (envelope-from des@des.no) Received: from tim.des.no (tim.des.no [194.63.250.121]) by mx1.freebsd.org (Postfix) with ESMTP id 46B818FC13; Fri, 22 May 2009 10:30:21 +0000 (UTC) (envelope-from des@des.no) Received: from ds4.des.no (cm-84.215.252.34.getinternet.no [84.215.252.34]) by smtp.des.no (Postfix) with ESMTP id 2D8066D41C; Fri, 22 May 2009 12:30:21 +0200 (CEST) Received: by ds4.des.no (Postfix, from userid 1001) id 2484C844B5; Fri, 22 May 2009 12:30:21 +0200 (CEST) From: =?utf-8?Q?Dag-Erling_Sm=C3=B8rgrav?= To: Peter Jeremy References: <200905191740.n4JHeMMU005087@svn.freebsd.org> <20090520200138.GA33344@server.vk2pj.dyndns.org> Date: Fri, 22 May 2009 12:30:21 +0200 In-Reply-To: <20090520200138.GA33344@server.vk2pj.dyndns.org> (Peter Jeremy's message of "Thu, 21 May 2009 06:01:38 +1000") Message-ID: <86vdntzayq.fsf@ds4.des.no> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.92 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Cc: svn-src-head@freebsd.org, "George V. Neville-Neil" , svn-src-all@freebsd.org, src-committers@freebsd.org Subject: Re: svn commit: r192398 - in head/usr.bin: . perror X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 22 May 2009 10:30:23 -0000 Peter Jeremy writes: > Given how easy it is to "grep <> /usr/include/sys/errno.h" or > perl -e '$! =3D <>; print "$!\n";' > I'm not sure of the utility of this tool. One downside is that > man perror > will now return perror(1) instead of perror(3) This is already the case for many system calls and library functions: basename(3) bind(2) calendar(3) chdir(2) chflags(2) chmod(2) clear(3) cpuset(2) crypt(3) dialog(3) dirname(3) echo(3) end(3) exec(3) exit(3) fetch(3) fstat(2) fsync(2) getopt(3) glob(3) hash(3) hexdump(3) history(3) intro(2) intro(3) kenv(2) kill(2) ktrace(2) link(2) lockf(3) log(3) login(3) logout(3) md5(3) mkdir(2) mkfifo(2) mktemp(3) nice(3) nl(3) printf(3) read(2) readlink(2) realpath(3) rmdir(2) rtprio(2) setenv(3) setfib(2) sha256(3) sleep(3) stat(2) time(3) times(3) trace(3) truncate(2) ulimit(3) umask(2) uname(3) unlink(2) unsetenv(3) unvis(3) uuidgen(2) vis(3) wait(2) write(2) It is easily solved by setting MANSECT in your environment and / or configuring your editor to search sections 2 and 3 before section 1: (defvar des-man-sections nil "Colon-separated list of manual sections to search") (defun des-context-help () "Bring up the man page for the word closest to the current point" (interactive) (if des-man-sections (man (format "-S%s %s" des-man-sections (current-word))) (man (current-word)))) (defun des-man-page-hook () (make-local-variable 'des-man-sections) (setq des-man-sections "3:2:9:4:5:1:8:7:6") (local-set-key [f1] 'des-context-help)) (add-hook 'c-mode-common-hook 'des-man-page-hook) DES --=20 Dag-Erling Sm=C3=B8rgrav - des@des.no