From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#2975: texinfo-master-menu and emacs.texi Date: Fri, 09 Dec 2011 09:28:37 +0200 Message-ID: <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> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15 Content-Transfer-Encoding: QUOTED-PRINTABLE X-Trace: dough.gmane.org 1323415759 4891 80.91.229.12 (9 Dec 2011 07:29:19 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 9 Dec 2011 07:29:19 +0000 (UTC) Cc: stepnem@gmail.com, 2975@debbugs.gnu.org, karl@freefriends.org To: Roland Winkler Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 09 08:29:14 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1RYutO-0002Sg-45 for geb-bug-gnu-emacs@m.gmane.org; Fri, 09 Dec 2011 08:29:14 +0100 Original-Received: from localhost ([::1]:44525 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYutN-00048E-Jx for geb-bug-gnu-emacs@m.gmane.org; Fri, 09 Dec 2011 02:29:13 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:58803) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYutK-00047v-DY for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2011 02:29:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RYutJ-0003I0-4F for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2011 02:29:10 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:59226) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYutI-0003Hv-TT for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2011 02:29:09 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RYuuA-0007eT-3v for bug-gnu-emacs@gnu.org; Fri, 09 Dec 2011 02:30:02 -0500 X-Loop: help-debbugs@gnu.org 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: Original-Received: via spool by 2975-submit@debbugs.gnu.org id=B2975.132341577629356 (code B ref 2975); Fri, 09 Dec 2011 07:30:02 +0000 Original-Received: (at 2975) by debbugs.gnu.org; 9 Dec 2011 07:29:36 +0000 Original-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 Original-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 Original-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) Original-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) In-reply-to: <20193.9247.697042.440983@gargle.gargle.HOWL> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 09 Dec 2011 02:30:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:54830 Archived-At: > 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.