From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: texinfo-master-menu and emacs.texi Date: Wed, 07 Dec 2011 08:19:27 -0500 Message-ID: References: <20191.12232.556454.551166@gargle.gargle.HOWL> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1323263980 27035 80.91.229.12 (7 Dec 2011 13:19:40 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 7 Dec 2011 13:19:40 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Roland Winkler" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 07 14:19:35 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RYHPJ-0003p7-9Z for ged-emacs-devel@m.gmane.org; Wed, 07 Dec 2011 14:19:33 +0100 Original-Received: from localhost ([::1]:36792 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYHPI-0001aT-8b for ged-emacs-devel@m.gmane.org; Wed, 07 Dec 2011 08:19:32 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:39862) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYHPF-0001aD-AB for emacs-devel@gnu.org; Wed, 07 Dec 2011 08:19:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RYHPE-000374-CW for emacs-devel@gnu.org; Wed, 07 Dec 2011 08:19:29 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]:33108) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYHPE-00036p-Ay for emacs-devel@gnu.org; Wed, 07 Dec 2011 08:19:28 -0500 Original-Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RYHPD-0000vm-PC; Wed, 07 Dec 2011 08:19:27 -0500 In-reply-to: <20191.12232.556454.551166@gargle.gargle.HOWL> (winkler@gnu.org) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.10 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:146544 Archived-At: > Date: Wed, 7 Dec 2011 03:20:08 -0600 > From: "Roland Winkler" > > 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. > > The emacs command texinfo-master-menu (used with a prefix arg) is > supposed to do that; according to the doc string it updates all > existing nodes and menus. Yet when I run this command on emacs.texi, > this brings emacs.texi into a format that makes makeinfo rather > unhappy. What is going on here? It would help if you'd show the error messages from the "unhappy" makeinfo. As things are, I need to guess, and my guess is that texinfo-master-menu does not support multi-file manuals. It only works on a single buffer. At least I don't see in its code any hints that it does have the ability to gather all the multiple files which constitute the ELisp manual, using the @include directives or some such. My advice is to use texinfo-update-node and texinfo-make-menu on individual nodes or groups of nodes as you go; that's what I do. Unless your manual is on a single large file, in which case I expect texinfo-master-menu to just work. > Or is there a more sophisticated way of updating nodes in an > automated fashion that works even for something like emacs.texi? What I advise above is AFAIK the "more sophisticated way".