From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.bugs,gmane.comp.tex.texinfo.bugs Subject: bug#2975: `texinfo-master-menu' doesn't work. Date: Sun, 12 Apr 2009 21:33:40 +0000 Message-ID: <20090412213340.GA3615@muc.de> Reply-To: Alan Mackenzie , 2975@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1239572654 32652 80.91.229.12 (12 Apr 2009 21:44:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 12 Apr 2009 21:44:14 +0000 (UTC) To: bug-texinfo@gnu.org, bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 12 23:45:32 2009 Return-path: Envelope-to: geb-bug-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 1Lt7UY-0007t1-Qb for geb-bug-gnu-emacs@m.gmane.org; Sun, 12 Apr 2009 23:45:31 +0200 Original-Received: from localhost ([127.0.0.1]:56425 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Lt7TA-0008S1-2t for geb-bug-gnu-emacs@m.gmane.org; Sun, 12 Apr 2009 17:44:04 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Lt7T5-0008Pd-0F for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:43:59 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Lt7T0-0008GF-8y for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:43:58 -0400 Original-Received: from [199.232.76.173] (port=45625 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Lt7Sz-0008GC-Vk for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:43:54 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:57565) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Lt7Sz-0003B5-FW for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:43:53 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3CLhoYv024323; Sun, 12 Apr 2009 14:43:51 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n3CLe7oo023240; Sun, 12 Apr 2009 14:40:07 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Alan Mackenzie Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 12 Apr 2009 21:40:06 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 2975 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.123957205121494 (code B ref -1); Sun, 12 Apr 2009 21:40:06 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 12 Apr 2009 21:34:11 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3CLY7SJ021476 for ; Sun, 12 Apr 2009 14:34:08 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Lt7JW-0005pp-UC for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:34:06 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Lt7JR-0005nZ-34 for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:34:06 -0400 Original-Received: from [199.232.76.173] (port=35063 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Lt7JQ-0005nR-GI for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:34:00 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:2082 helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Lt7JP-0001yS-S1 for bug-gnu-emacs@gnu.org; Sun, 12 Apr 2009 17:34:00 -0400 Original-Received: (qmail 43219 invoked by uid 3782); 12 Apr 2009 21:33:54 -0000 Original-Received: from acm.muc.de (pD9E51B39.dip.t-dialin.net [217.229.27.57]) by colin2.muc.de (tmda-ofmipd) with ESMTP; Sun, 12 Apr 2009 23:33:52 +0200 Original-Received: (qmail 4723 invoked by uid 1000); 12 Apr 2009 21:33:40 -0000 Content-Disposition: inline User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) X-Primary-Address: acm@muc.de X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sun, 12 Apr 2009 17:43:58 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:27115 gmane.comp.tex.texinfo.bugs:4712 Archived-At: In Emacs, either 22.3 or a recent CVS version ... emacs -Q 1. (i) C-c C-f .../path/to/emacs/doc/misc/cc-mode.texi (ii) M-g M-g 238 ; the second line of the menu, ; contents "* Overview::" (ii) C-k C-k ; Kill this line (v) Now do C-c C-u m. This flashes the screen and reports "Done...completed making master menu. You may save the buffer.". However, it hasn't made the master menu - the "* Overview::" line is still missing. ######################################################################## 2. (i) Kill (remove) the entire master menu from the buffer (between the lines "@menu" and "@end menu"). (ii) Try to regenerate the master menu with C-c C-u m. This signals the puzzling error "Buffer lacks ordinary `Top' menu in which to insert master". It is not clear what a "`Top' menu" is, in what respect it is "ordinary", and in what regard the new master menu is inserted into it. The existing master menu was not contained within any menu. ######################################################################### 3. (i) C-c C-f .../path/to/emacs/doc/lispref/elisp.texi (ii) M-g M-g 108 ; the second line of the menu, ; "* Lisp Data Types:: ...." (iii) C-k C-k ; Kill this line (iv) Now do C-c C-u m. This doesn't regenerate the master menu. Instead, it deletes the @detailmenu without restoring the "* Lisp Data Types::" line. ######################################################################### Comments: Neither the doc string for `texinfo-master-menu' nor the texinfo manual (page "Updating Nodes and Menus") describe other than vaguely what this command is supposed to do. The doc string states, accurately, that The function removes the detailed part of an already existing master menu. , which though accurate, is puzzling in the extreme; what one wants from this command is for the detailed bit to be inserted, not deleted. There is no verb in "texinfo master menu", so one is led by intelligent guessing to believe that the command does whatever necessary to insert or update the master menu. This doesn't happen. -- Alan Mackenzie (Nuremberg, Germany).