From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Robert Thorpe" Newsgroups: gmane.emacs.help Subject: Re: Why I can't use `info' in emacs? Date: 18 Dec 2006 03:51:43 -0800 Organization: http://groups.google.com Message-ID: <1166442703.874915.240160@t46g2000cwa.googlegroups.com> References: <458268D7.6020203@163.com> <1166191335.058714.266970@80g2000cwy.googlegroups.com> <1166194633.486698.321520@n67g2000cwd.googlegroups.com> <87tzzurrm3.fsf@kobe.laptop> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" X-Trace: sea.gmane.org 1166471152 8218 80.91.229.2 (18 Dec 2006 19:45:52 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 18 Dec 2006 19:45:52 +0000 (UTC) Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Mon Dec 18 20:45:51 2006 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1GwHnM-0008Rh-GD for geh-help-gnu-emacs@m.gmane.org; Mon, 18 Dec 2006 13:40:40 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GwHnL-00028H-LH for geh-help-gnu-emacs@m.gmane.org; Mon, 18 Dec 2006 07:40:39 -0500 Original-Path: shelby.stanford.edu!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!postnews.google.com!t46g2000cwa.googlegroups.com!not-for-mail Original-Newsgroups: gnu.emacs.help Original-Lines: 48 Original-NNTP-Posting-Host: 163.244.62.65 Original-X-Trace: posting.google.com 1166442710 13659 127.0.0.1 (18 Dec 2006 11:51:50 GMT) Original-X-Complaints-To: groups-abuse@google.com Original-NNTP-Posting-Date: Mon, 18 Dec 2006 11:51:50 +0000 (UTC) In-Reply-To: <87tzzurrm3.fsf@kobe.laptop> User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7.10) Gecko/20050716 Firefox/1.0.6,gzip(gfe),gzip(gfe) X-HTTP-Via: 1.0 EMF1ASPROXY03 Complaints-To: groups-abuse@google.com Injection-Info: t46g2000cwa.googlegroups.com; posting-host=163.244.62.65; posting-account=hWoAPxMAAAAnBKSBz1ZivwUPPjEuve7bvVCHZQ8rhrluPfwcBJd92w Original-Xref: shelby.stanford.edu gnu.emacs.help:144082 Original-To: help-gnu-emacs@gnu.org X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:39702 Archived-At: Giorgos Keramidas wrote: > On 15 Dec 2006 06:57:13 -0800, > "Robert Thorpe" wrote: > >Hadron Quark wrote: > >>"Robert Thorpe" writes: > >>> It's not documented by Emacs, it's documented in the Info docs that > >>> come with GLibc. > >> > >> I installed the glibc info package on my ubuntu system. restarted > >> emacs. Here are some outputs from the info pages for glibc and the man > >> pages for printf: > >> > >> (a) man page using manual-entry(current-word): > >> > >> ,---- > >> | PRINTF(3) Linux Programmer's Manual > >> > >> Surely the man pages are superior in this instance for a programmer? > > > > It depends. [...] > > The man-page is quite thorough in this case, but it is a little > > confusing in one respect, It says "Linux Programmer's Manual". I > > have no idea why it says this, since printf is provided by Glibc. > > That's because man pages are organized in sections. The section title > for manpages in section 3 is "Linux Programmer's Manual" on Linux. On > other systems, section 3 may have a slightly different title. Here, for > instance, on a FreeBSD system, the title is: > > PRINTF(3) FreeBSD Library Functions Manual PRINTF(3) I don't agree. Individual man pages should have titles, not just sections of the manual. In the old days when Unix all came from AT&T it made sense if the man page simply announced the purpose of the section, eg "Unix Library Function Manual". This was, I believe the title of section 3 of the Unix manual. These days in free *nixes have bits coming from all over the place. Now it makes sense if the title of the man page reflects the origin of the command. In section 3 of the manual I have Perl docs, libc docs and linux docs. There's probably some other stuff in there I haven't mentioned. The FreeBSD entry is entirely correct, since FreeBSD's libc is maintained with FreeBSD.