Re: GTK documentation in Emacs

["Eli Zaretskii" <eliz@is.elta.co.il>]

> From: "Jan D." <jan.h.d@swipnet.se>
> Date: Sat, 11 Jan 2003 12:01:21 +0100 (MET)
> Cc: emacs-devel@gnu.org
> 
> > 
> > > From: "Jan D." <jan.h.d@swipnet.se>
> > > 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.