From unknown Mon Aug 18 09:04:44 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#2975: `texinfo-master-menu' doesn't work. Reply-To: Alan Mackenzie , 2975@debbugs.gnu.org Resent-From: Alan Mackenzie Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 12 Apr 2009 21:40:06 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 2975 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.123957205121494 (code B ref -1); Sun, 12 Apr 2009 21:40:06 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 12 Apr 2009 21:34:11 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=none autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 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 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 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 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 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 Received: (qmail 43219 invoked by uid 3782); 12 Apr 2009 21:33:54 -0000 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 Received: (qmail 4723 invoked by uid 1000); 12 Apr 2009 21:33:40 -0000 Date: Sun, 12 Apr 2009 21:33:40 +0000 To: bug-texinfo@gnu.org, bug-gnu-emacs@gnu.org Message-ID: <20090412213340.GA3615@muc.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 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). From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Dec 2011 20:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Roland Winkler" Cc: 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132329068021237 (code B ref 2975); Wed, 07 Dec 2011 20:45:01 +0000 Received: (at 2975) by debbugs.gnu.org; 7 Dec 2011 20:44:40 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYOM3-0005WT-C6 for submit@debbugs.gnu.org; Wed, 07 Dec 2011 15:44:40 -0500 Received: from pruche.dit.umontreal.ca ([132.204.246.22]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYOM1-0005WM-5y for 2975@debbugs.gnu.org; Wed, 07 Dec 2011 15:44:38 -0500 Received: from faina.iro.umontreal.ca (lechon.iro.umontreal.ca [132.204.27.242]) by pruche.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id pB7Khovh031107; Wed, 7 Dec 2011 15:43:51 -0500 Received: by faina.iro.umontreal.ca (Postfix, from userid 20848) id BB620B42C1; Wed, 7 Dec 2011 15:43:50 -0500 (EST) From: Stefan Monnier Message-ID: References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> Date: Wed, 07 Dec 2011 15:43:50 -0500 In-Reply-To: <20191.48632.665251.448872@gargle.gargle.HOWL> (Roland Winkler's message of "Wed, 7 Dec 2011 13:26:48 -0600") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV4064=0 X-NAI-Spam-Version: 2.2.0.9309 : core <4064> : streams <708656> : uri <1023584> X-Spam-Score: -4.6 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.6 (----) > Thanks...Now I am yet more confused. I thought I look into > emacs.texi because I assumed that this info manual has been updated > continuously in recent years and this updating has been done with > the editor of my choice which is emacs. So what have people done who > contributed to the emacs info manual to work around these > difficulties? Which parts of emacs' texinfo support do what they are > supposed to do and which parts seem to be malfunctioning? I'm pretty sure texinfo-master-menu is not used for that, indeed. I think "update all menus" is the more common helper command. IIRC it also suffered from problems where it adds data to "Node"s which should better not be added at all, so makeinfo can auto-fill it for you (and makeinfo actually complains about what texinfo-master-menu puts there). Maybe the better course here is to deprecate it, seeing how noone seems interested in fixing it (if it can be fixed). Stefan From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "Roland Winkler" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Dec 2011 21:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Monnier Cc: 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132329285524511 (code B ref 2975); Wed, 07 Dec 2011 21:21:02 +0000 Received: (at 2975) by debbugs.gnu.org; 7 Dec 2011 21:20:55 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYOv5-0006NE-Ee for submit@debbugs.gnu.org; Wed, 07 Dec 2011 16:20:55 -0500 Received: from essmail.ess.niu.edu ([131.156.1.18]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYOv3-0006N7-JH for 2975@debbugs.gnu.org; Wed, 07 Dec 2011 16:20:50 -0500 Received: from regnitz (lukas.physics.niu.edu [131.156.85.221]) by essmail.ess.niu.edu (8.14.3/8.14.3) with ESMTP id pB7LK1bh017022; Wed, 7 Dec 2011 15:20:02 -0600 (CST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <20191.55423.572257.75919@gargle.gargle.HOWL> Date: Wed, 7 Dec 2011 15:19:59 -0600 From: "Roland Winkler" In-Reply-To: References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> X-Mailer: VM 8.2 trial under 24.0.90.2 (x86_64-unknown-linux-gnu) X-Spam-Score: -3.6 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.5 (---) On Wed Dec 7 2011 Stefan Monnier wrote: > I'm pretty sure texinfo-master-menu is not used for that, indeed. > I think "update all menus" is the more common helper command. > > IIRC it also suffered from problems where it adds data to "Node"s which > should better not be added at all, so makeinfo can auto-fill it for you > (and makeinfo actually complains about what texinfo-master-menu puts > there). I am not sure I understand what you say about nodes. I started this thread because > The texinfo manual says about "Updating Nodes and Menus" > > If you do not use the updating commands, you need to write menus > and node pointers by hand, which is a tedious task. Is there any emacs command that can help reliably for updating the nodes? (Nodes appear to get screwed up by texinfo-master-menu.) Of course, I believe that makeinfo can add the info about the node pointers. But what about output formats not supported by makeinfo? I believe that something like TeX needs them. > Maybe the better course here is to deprecate it, seeing how noone seems > interested in fixing it (if it can be fixed). This would certainly help at least somewhat to clarify the situation. Roland From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 06:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Roland Winkler" Cc: monnier@IRO.UMontreal.CA, 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132332511416271 (code B ref 2975); Thu, 08 Dec 2011 06:19:01 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 06:18:34 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYXJQ-0004EN-Va for submit@debbugs.gnu.org; Thu, 08 Dec 2011 01:18:33 -0500 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYXJM-0004EB-9Y for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 01:18:29 -0500 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RYXIa-0008WU-1F; Thu, 08 Dec 2011 01:17:40 -0500 Date: Thu, 08 Dec 2011 01:17:40 -0500 Message-Id: From: Eli Zaretskii In-reply-to: <20191.55423.572257.75919@gargle.gargle.HOWL> (winkler@gnu.org) References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> X-Spam-Score: -6.6 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.6 (------) > Date: Wed, 7 Dec 2011 15:19:59 -0600 > From: "Roland Winkler" > Cc: 2975@debbugs.gnu.org > > On Wed Dec 7 2011 Stefan Monnier wrote: > > I'm pretty sure texinfo-master-menu is not used for that, indeed. > > I think "update all menus" is the more common helper command. > > > > IIRC it also suffered from problems where it adds data to "Node"s which > > should better not be added at all, so makeinfo can auto-fill it for you > > (and makeinfo actually complains about what texinfo-master-menu puts > > there). > > I am not sure I understand what you say about nodes. What Stefan says is that the form of @node produced by texinfo-master-menu (when it is invoked on a region and/or with a prefix argument) includes the Next, Prev, and Up pointers, even if the original file didn't have those pointers. Worse, due to incomplete support of the more advanced Texinfo features, the produced pointers can cause makeinfo barf. IOW, the command could potentially take a perfectly valid Texinfo file and produce an invalid one. The node pointers thingy is particularly baaad because makeinfo doesn't actually need these pointers, if your Texinfo files are structured using a few simple rules, documented in the Texinfo manual, see "texinfo(makeinfo Pointer Creation)". If you keep your Texinfo structured according to these rules, there's no need for Next, Prev, and Up pointers on the @node lines; makeinfo will compute them automatically. By forcibly inserting these pointers, texinfo-master-menu prevents you from using this very convenient feature: you are forced to maintain these pointers whenever you insert or delete nodes. > I started this thread because > > > The texinfo manual says about "Updating Nodes and Menus" > > > > If you do not use the updating commands, you need to write menus > > and node pointers by hand, which is a tedious task. > > Is there any emacs command that can help reliably for updating the nodes? > (Nodes appear to get screwed up by texinfo-master-menu.) Well, see above: you don't need to be bothered by that, if you adhere to the rules explained in the Texinfo manual. > Of course, I believe that makeinfo can add the info about the node > pointers. But what about output formats not supported by makeinfo? > I believe that something like TeX needs them. TeX doesn't need them. These pointers are there to allow traversing the on-line manual, and are not needed for non on-line versions. > > Maybe the better course here is to deprecate it, seeing how noone seems > > interested in fixing it (if it can be fixed). Define "fixed". Which of the current misfeatures are urgent to fix? > This would certainly help at least somewhat to clarify the > situation. See my other mail (which I didn't write yet ;-) about "the situation". From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 10:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: Roland Winkler , 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13233407366471 (code B ref 2975); Thu, 08 Dec 2011 10:39:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 10:38:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYbNQ-0001gK-KS for submit@debbugs.gnu.org; Thu, 08 Dec 2011 05:38:56 -0500 Received: from mail-ww0-f46.google.com ([74.125.82.46]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYbNO-0001gC-FZ for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 05:38:55 -0500 Received: by wgbdq10 with SMTP id dq10so3283950wgb.15 for <2975@debbugs.gnu.org>; Thu, 08 Dec 2011 02:38:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:content-transfer-encoding; bh=9nIfHof8iLu1asn4YQJRZc90Y9yLgxm2AQou6B+CRD0=; b=U2tyIuHKDZFQiMSJ4d1QT6ABkzpOzQMyS781zASGQZTR4nIpzeGhqslFTUqIyQ4BzW /VbVmj1XQvm3FUO+A/IrxC1DOE7SDDF/M6VbBmEh5WJfFARVOquEuyU8Obv0SiasaGvg 43D1ZysL+LxbA6lqMAN1rkxvOVaubgvUVdZcI= Received: by 10.227.209.66 with SMTP id gf2mr2703368wbb.20.1323340685177; Thu, 08 Dec 2011 02:38:05 -0800 (PST) Received: from localhost (176.119.broadband10.iol.cz. [90.177.119.176]) by mx.google.com with ESMTPS id er5sm3424057wbb.11.2011.12.08.02.38.03 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 08 Dec 2011 02:38:03 -0800 (PST) From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= In-Reply-To: (Eli Zaretskii's message of "Thu, 08 Dec 2011 01:17:40 -0500") References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) Date: Thu, 08 Dec 2011 11:38:01 +0100 Message-ID: <877h27gxh2.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -3.8 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.8 (---) On Thu, 08 Dec 2011 07:17:40 +0100 Eli Zaretskii wrote: >> > Maybe the better course here is to deprecate it, seeing how noone seems >> > interested in fixing it (if it can be fixed). > > Define "fixed". Which of the current misfeatures are urgent to fix? I'd say the fact that OT1H `texinfo-master-menu' is recommended as "the primary command" in the Texinfo manual (info "(texinfo)Updating Commands"), and OTOH it (sometimes?) breaks things, is a rather urgent-to-be-fixed misfeature. I've had this problem in the past, too, and had no idea what's going on until this came up now. I think it's very important that there is a clear recipe for maintaining Texinfo documentation which people not interested in the details or implementation of Texinfo (=3D=3D the vast majority of Texinfo writers) can easily find and go by. --=20 =C5=A0t=C4=9Bp=C3=A1n From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 12:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Cc: Karl Berry , winkler@gnu.org, 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132334689515702 (code B ref 2975); Thu, 08 Dec 2011 12:22:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 12:21:35 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYcyj-00045B-Nc for submit@debbugs.gnu.org; Thu, 08 Dec 2011 07:21:34 -0500 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYcyf-000452-3L for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 07:21:31 -0500 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RYcxr-0002GW-6k; Thu, 08 Dec 2011 07:20:39 -0500 Date: Thu, 08 Dec 2011 07:20:39 -0500 Message-Id: From: Eli Zaretskii In-reply-to: <877h27gxh2.fsf@gmail.com> (message from =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= on Thu, 08 Dec 2011 11:38:01 +0100) References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -6.6 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.6 (------) > From: Štěpán Němec > Cc: "Roland Winkler" , 2975@debbugs.gnu.org > Date: Thu, 08 Dec 2011 11:38:01 +0100 > > On Thu, 08 Dec 2011 07:17:40 +0100 > Eli Zaretskii wrote: > > >> > Maybe the better course here is to deprecate it, seeing how noone seems > >> > interested in fixing it (if it can be fixed). > > > > Define "fixed". Which of the current misfeatures are urgent to fix? > > I'd say the fact that OT1H `texinfo-master-menu' is recommended as "the > primary command" in the Texinfo manual (info "(texinfo)Updating Commands"), > and OTOH it (sometimes?) breaks things, is a rather urgent-to-be-fixed > misfeature. The simplest fix would be to remove the updating of the @node lines. Would anyone object? Karl? > I think it's very important that there is a clear recipe for maintaining > Texinfo documentation which people not interested in the details or > implementation of Texinfo (== the vast majority of Texinfo writers) can > easily find and go by. That is a separate and non-trivial project. Texinfo Mode has a lot of commands, some of which cater to specific workflows and organizations of manuals. Making a coherent set of instructions for people who are "not interested in the details" is not an easy task. It certainly doesn't affect only Emacs. However, since this discussion _is_ in the context of Emacs, let me say this: FWIW, most changes I do in the Emacs docs do not justify using any of the commands discussed in this bug report and in the parallel thread on emacs-devel. I just make the changes by hand. I believe others do that as well. There are rare situations when I use the commands discussed here, typically close to a release when there's a need to make sure every menu is up to date. E.g., I didn't even remember the existence of texinfo-multiple-files-update until I bumped into a comment in emacs.texi, although I myself added that comment several years ago. I guess I'm saying that the importance of these commands in the context of maintaining Emacs documentation is somewhat exaggerated in this thread, to say the least ;-) From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 14:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: Karl Berry , =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= , 2975@debbugs.gnu.org, winkler@gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132335566531320 (code B ref 2975); Thu, 08 Dec 2011 14:48:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 14:47:45 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYfGC-000896-Gq for submit@debbugs.gnu.org; Thu, 08 Dec 2011 09:47:45 -0500 Received: from pruche.dit.umontreal.ca ([132.204.246.22]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYfG9-00088x-Q2 for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 09:47:43 -0500 Received: from pastel.home (lechon.iro.umontreal.ca [132.204.27.242]) by pruche.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id pB8Ekoki025312; Thu, 8 Dec 2011 09:46:50 -0500 Received: by pastel.home (Postfix, from userid 20848) id DFCED59403; Thu, 8 Dec 2011 09:46:49 -0500 (EST) From: Stefan Monnier Message-ID: References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> Date: Thu, 08 Dec 2011 09:46:49 -0500 In-Reply-To: (Eli Zaretskii's message of "Thu, 08 Dec 2011 07:20:39 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV4065=0 X-NAI-Spam-Version: 2.2.0.9309 : core <4065> : streams <708856> : uri <1024056> X-Spam-Score: -4.6 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.6 (----) Karl writes: > Perhaps the description of texinfo-mode would be better off in the Emacs > manual, instead of the Texinfo manual. (Since it is not maintained as > part of Texinfo.) I'd be fine with that. Whatever you want to do. Sounds like a good idea, yes. Eli writes: > The simplest fix would be to remove the updating of the @node lines. > Would anyone object? Karl? That would be great. Eli writes: > I guess I'm saying that the importance of these commands in the > context of maintaining Emacs documentation is somewhat exaggerated in > this thread, to say the least ;-) IIUC the OP is not directly interested in maintaining Emacs documentation but rather is trying to write a manual for another project (BBDB, which happens to be an Emacs package). Eli writes: > Here's what I see there: > . texinfo-master-menu indeed does not support multiple-file manuals, > so it removed all the menu items whose nodes are in files other > than emacs.texi itself A good fix here would be for texinfo-master-menu to detect the problem and signal a warning/error. > . texinfo-master-menu doesn't grok @iftex and @ifnottext conditionals > (and probably the other @if... conditionals as well), so it > produced bad Next and Prev pointers, because, e.g., this: If leaving Node pointers alone fixes this problem, then there's nothing else to do, but otherwise texinfo-master-menu should try and detect these problematic cases and signal an error/warning. Stefan From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "Roland Winkler" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 18:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= , 2975@debbugs.gnu.org, Karl Berry Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337039621224 (code B ref 2975); Thu, 08 Dec 2011 18:54:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 18:53:16 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYj5o-0005WH-3x for submit@debbugs.gnu.org; Thu, 08 Dec 2011 13:53:16 -0500 Received: from essmail.ess.niu.edu ([131.156.1.18]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYj5m-0005WA-NH for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 13:53:15 -0500 Received: from regnitz (lukas.physics.niu.edu [131.156.85.221]) by essmail.ess.niu.edu (8.14.3/8.14.3) with ESMTP id pB8IqJnl018527; Thu, 8 Dec 2011 12:52:21 -0600 (CST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <20193.1889.937384.407090@gargle.gargle.HOWL> Date: Thu, 8 Dec 2011 12:52:17 -0600 From: "Roland Winkler" In-Reply-To: References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> X-Mailer: VM 8.2 trial under 24.0.90.2 (x86_64-unknown-linux-gnu) X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.4 (---) On Thu Dec 8 2011 Eli Zaretskii wrote: > The simplest fix would be to remove the updating of the @node lines. > Would anyone object? Karl? A TeXnical question: what about using TeX to generate the output? To the best of my knowledge makinfo doesn't care about @node lines being up to date or not, it can fix them itself. Does the same hold for TeX? Roland From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "Roland Winkler" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 18:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii , =?UTF-8?Q?`t=1Bp=C3=A1n_?= =?UTF-8?Q?N=1Bmec?= , 2975@debbugs.gnu.org, karl@freefriends.org (Karl Berry) Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337059921515 (code B ref 2975); Thu, 08 Dec 2011 18:57:01 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 18:56:39 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYj94-0005ax-OP for submit@debbugs.gnu.org; Thu, 08 Dec 2011 13:56:39 -0500 Received: from essmail.ess.niu.edu ([131.156.1.18]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYj92-0005aq-SK for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 13:56:37 -0500 Received: from regnitz (lukas.physics.niu.edu [131.156.85.221]) by essmail.ess.niu.edu (8.14.3/8.14.3) with ESMTP id pB8Ith14018617; Thu, 8 Dec 2011 12:55:44 -0600 (CST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <20193.2093.50075.685498@gargle.gargle.HOWL> Date: Thu, 8 Dec 2011 12:55:41 -0600 From: "Roland Winkler" In-Reply-To: <20193.1889.937384.407090@gargle.gargle.HOWL> References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> X-Mailer: VM 8.2 trial under 24.0.90.2 (x86_64-unknown-linux-gnu) X-Spam-Score: -3.3 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.3 (---) On Thu Dec 8 2011 Roland Winkler wrote: > On Thu Dec 8 2011 Eli Zaretskii wrote: > > The simplest fix would be to remove the updating of the @node lines. > > Would anyone object? Karl? > > A TeXnical question: what about using TeX to generate the output? > To the best of my knowledge makinfo doesn't care about @node lines > being up to date or not, it can fix them itself. Does the same hold > for TeX? I am sorry, I overlooked you clarified this point in a previous post. Roland From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 19:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Roland Winkler" Cc: Eli Zaretskii , 2975@debbugs.gnu.org, Karl Berry Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337133622618 (code B ref 2975); Thu, 08 Dec 2011 19:09:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 19:08:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjKy-0005sk-9c for submit@debbugs.gnu.org; Thu, 08 Dec 2011 14:08:56 -0500 Received: from mail-ww0-f46.google.com ([74.125.82.46]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjKv-0005sd-Ji for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 14:08:54 -0500 Received: by wgbdq10 with SMTP id dq10so4096548wgb.15 for <2975@debbugs.gnu.org>; Thu, 08 Dec 2011 11:08:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type:content-transfer-encoding; bh=xZ21hFQXyqb62QeMfMwWoRf15h272WDgVT4N3fB0oZg=; b=nSNlp49xQNG8i5DabYMSHHdqvGgGJSwzIVNGsayhu2xkQ0WCtKykYLcbae5QED4Tvt IBx6YrkIx3cKMBR0DGN04s3TGu01ABEt9DXUzrdKnDI3b3LYSKE5fIXLCSpQClx02k7F IbEjnAa+FFTWbZnE8JkTDlQxQCoGRaHUMf8Ds= Received: by 10.216.136.168 with SMTP id w40mr38881wei.27.1323371208243; Thu, 08 Dec 2011 11:06:48 -0800 (PST) Received: from localhost (176.119.broadband10.iol.cz. [90.177.119.176]) by mx.google.com with ESMTPS id o3sm9881345wiy.14.2011.12.08.11.06.46 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 08 Dec 2011 11:06:47 -0800 (PST) From: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= In-Reply-To: <20193.1889.937384.407090@gargle.gargle.HOWL> (Roland Winkler's message of "Thu, 8 Dec 2011 12:52:17 -0600") References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) Date: Thu, 08 Dec 2011 20:06:45 +0100 Message-ID: <8739cuhohm.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -3.8 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.8 (---) On Thu, 08 Dec 2011 19:52:17 +0100 Roland Winkler wrote: > On Thu Dec 8 2011 Eli Zaretskii wrote: >> The simplest fix would be to remove the updating of the @node lines. >> Would anyone object? Karl? > > A TeXnical question: what about using TeX to generate the output?=20 > To the best of my knowledge makinfo doesn't care about @node lines > being up to date or not, it can fix them itself. Does the same hold > for TeX? Unless I'm missing something, you already got an answer to this question in Eli's first reply in this thread: --- [Roland] > Of course, I believe that makeinfo can add the info about the node > pointers. But what about output formats not supported by makeinfo? > I believe that something like TeX needs them. [Eli] TeX doesn't need them. These pointers are there to allow traversing the on-line manual, and are not needed for non on-line versions. --- (Personally I found Eli's explanation confusing -- what does "on-line" mean here? If it means HTML, makeinfo does support HTML output -- does it mean it doesn't cope with missing node pointers in the HTML case? If it means the standard Info manuals, then that's the principal format supported, isn't it...) --=20 =C5=A0t=C4=9Bp=C3=A1n From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 19:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Roland Winkler Cc: stepnem@gmail.com, 2975@debbugs.gnu.org, karl@freefriends.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337272624741 (code B ref 2975); Thu, 08 Dec 2011 19:33:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 19:32:06 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjhN-0006Qz-QT for submit@debbugs.gnu.org; Thu, 08 Dec 2011 14:32:06 -0500 Received: from mtaout21.012.net.il ([80.179.55.169]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjhK-0006Qr-Tk for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 14:32:04 -0500 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0LVW00K00GQHIB00@a-mtaout21.012.net.il> for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 21:31:10 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.228.102.185]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVW00KIKGVTC980@a-mtaout21.012.net.il>; Thu, 08 Dec 2011 21:31:06 +0200 (IST) Date: Thu, 08 Dec 2011 21:33:10 +0200 From: Eli Zaretskii In-reply-to: <20193.1889.937384.407090@gargle.gargle.HOWL> Message-id: <83y5umamfd.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: QUOTED-PRINTABLE X-012-Sender: halo1@inter.net.il References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > Date: Thu, 8 Dec 2011 12:52:17 -0600 > From: "Roland Winkler" > Cc: =C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec , > 2975@debbugs.gnu.org, karl@freefriends.org (Karl Berry) >=20 > On Thu Dec 8 2011 Eli Zaretskii wrote: > > The simplest fix would be to remove the updating of the @node lin= es. > > Would anyone object? Karl? >=20 > A TeXnical question: what about using TeX to generate the output?= =20 > To the best of my knowledge makinfo doesn't care about @node lines > being up to date or not, it can fix them itself. Does the same hold > for TeX? TeX ignores @node. From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 19:37:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Cc: karl@freefriends.org, winkler@gnu.org, 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337298025155 (code B ref 2975); Thu, 08 Dec 2011 19:37:01 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 19:36:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjlT-0006Xg-Sc for submit@debbugs.gnu.org; Thu, 08 Dec 2011 14:36:20 -0500 Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYjlS-0006XY-3X for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 14:36:19 -0500 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LVW00E00GYRN300@a-mtaout20.012.net.il> for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 21:35:26 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.228.102.185]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVW00DCQH30N7D0@a-mtaout20.012.net.il>; Thu, 08 Dec 2011 21:35:26 +0200 (IST) Date: Thu, 08 Dec 2011 21:37:29 +0200 From: Eli Zaretskii In-reply-to: <8739cuhohm.fsf@gmail.com> Message-id: <83wra6am86.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: QUOTED-PRINTABLE X-012-Sender: halo1@inter.net.il References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > From: =C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec > Cc: Eli Zaretskii , 2975@debbugs.gnu.org, Karl Berr= y > Date: Thu, 08 Dec 2011 20:06:45 +0100 >=20 > (Personally I found Eli's explanation confusing -- what does "on-li= ne" > mean here? If it means HTML, makeinfo does support HTML output -- d= oes > it mean it doesn't cope with missing node pointers in the HTML case= ? "On-line" means all on-line formats, including HTML. What do you mean by "it doesn't cope" -- who or what is "it" here? makeinfo does not need these pointers in the Texinfo sources to produce them in any of its outputs that are meant for on-line browsing. That includes HTML (and Info, of course). From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "=?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?=" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 20:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: karl@freefriends.org, =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= , winkler@gnu.org, 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132337445830215 (code B ref 2975); Thu, 08 Dec 2011 20:01:01 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 20:00:58 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYk9I-0007rH-QC for submit@debbugs.gnu.org; Thu, 08 Dec 2011 15:00:57 -0500 Received: from mail-bw0-f44.google.com ([209.85.214.44]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYk9D-0007r6-IA for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 15:00:53 -0500 Received: by bkbzs8 with SMTP id zs8so2056683bkb.3 for <2975@debbugs.gnu.org>; Thu, 08 Dec 2011 12:00:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:content-transfer-encoding :in-reply-to:user-agent; bh=/cuoTLtuPbRwJITOMyPKquirguisakuY4ipDYlE2Kyw=; b=Iqnj5gujuKY8USCmDT3VV6oMPENTf02DCLDSKTyuBLkM0vzYiRRyKk2pSMEUPpkQc9 TxcJD0UwHIXH+0++pKxwgUwvKz5pGEAQiLSyEdm7Y/+6FKOEywmZBnGS07SMmTastYwq bJAKfqSt7Iscqej0x1GBIbhBARqnAPoDBIjyE= Received: by 10.180.85.4 with SMTP id d4mr7640762wiz.19.1323374399846; Thu, 08 Dec 2011 11:59:59 -0800 (PST) Received: from localhost (176.119.broadband10.iol.cz. [90.177.119.176]) by mx.google.com with ESMTPS id m13sm9982229wbh.0.2011.12.08.11.59.58 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 08 Dec 2011 11:59:59 -0800 (PST) Date: Thu, 8 Dec 2011 20:59:57 +0100 From: "=?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?=" Message-ID: <20111208195957.GA19297@headley> References: <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> <83wra6am86.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <83wra6am86.fsf@gnu.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-Spam-Score: -3.8 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.8 (---) On Thu, Dec 08, 2011 at 09:37:29PM +0200, Eli Zaretskii wrote: > > From: Štěpán Němec > > Cc: Eli Zaretskii , 2975@debbugs.gnu.org, Karl Berry > > > > Date: Thu, 08 Dec 2011 20:06:45 +0100 > > > > (Personally I found Eli's explanation confusing -- what does > > "on-line" > > mean here? If it means HTML, makeinfo does support HTML output -- > > does > > it mean it doesn't cope with missing node pointers in the HTML case? > > "On-line" means all on-line formats, including HTML. > > What do you mean by "it doesn't cope" -- who or what is "it" here? makeinfo > makeinfo does not need these pointers in the Texinfo sources to > produce them in any of its outputs that are meant for on-line > browsing. That includes HTML (and Info, of course). Thank you for the clarification. Wouldn't it be even clearer (and simpler) to say that makeinfo just never needs those pointers? You wrote: TeX doesn't need them. These pointers are there to allow traversing the on-line manual, and are not needed for non on-line versions. So, given that makeinfo can add the info itself when needed, is there really ever any need for listing the node pointers explicitly at all? -- Štěpán From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "Roland Winkler" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 08 Dec 2011 20:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Stepan Nemec" Cc: Eli Zaretskii , 2975@debbugs.gnu.org, karl@freefriends.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13233777562612 (code B ref 2975); Thu, 08 Dec 2011 20:56:02 +0000 Received: (at 2975) by debbugs.gnu.org; 8 Dec 2011 20:55:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYl0W-0000g4-Ey for submit@debbugs.gnu.org; Thu, 08 Dec 2011 15:55:56 -0500 Received: from essmail.ess.niu.edu ([131.156.1.18]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYl0U-0000fx-11 for 2975@debbugs.gnu.org; Thu, 08 Dec 2011 15:55:54 -0500 Received: from regnitz (lukas.physics.niu.edu [131.156.85.221]) by essmail.ess.niu.edu (8.14.3/8.14.3) with ESMTP id pB8Ksv8j023687; Thu, 8 Dec 2011 14:54:58 -0600 (CST) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15 Content-Transfer-Encoding: quoted-printable Message-ID: <20193.9247.697042.440983@gargle.gargle.HOWL> Date: Thu, 8 Dec 2011 14:54:55 -0600 From: "Roland Winkler" In-Reply-To: <20111208195957.GA19297@headley> References: <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> <83wra6am86.fsf@gnu.org> <20111208195957.GA19297@headley> X-Mailer: VM 8.2 trial under 24.0.90.2 (x86_64-unknown-linux-gnu) X-Spam-Score: -3.2 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.2 (---) On Thu Dec 8 2011 =A6t p=E1n N mec wrote: > So, given that makeinfo can add the info itself when needed, is there= > really ever any need for listing the node pointers explicitly at all?= If Karl or whoever could answer this question with a clear "no, these node pointers are never needed" (say, for recent versions of makeinfo and other tools for formatting info pages) this could make things much easier! Roland From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 09 Dec 2011 07:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Roland Winkler Cc: stepnem@gmail.com, 2975@debbugs.gnu.org, karl@freefriends.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132341577629356 (code B ref 2975); Fri, 09 Dec 2011 07:30:02 +0000 Received: (at 2975) by debbugs.gnu.org; 9 Dec 2011 07:29:36 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYutk-0007dQ-7c for submit@debbugs.gnu.org; Fri, 09 Dec 2011 02:29:36 -0500 Received: from mtaout21.012.net.il ([80.179.55.169]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYuth-0007dF-8i for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 02:29:35 -0500 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0LVX00M00E0JO100@a-mtaout21.012.net.il> for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 09:28:38 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.126.156.225]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVX00MKYE3PLN50@a-mtaout21.012.net.il>; Fri, 09 Dec 2011 09:28:38 +0200 (IST) Date: Fri, 09 Dec 2011 09:28:37 +0200 From: Eli Zaretskii In-reply-to: <20193.9247.697042.440983@gargle.gargle.HOWL> Message-id: <83pqfymcey.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=iso-8859-15 Content-transfer-encoding: QUOTED-PRINTABLE X-012-Sender: halo1@inter.net.il References: <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> <83wra6am86.fsf@gnu.org> <20111208195957.GA19297@headley> <20193.9247.697042.440983@gargle.gargle.HOWL> X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) > Date: Thu, 8 Dec 2011 14:54:55 -0600 > From: "Roland Winkler" > Cc: Eli Zaretskii , 2975@debbugs.gnu.org, karl@freefr= iends.org >=20 > On Thu Dec 8 2011 =A6t p=E1n N mec wrote: > > So, given that makeinfo can add the info itself when needed, is t= here > > really ever any need for listing the node pointers explicitly at = all? >=20 > If Karl or whoever could answer this question with a clear "no, the= se > node pointers are never needed" (say, for recent versions of makein= fo > and other tools for formatting info pages) this could make things > much easier! I tried to explain that already, in my original mail: they are not needed if you structure your Texinfo source according to the rules described in "(texinfo)makeinfo Pointer Creation". Most manuals should have no problems being structured like that (the Emacs User Manual and Emacs Lisp Manual are actually structured according to those rules), but some specialized uses of Texinfo canno= t be limited to tree-like structure, or don't want to use sectioning commands (@chapter, @section, etc.) or menus, or want to order the nodes in some special way that defeats the automatic generation of node pointers. For these, you must explicitly have the Next, Prev, U= p pointers in Texinfo. From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 09 Dec 2011 07:32:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: =?UTF-8?Q?=C5=A0t=C4=9Bp=C3=A1n_?= =?UTF-8?Q?N=C4=9Bmec?= Cc: karl@freefriends.org, winkler@gnu.org, 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132341587029585 (code B ref 2975); Fri, 09 Dec 2011 07:32:01 +0000 Received: (at 2975) by debbugs.gnu.org; 9 Dec 2011 07:31:10 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYuvF-0007h7-9s for submit@debbugs.gnu.org; Fri, 09 Dec 2011 02:31:09 -0500 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYuvD-0007gy-7U for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 02:31:07 -0500 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LVX00M00E27KX00@a-mtaout22.012.net.il> for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 09:30:12 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.126.156.225]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVX00A0ZE6A9DA3@a-mtaout22.012.net.il>; Fri, 09 Dec 2011 09:30:11 +0200 (IST) Date: Fri, 09 Dec 2011 09:30:10 +0200 From: Eli Zaretskii In-reply-to: <20111208195957.GA19297@headley> Message-id: <83obvimccd.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: QUOTED-PRINTABLE X-012-Sender: halo1@inter.net.il References: <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> <83wra6am86.fsf@gnu.org> <20111208195957.GA19297@headley> X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) > Date: Thu, 8 Dec 2011 20:59:57 +0100 > From: "=C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec" > Cc: =C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec , > =09winkler@gnu.org, 2975@debbugs.gnu.org, karl@freefriends.org >=20 > > makeinfo does not need these pointers in the Texinfo sources to > > produce them in any of its outputs that are meant for on-line > > browsing. That includes HTML (and Info, of course). >=20 > Thank you for the clarification. Wouldn't it be even clearer (and > simpler) to say that makeinfo just never needs those pointers? It would, if it were true. But it isn't, see my other mail. From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: "Roland Winkler" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 09 Dec 2011 07:50:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: stepnem@gmail.com, 2975@debbugs.gnu.org, karl@freefriends.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132341696031219 (code B ref 2975); Fri, 09 Dec 2011 07:50:01 +0000 Received: (at 2975) by debbugs.gnu.org; 9 Dec 2011 07:49:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYvCp-00087T-VU for submit@debbugs.gnu.org; Fri, 09 Dec 2011 02:49:20 -0500 Received: from essmail.ess.niu.edu ([131.156.1.18]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RYvCn-00087L-Sc for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 02:49:18 -0500 Received: from regnitz (lukas.physics.niu.edu [131.156.85.221]) by essmail.ess.niu.edu (8.14.3/8.14.3) with ESMTP id pB97mKmK014912; Fri, 9 Dec 2011 01:48:21 -0600 (CST) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <20193.48452.578669.370574@gargle.gargle.HOWL> Date: Fri, 9 Dec 2011 01:48:20 -0600 From: "Roland Winkler" In-Reply-To: <83pqfymcey.fsf@gnu.org> References: <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> <20193.1889.937384.407090@gargle.gargle.HOWL> <8739cuhohm.fsf@gmail.com> <83wra6am86.fsf@gnu.org> <20111208195957.GA19297@headley> <20193.9247.697042.440983@gargle.gargle.HOWL> <83pqfymcey.fsf@gnu.org> X-Mailer: VM 8.2 trial under 24.0.90.2 (x86_64-unknown-linux-gnu) X-Spam-Score: -3.2 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.1 (---) On Fri Dec 9 2011 Eli Zaretskii wrote: > I tried to explain that already, in my original mail: they are not > needed if you structure your Texinfo source according to the rules > described in "(texinfo)makeinfo Pointer Creation". > > Most manuals should have no problems being structured like that (the > Emacs User Manual and Emacs Lisp Manual are actually structured > according to those rules), but some specialized uses of Texinfo cannot > be limited to tree-like structure, or don't want to use sectioning > commands (@chapter, @section, etc.) or menus, or want to order the > nodes in some special way that defeats the automatic generation of > node pointers. For these, you must explicitly have the Next, Prev, Up > pointers in Texinfo. OK, thanks a lot. For me, this is an important clarification. Roland From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi References: <20090412213340.GA3615@muc.de> Resent-From: karl@freefriends.org (Karl Berry) Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Dec 2011 00:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: winkler@gnu.org Cc: eliz@gnu.org, stepnem@gmail.com, 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132347632527225 (code B ref 2975); Sat, 10 Dec 2011 00:19:01 +0000 Received: (at 2975) by debbugs.gnu.org; 10 Dec 2011 00:18:45 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZAeL-000754-41 for submit@debbugs.gnu.org; Fri, 09 Dec 2011 19:18:45 -0500 Received: from b0.f7.net ([66.148.120.132] helo=freefriends.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZAeI-00074w-Qu for 2975@debbugs.gnu.org; Fri, 09 Dec 2011 19:18:44 -0500 X-Envelope-From: karl@freefriends.org Received: from sls-af11p1.sea2.superbservers.com (sls-af11p1.sea2.superbservers.com [127.0.0.1]) by freefriends.org (8.14.4/8.14.4) with ESMTP id pBA0HfOZ028605; Fri, 9 Dec 2011 16:17:44 -0800 Received: (from nobody@localhost) by sls-af11p1.sea2.superbservers.com (8.14.4/8.13.8/Submit) id pBA0Hf4Y028604; Fri, 9 Dec 2011 16:17:41 -0800 Date: Fri, 9 Dec 2011 16:17:41 -0800 Message-Id: <201112100017.pBA0Hf4Y028604@sls-af11p1.sea2.superbservers.com> X-Authentication-Warning: sls-af11p1.sea2.superbservers.com: nobody set sender to karl@freefriends.org using -f From: karl@freefriends.org (Karl Berry) In-Reply-To: <20193.9247.697042.440983@gargle.gargle.HOWL> X-Spam-Score: -3.3 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.3 (---) > So, given that makeinfo can add the info itself when needed, is there > really ever any need for listing the node pointers explicitly at all? If Karl or whoever could answer this question with a clear "no, these node pointers are never needed" I believe Eli answered this, but to reiterate, it is only (very) exceptional manuals which might need node pointers. So if you're asking if texinfo-mode needs to keep supporting them, I would say, definitely not. In fact, I think it would be a good thing if it didn't. I have seen many authors have unnecessary problems due to texinfo-mode inserting the node pointers. k From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Dec 2011 10:59:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: karl@freefriends.org (Karl Berry) Cc: stepnem@gmail.com, winkler@gnu.org, 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13235146931031 (code B ref 2975); Sat, 10 Dec 2011 10:59:01 +0000 Received: (at 2975) by debbugs.gnu.org; 10 Dec 2011 10:58:13 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZKdB-0000Ga-92 for submit@debbugs.gnu.org; Sat, 10 Dec 2011 05:58:13 -0500 Received: from mtaout23.012.net.il ([80.179.55.175]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZKd9-0000GO-GA for 2975@debbugs.gnu.org; Sat, 10 Dec 2011 05:58:12 -0500 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0LVZ00400IEQDD00@a-mtaout23.012.net.il> for 2975@debbugs.gnu.org; Sat, 10 Dec 2011 12:57:10 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.228.102.96]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVZ004RDIF8CP20@a-mtaout23.012.net.il>; Sat, 10 Dec 2011 12:57:10 +0200 (IST) Date: Sat, 10 Dec 2011 12:57:09 +0200 From: Eli Zaretskii In-reply-to: <201112100017.pBA0Hf4Y028604@sls-af11p1.sea2.superbservers.com> X-012-Sender: halo1@inter.net.il Message-id: <83borgn18a.fsf@gnu.org> References: <201112100017.pBA0Hf4Y028604@sls-af11p1.sea2.superbservers.com> X-Spam-Score: -1.7 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.7 (-) > Date: Fri, 9 Dec 2011 16:17:41 -0800 > From: karl@freefriends.org (Karl Berry) > Cc: stepnem@gmail.com, eliz@gnu.org, 2975@debbugs.gnu.org > > > So, given that makeinfo can add the info itself when needed, is there > > really ever any need for listing the node pointers explicitly at all? > > If Karl or whoever could answer this question with a clear "no, these > node pointers are never needed" > > I believe Eli answered this, but to reiterate, it is only (very) > exceptional manuals which might need node pointers. > > So if you're asking if texinfo-mode needs to keep supporting them, I > would say, definitely not. In fact, I think it would be a good thing if > it didn't. I have seen many authors have unnecessary problems due to > texinfo-mode inserting the node pointers. I updated the commentary and the doc strings of the relevant functions in texnfo-upd.el to the effect that texinfo-update-node and the commands that call it should only be used if one knows what they are doing. I also made texinfo-master-menu call texinfo-update-node only if the prefix arg is numeric, because invoking texinfo-master-menu with just C-u is still useful and much less problematic. I decided not to remove the code that updates the @node lines entirely, since texinfo-update-node could still be useful to experts in very specialized use cases. I also added to the doc strings of relevant commands a note about non-support of multi-file Texinfo manuals, and a reference to texinfo-multiple-files-update, which does. I hope this makes the situation quite a bit better. From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: texinfo-master-menu and emacs.texi Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Dec 2011 11:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Monnier Cc: karl@freefriends.org, stepnem@gmail.com, 2975@debbugs.gnu.org, winkler@gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13235148801597 (code B ref 2975); Sat, 10 Dec 2011 11:02:02 +0000 Received: (at 2975) by debbugs.gnu.org; 10 Dec 2011 11:01:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZKgA-0000Pd-OI for submit@debbugs.gnu.org; Sat, 10 Dec 2011 06:01:19 -0500 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZKg8-0000PQ-6k for 2975@debbugs.gnu.org; Sat, 10 Dec 2011 06:01:16 -0500 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LVZ00G00IEO7Y00@a-mtaout22.012.net.il> for 2975@debbugs.gnu.org; Sat, 10 Dec 2011 13:00:14 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.228.102.96]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVZ00FDCIKAJH90@a-mtaout22.012.net.il>; Sat, 10 Dec 2011 13:00:12 +0200 (IST) Date: Sat, 10 Dec 2011 13:00:11 +0200 From: Eli Zaretskii In-reply-to: Message-id: <83aa70n138.fsf@gnu.org> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: QUOTED-PRINTABLE X-012-Sender: halo1@inter.net.il References: <20191.12232.556454.551166@gargle.gargle.HOWL> <20191.48632.665251.448872@gargle.gargle.HOWL> <20191.55423.572257.75919@gargle.gargle.HOWL> <877h27gxh2.fsf@gmail.com> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > From: Stefan Monnier > Cc: =C5=A0t=C4=9Bp=C3=A1n N=C4=9Bmec , > 2975@debbugs.gnu.org, winkler@gnu.org, > Karl Berry > > Date: Thu, 08 Dec 2011 09:46:49 -0500 >=20 > Eli writes: > > The simplest fix would be to remove the updating of the @node lin= es. > > Would anyone object? Karl? >=20 > That would be great. I made it extremely optional instead: only "C-u N" where N is a numbe= r would cause @node lines to be updated with next/prev/up pointers. > Eli writes: > > I guess I'm saying that the importance of these commands in the > > context of maintaining Emacs documentation is somewhat exaggerate= d in > > this thread, to say the least ;-) >=20 > IIUC the OP is not directly interested in maintaining Emacs > documentation but rather is trying to write a manual for another pr= oject > (BBDB, which happens to be an Emacs package). He was asking about the effects of invoking these commands on emacs.texi. > Eli writes: > > Here's what I see there: > > . texinfo-master-menu indeed does not support multiple-file manu= als, > > so it removed all the menu items whose nodes are in files othe= r > > than emacs.texi itself >=20 > A good fix here would be for texinfo-master-menu to detect the prob= lem > and signal a warning/error. >=20 > > . texinfo-master-menu doesn't grok @iftex and @ifnottext conditi= onals > > (and probably the other @if... conditionals as well), so it > > produced bad Next and Prev pointers, because, e.g., this: >=20 > If leaving Node pointers alone fixes this problem, then there's not= hing > else to do, but otherwise texinfo-master-menu should try and detect > these problematic cases and signal an error/warning. The detection and error signaling are left as an exercise for the interested readers ;-) From unknown Mon Aug 18 09:04:44 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.427 (Entity 5.427) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Alan Mackenzie Subject: bug#2975: closed (Re: `texinfo-master-menu' doesn't work.) Message-ID: References: <837h24mwfs.fsf@gnu.org> <20090412213340.GA3615@muc.de> X-Gnu-PR-Message: they-closed 2975 X-Gnu-PR-Package: emacs Reply-To: 2975@debbugs.gnu.org Date: Sat, 10 Dec 2011 12:43:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1323520982-21430-1" This is a multi-part message in MIME format... ------------=_1323520982-21430-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #2975: `texinfo-master-menu' doesn't work. which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 2975@debbugs.gnu.org. --=20 2975: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D2975 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1323520982-21430-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 2975-done) by debbugs.gnu.org; 10 Dec 2011 12:42:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZMFv-0005Xo-47 for submit@debbugs.gnu.org; Sat, 10 Dec 2011 07:42:20 -0500 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZMFs-0005Xa-Uf for 2975-done@debbugs.gnu.org; Sat, 10 Dec 2011 07:42:18 -0500 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LVZ00H00N37GD00@a-mtaout22.012.net.il> for 2975-done@debbugs.gnu.org; Sat, 10 Dec 2011 14:40:41 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.228.102.96]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LVZ00AB3N7QEDC2@a-mtaout22.012.net.il>; Sat, 10 Dec 2011 14:40:41 +0200 (IST) Date: Sat, 10 Dec 2011 14:40:39 +0200 From: Eli Zaretskii Subject: Re: `texinfo-master-menu' doesn't work. In-reply-to: <20090412213340.GA3615@muc.de> X-012-Sender: halo1@inter.net.il To: Alan Mackenzie Message-id: <837h24mwfs.fsf@gnu.org> References: <20090412213340.GA3615@muc.de> X-Spam-Score: -2.0 (--) X-Debbugs-Envelope-To: 2975-done Cc: bug-texinfo@gnu.org, 2975-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: Eli Zaretskii List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > Date: Sun, 12 Apr 2009 21:33:40 +0000 > From: Alan Mackenzie > > 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. "C-c C-u m" (texinfo-master-menu) is not supposed to update the menus in the buffer, including the menu in the Top node, unless you invoke it with a prefix argument. If you don't invoke it with a prefix arg, you need to update the menus yourself, either manually or by running texinfo-make-menu or texinfo-all-menus-update. This is because this command only looks at the _existing_ menus; it does NOT look at the @node lines to recreate or update any missing/outdated entries in those menus. I made this clear in the doc string of texinfo-master-menu. > 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. The error is signaled because texinfo-master-menu does not update or create any menus, see above. By deleting the menu in the Top node, you removed the part of the buffer on which texinfo-master-menu depends for doing its job. So it barfed. I changed the error message text so it is hopefully more clear. It now says: Buffer lacks a menu in its first node; create it, then run me again > 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. texinfo-master-menu does not support multi-file manuals (which is what elisp.texi is). For that, one should use texinfo-multiple-files-update. I made that clear in the doc string. > 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. I made that more clear in the commentary at the beginning of texnfo-upd.el and in the doc string of texinfo-master-menu. > 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. The crucial part of the doc string was this: The master menu includes every entry from all the other menus. IOW, it only collects entries from existing menus, it does NOT update the menus. Admittedly, this crucial piece of information was buried deep in the doc string. Hopefully, now it is more clear. All of the above changes are in revision 106651 on the trunk. I'm closing this bug report. Sorry for the long delay in handling it. ------------=_1323520982-21430-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 12 Apr 2009 21:34:11 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=none autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 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 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 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 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 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 Received: (qmail 43219 invoked by uid 3782); 12 Apr 2009 21:33:54 -0000 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 Received: (qmail 4723 invoked by uid 1000); 12 Apr 2009 21:33:40 -0000 Date: Sun, 12 Apr 2009 21:33:40 +0000 To: bug-texinfo@gnu.org, bug-gnu-emacs@gnu.org Subject: `texinfo-master-menu' doesn't work. Message-ID: <20090412213340.GA3615@muc.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 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). ------------=_1323520982-21430-1-- From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: `texinfo-master-menu' doesn't work. Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Dec 2011 18:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13236275611666 (code B ref 2975); Sun, 11 Dec 2011 18:20:01 +0000 Received: (at 2975) by debbugs.gnu.org; 11 Dec 2011 18:19:21 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZnzc-0000Qp-Te for submit@debbugs.gnu.org; Sun, 11 Dec 2011 13:19:21 -0500 Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RZnzZ-0000Qg-Ha for 2975@debbugs.gnu.org; Sun, 11 Dec 2011 13:19:19 -0500 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LW100E00XGT9K00@a-mtaout22.012.net.il> for 2975@debbugs.gnu.org; Sun, 11 Dec 2011 20:18:08 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.124.128.192]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LW1006N4XI4F7W1@a-mtaout22.012.net.il>; Sun, 11 Dec 2011 20:18:08 +0200 (IST) Date: Sun, 11 Dec 2011 20:18:06 +0200 From: Eli Zaretskii In-reply-to: <20111211173859.GA2755@acm.acm> X-012-Sender: halo1@inter.net.il Message-id: <83mxazkm5d.fsf@gnu.org> References: <20090412213340.GA3615@muc.de> <837h24mwfs.fsf@gnu.org> <20111211173859.GA2755@acm.acm> X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > Date: Sun, 11 Dec 2011 17:38:59 +0000 > Cc: bug-texinfo@gnu.org, 2975-done@debbugs.gnu.org > From: Alan Mackenzie > > > "C-c C-u m" (texinfo-master-menu) is not supposed to update the menus > > in the buffer, including the menu in the Top node, unless you invoke > > it with a prefix argument. If you don't invoke it with a prefix arg, > > you need to update the menus yourself, either manually or by running > > texinfo-make-menu or texinfo-all-menus-update. This is because this > > command only looks at the _existing_ menus; it does NOT look at the > > @node lines to recreate or update any missing/outdated entries in > > those menus. > > > I made this clear in the doc string of texinfo-master-menu. > > Sorry, I find it anything but clear. I think I've finally twigged what > C-c C-u m does. It creates or updates the @detailmenu part of the master > menu. Please correct me if I'm wrong about this. However, it doesn't > create/update the first part of the master menu, and nor does it create > the @detailmenu if @menu is missing. Correct. And now the current doc string: "Make a master menu for a whole Texinfo file. Remove pre-existing master menu, if there is one. This function supports only single-file manuals. For multi-file manuals, use `texinfo-multiple-files-update'. This function creates or updates the @detailmenu section of a master menu that follows the Top node. It replaces any existing detailed menu that follows the top node. The detailed menu includes every entry from all the other menus. By default, the existing menus, including the menu in the Top node, are not updated according to the buffer contents, so all the menus should be updated first using `texinfo-make-menu' or `texinfo-all-menus-update', which see. Alternatively, invoke this function with a prefix argument, see below. Non-nil, non-numeric argument (C-u prefix, if interactive) means first update all existing menus in the buffer (incorporating descriptions from pre-existing menus) before it constructs the master menu. If the argument is numeric (e.g., \"C-u 2\"), update all existing nodes as well, by calling \`texinfo-update-node' on the entire file. Warning: do NOT invoke with a numeric argument if your Texinfo file uses @node lines without the `Next', `Previous', `Up' pointers, as the result could be an invalid Texinfo file! The function removes and recreates the detailed part of an already existing master menu. This action assumes that the pre-existing master menu uses the standard `texinfo-master-menu-header' for the detailed menu. The master menu has the following format, which is adapted from the recommendation in the Texinfo Manual: * The first part contains the major nodes in the Texinfo file: the nodes for the chapters, chapter-like sections, and the major appendices. This includes the indices, so long as they are in chapter-like sections, such as unnumbered sections. * The second and subsequent parts contain a listing of the other, lower level menus, in order. This way, an inquirer can go directly to a particular node if he or she is searching for specific information. Each of the menus in the detailed node listing is introduced by the title of the section containing the menu. > @dfn{master menu} is on page "Master Menu Parts" in the Texinfo manual. > In particular, > > A master menu is enclosed in `@menu' and `@end menu' commands ... I didn't do anything with the Texinfo manual, mind you. This bug report is about Emacs. > Why doesn't C-c C-u m update the entire master menu? I mean, what use is > the current command, as opposed to the one I want? I'm just guessing here, but my guess is that you sometimes may wish to create or update only the @detailmenu. After all, texinfo-make-menu is the way to create/update any menu, including the top-level menu, if you don't have one or if it is outdated. > > > 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. > > > The error is signaled because texinfo-master-menu does not update or > > create any menus, see above. > > t-m-m's doc string states explicitly that it DOES make a master menu. It sounds like your notion of "master menu" is different from what the command means, see above. > > IOW, it only collects entries from existing menus, it does NOT update > > the menus. Admittedly, this crucial piece of information was buried > > deep in the doc string. Hopefully, now it is more clear. > > I think I've understood now, but I don't think it's at all clear. Feel free to suggest specific improvements or point out specific parts of the doc string that need improvement. From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: `texinfo-master-menu' doesn't work. Resent-From: Alan Mackenzie Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 12 Dec 2011 12:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii Cc: 2975@debbugs.gnu.org Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.1323693177882 (code B ref 2975); Mon, 12 Dec 2011 12:33:01 +0000 Received: (at 2975) by debbugs.gnu.org; 12 Dec 2011 12:32:57 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ra53x-0000EB-DJ for submit@debbugs.gnu.org; Mon, 12 Dec 2011 07:32:57 -0500 Received: from colin.muc.de ([193.149.48.1] helo=mail.muc.de) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ra53u-0000Dz-GG for 2975@debbugs.gnu.org; Mon, 12 Dec 2011 07:32:56 -0500 Received: (qmail 6269 invoked by uid 3782); 12 Dec 2011 12:31:41 -0000 Received: from acm.muc.de (pD9556F26.dip.t-dialin.net [217.85.111.38]) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 12 Dec 2011 13:31:39 +0100 Received: (qmail 2982 invoked by uid 1000); 12 Dec 2011 12:25:44 -0000 Date: Mon, 12 Dec 2011 12:25:44 +0000 Message-ID: <20111212122544.GA2910@acm.acm> References: <20090412213340.GA3615@muc.de> <837h24mwfs.fsf@gnu.org> <20111211173859.GA2755@acm.acm> <83mxazkm5d.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <83mxazkm5d.fsf@gnu.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -2.8 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.8 (--) Hello again, Eli. On Sun, Dec 11, 2011 at 08:18:06PM +0200, Eli Zaretskii wrote: > > Date: Sun, 11 Dec 2011 17:38:59 +0000 > > Cc: bug-texinfo@gnu.org, 2975-done@debbugs.gnu.org > > From: Alan Mackenzie > > > "C-c C-u m" (texinfo-master-menu) is not supposed to update the menus > > > in the buffer, including the menu in the Top node, unless you invoke > > > it with a prefix argument. If you don't invoke it with a prefix arg, > > > you need to update the menus yourself, either manually or by running > > > texinfo-make-menu or texinfo-all-menus-update. This is because this > > > command only looks at the _existing_ menus; it does NOT look at the > > > @node lines to recreate or update any missing/outdated entries in > > > those menus. > > > I made this clear in the doc string of texinfo-master-menu. Although I updated and rebuilt Emacs yesterday, I got the old doc string, so please forgive my reply. The way I got this doc string was: emacs -Q M-x load-library texinfo C-h f texinfo-master-menu . It turns out that the doc string is duplicated in texinfo.el in an autoload form. ;-( [ .... ] > And now the current doc string: > "Make a master menu for a whole Texinfo file. > Remove pre-existing master menu, if there is one. > This function supports only single-file manuals. For multi-file > manuals, use `texinfo-multiple-files-update'. > This function creates or updates the @detailmenu section of a > master menu that follows the Top node. It replaces any existing > detailed menu that follows the top node. The detailed menu > includes every entry from all the other menus. By default, the > existing menus, including the menu in the Top node, are not > updated according to the buffer contents, so all the menus should > be updated first using `texinfo-make-menu' or > `texinfo-all-menus-update', which see. Alternatively, invoke > this function with a prefix argument, see below. > Non-nil, non-numeric argument (C-u prefix, if interactive) means > first update all existing menus in the buffer (incorporating > descriptions from pre-existing menus) before it constructs the Correction: "before CONSTRUCTING the master menu." > master menu. If the argument is numeric (e.g., \"C-u 2\"), > update all existing nodes as well, by calling > \`texinfo-update-node' on the entire file. Warning: do NOT > invoke with a numeric argument if your Texinfo file uses @node > lines without the `Next', `Previous', `Up' pointers, as the > result could be an invalid Texinfo file! > The function removes and recreates the detailed part of an already > existing master menu. This action assumes that the pre-existing > master menu uses the standard `texinfo-master-menu-header' for the > detailed menu. > The master menu has the following format, which is adapted from the > recommendation in the Texinfo Manual: > * The first part contains the major nodes in the Texinfo file: the > nodes for the chapters, chapter-like sections, and the major > appendices. This includes the indices, so long as they are in > chapter-like sections, such as unnumbered sections. > * The second and subsequent parts contain a listing of the other, > lower level menus, in order. This way, an inquirer can go > directly to a particular node if he or she is searching for > specific information. > Each of the menus in the detailed node listing is introduced by the > title of the section containing the menu. > > @dfn{master menu} is on page "Master Menu Parts" in the Texinfo manual. > > In particular, > > A master menu is enclosed in `@menu' and `@end menu' commands ... > I didn't do anything with the Texinfo manual, mind you. This bug > report is about Emacs. :-) There's an inconsistency there. The manual is Karl B's thing, isn't it? > > Why doesn't C-c C-u m update the entire master menu? I mean, what use is > > the current command, as opposed to the one I want? > I'm just guessing here, but my guess is that you sometimes may wish to > create or update only the @detailmenu. After all, texinfo-make-menu > is the way to create/update any menu, including the top-level menu, if > you don't have one or if it is outdated. [ .... ] > > t-m-m's doc string states explicitly that it DOES make a master menu. > It sounds like your notion of "master menu" is different from what the > command means, see above. THAT is the thing that's caused this discussion. I have conceptualised "master menu" as the entire hierarchical thing starting at Top. You have seen a separate menu in each node (including Top) and then @detailedmenu as a summary, a distinct entity. Now everything is clear. -- Alan Mackenzie (Nuremberg, Germany). From unknown Mon Aug 18 09:04:44 2025 X-Loop: help-debbugs@gnu.org Subject: bug#2975: `texinfo-master-menu' doesn't work. Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 12 Dec 2011 13:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 2975 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Alan Mackenzie Cc: 2975@debbugs.gnu.org Reply-To: Eli Zaretskii Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.13236949963598 (code B ref 2975); Mon, 12 Dec 2011 13:04:02 +0000 Received: (at 2975) by debbugs.gnu.org; 12 Dec 2011 13:03:16 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ra5XI-0000vz-GL for submit@debbugs.gnu.org; Mon, 12 Dec 2011 08:03:16 -0500 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ra5XF-0000vq-Gv for 2975@debbugs.gnu.org; Mon, 12 Dec 2011 08:03:14 -0500 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1Ra5W5-0002yz-20; Mon, 12 Dec 2011 08:02:01 -0500 Date: Mon, 12 Dec 2011 08:02:01 -0500 Message-Id: From: Eli Zaretskii In-reply-to: <20111212122544.GA2910@acm.acm> (message from Alan Mackenzie on Mon, 12 Dec 2011 12:25:44 +0000) References: <20090412213340.GA3615@muc.de> <837h24mwfs.fsf@gnu.org> <20111211173859.GA2755@acm.acm> <83mxazkm5d.fsf@gnu.org> <20111212122544.GA2910@acm.acm> X-Spam-Score: -6.6 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.6 (------) > Date: Mon, 12 Dec 2011 12:25:44 +0000 > Cc: 2975@debbugs.gnu.org > From: Alan Mackenzie > > > It sounds like your notion of "master menu" is different from what the > > command means, see above. > > THAT is the thing that's caused this discussion. I have conceptualised > "master menu" as the entire hierarchical thing starting at Top. You have > seen a separate menu in each node (including Top) and then @detailedmenu > as a summary, a distinct entity. Now everything is clear. Does the new doc string make this clear, or do you still see place for improvement? Thanks.