From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: tyler Newsgroups: gmane.emacs.help Subject: Re: emacs manual Date: Wed, 08 Apr 2009 11:37:18 -0300 Message-ID: <87myar9ppd.fsf@blackbart.sedgenet> References: <87tz4zmfn6.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1239201778 30883 80.91.229.12 (8 Apr 2009 14:42:58 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 8 Apr 2009 14:42:58 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Wed Apr 08 16:44:17 2009 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LrZ0J-00042D-IN for geh-help-gnu-emacs@m.gmane.org; Wed, 08 Apr 2009 16:43:51 +0200 Original-Received: from localhost ([127.0.0.1]:38748 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LrYyv-00043Z-CP for geh-help-gnu-emacs@m.gmane.org; Wed, 08 Apr 2009 10:42:25 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LrYuJ-0008AR-Rf for help-gnu-emacs@gnu.org; Wed, 08 Apr 2009 10:37:39 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LrYuE-00085H-HA for help-gnu-emacs@gnu.org; Wed, 08 Apr 2009 10:37:39 -0400 Original-Received: from [199.232.76.173] (port=53573 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LrYuE-000855-BD for help-gnu-emacs@gnu.org; Wed, 08 Apr 2009 10:37:34 -0400 Original-Received: from main.gmane.org ([80.91.229.2]:56886 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LrYuD-0007Z6-TY for help-gnu-emacs@gnu.org; Wed, 08 Apr 2009 10:37:34 -0400 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1LrYuA-0002BS-92 for help-gnu-emacs@gnu.org; Wed, 08 Apr 2009 14:37:30 +0000 Original-Received: from hlfxns0169w-142177060048.pppoe-dynamic.ns.aliant.net ([142.177.60.48]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Apr 2009 14:37:30 +0000 Original-Received: from tyler.smith by hlfxns0169w-142177060048.pppoe-dynamic.ns.aliant.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 08 Apr 2009 14:37:30 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 46 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: hlfxns0169w-142177060048.pppoe-dynamic.ns.aliant.net User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) Cancel-Lock: sha1:6N+EzO9WY6YlMK7X2YRPRWms+kM= X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) 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:63561 Archived-At: Sean Sieger writes: > I was just navigating my way back to a point in the Emacs Manual, the > section, `22 File Handling'. I did `t', `m' and then typed > > file h > > ``[No Match]'' was the message that I got. > > From the top level of the manual, ``Files'' is the name of the section. > I remembered the last chapter name or section name I'd come across > (again, `22 File Handling') as I do when I close a book and put it down. > > Isn't this a disjunction? > > My post may be interpreted as a complaint, but this looked like an > example of the opacity that I sometimes perceive in the documentation of > Emacs but don't know how to verbalize. > > Just looking for an explanation. > In Texinfo, the commands for naming a chapter are different from the commands used to define a node. So in your case, the chapter is defined as `File Handling', which applies that title to the top of the page, but the node is defined as `Files', which is what gets inserted into the menu, and is what you need to target when you use `m' to pick the page. At least, that's how I understand it. I don't know why this should be, because it seems like it would be more intuitive if the chapter and node names were the same, as you've pointed out. If no-one else has a better explanation, I'd be tempted to submit this as a documentation bug. It's not really a bug though, as much as an inconsistency in the way documents are laid out. I notice that the texinfo manual itself contains similar problems, with the node `Ending a File' having the chapter title `Ending a Texinfo File'. Cheers, Tyler -- I have no "intellectual property," and I think that all claimants to such property are thieves. --Wendell Berry http://home.btconnect.com/tipiglen/resist.html