From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: GTK documentation in Emacs Date: Sat, 11 Jan 2003 17:48:06 +0300 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <2427-Sat11Jan2003174805+0200-eliz@is.elta.co.il> References: <200301111157.h0BBv9DU032103@stubby.bodenonline.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1042304043 2553 80.91.224.249 (11 Jan 2003 16:54:03 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 11 Jan 2003 16:54:03 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18XOtV-0000es-00 for ; Sat, 11 Jan 2003 17:54:01 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18XP05-0006Eh-00 for ; Sat, 11 Jan 2003 18:00:49 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18XOpd-00089H-00 for emacs-devel@quimby.gnus.org; Sat, 11 Jan 2003 11:50:01 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18XOoq-0007Qu-00 for emacs-devel@gnu.org; Sat, 11 Jan 2003 11:49:12 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18XOnz-0006HG-00 for emacs-devel@gnu.org; Sat, 11 Jan 2003 11:48:20 -0500 Original-Received: from thor.inter.net.il ([192.114.186.11]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18XOlF-0005WG-00 for emacs-devel@gnu.org; Sat, 11 Jan 2003 11:45:29 -0500 Original-Received: from zaretsky ([80.230.194.188]) by thor.inter.net.il (Mirapoint Messaging Server MOS 3.2.2-GA) with ESMTP id ASC94539; Sat, 11 Jan 2003 17:51:08 +0200 (IST) Original-To: jan.h.d@swipnet.se X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <200301111157.h0BBv9DU032103@stubby.bodenonline.com> (jan.h.d@swipnet.se) Original-cc: karl@freefriends.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:10653 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10653 > From: "Jan D." > Date: Sat, 11 Jan 2003 12:01:21 +0100 (MET) > Cc: emacs-devel@gnu.org > > > > > > From: "Jan D." > > > Date: Sat, 11 Jan 2003 09:29:18 +0100 (CET) > > > > > > When I use "@node Foo" only I get this: > > > ./xresources.texi:585: `GTK widget paths' has no Up field. > > > ./xresources.texi:636: `GTK names in Emacs' has no Up field. > > > ./xresources.texi:720: `GTK styles' has no Up field. > > > makeinfo: Removing output file `../info/emacs' due to errors; use --force to preserve. > > > > This happens because your top-level GTK section has the @appendixsec > > directive in it, but all the other sections, which are subsections of > > the top-level section, always use @appendixsec. You should instead > > use @appendixsubsec in the 3 subsections; then the problem will go > > away. (Sorry I didn't mention this restriction in my message.) > > I just figured this out :-) > > > As the node "makeinfo Pointer Creation" in the Texinfo manual > > explains, makeinfo uses the sectioning commands to deduce the > > hierarchical structure of the document. So you must use the > > sectioning commands, and you must mark each chapter and section > > correctly with sectioning commands, for the automatic pointer creation > > to work. > > This makes sense. I wish maekinfo said something about "sectioning > structure not consistent with menu structure" or something like > that. I agree. I cc'ed Karl Berry, who is the Texinfo maintainer, in the hope that the error message could be improved in some future release.