Back to an old issue :)

>>>>> "Eli" == Eli Zaretskii <[EMAIL PROTECTED]> writes:

Eli> However, if your @node's don't have explicit prev, next, up
Eli> links, makeinfo needs to compute them for you.  The way it does
Eli> that is to reconstruct the node tree by going back in the file
Eli> all the way to @top.  So in this case, Top *is* required.

This is what I was indeed expecting from it.  So I thought I had
understood: to leave me at peace, makeinfo wants that @top be @node
Top, OK.  Then I can leave the @node with only one arg.

But actually, this was not enough, and I couldn't understand why on
some documents makeinfo likes me and on others it doesn't.  The answer
lies in the menus...  I'm OK to believe I'm doing wrong, but then, if
you (the team) could manage to get clearer messages...

Thanks a lot!

        Akim

---------- Menus are up to date
/tmp % cat foo.texi
\input texinfo @c -*-texinfo-*-

@node Top
@top The top

@menu
* node::
@end menu

@node node
@chapter node

@bye
/tmp % makeinfo foo.texi
/tmp %

---------- No menus, one arg to @node
/tmp % cat foo.texi
\input texinfo @c -*-texinfo-*-

@node Top
@top The top

@node node
@chapter node

@bye
/tmp % makeinfo foo.texi --force
./foo.texi:6: Le noeud «node» a un champ «Up» manquant.
./foo.texi:6: avertissement: noeud «node» non référencé.
/tmp % makeinfo foo.texi




---------- Menu is not up to date
/tmp % cat foo.texi
\input texinfo @c -*-texinfo-*-

@node Top
@top The top

@menu
* node::
@end menu

@node node
@chapter node

@node node again
@chapter another node
@bye
/tmp % LANG=C makeinfo foo.texi
./foo.texi:13: `node again' has no Up field.
./foo.texi:13: warning: unreferenced node `node again'.
makeinfo: Removing output file `foo.info' due to errors; use --force to preserve.


---------- No menus but complete @node.  This time I understand the message.
/tmp % cat foo.texi
\input texinfo @c -*-texinfo-*-

@node Top, node, (dir), (dir)
@top The top

@node node, node again, Top, Top
@chapter node

@node node again,  , node, Top
@chapter another node
@bye
/tmp % LANG=C makeinfo foo.texi
./foo.texi:3: Node `Top' lacks menu item for `node' despite being its Up target.
./foo.texi:3: Node `Top' lacks menu item for `node again' despite being its Up target.
makeinfo: Removing output file `foo.info' due to errors; use --force to preserve.

Reply via email to