bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

wrapping top node; texi2any inconsistent with texinfo manual?


From: Matt Wette
Subject: wrapping top node; texi2any inconsistent with texinfo manual?
Date: Sun, 29 Nov 2020 14:08:38 -0800
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0

Hi All,

I reported a "bug" for the ed-1.16 manual which reports the following error from tex2any:

mwette$ texi2any --pdf ed.texi
ed.texi:48: @menu seen before first @node
ed.texi:48: perhaps your @top node should be wrapped in @ifnottex rather than @ifinfo?
mwette$ texi2any --version
texi2any (GNU texinfo) 6.5

Copyright (C) 2017 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

The texi source is attached.

The response I received from a ed maintainers (see below) indicates this as an error in texi2any or texinfo documentation.

Matt


   Thanks for reporting this.

   I have verified that ed.texi since ed 0.3 seems to be implemented as
   documented in the texinfo manual[1]. Therefore this seems a bug
   either in texi2any or in the texinfo documentation.

   [1]
   
http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Top-Node-Example.html


   Given what is written in another part of the texinfo manual[2], I
   tend to think that the error is in the texinfo documentation.

   [2]
   
http://www.gnu.org/software/texinfo/manual/texinfo/html_node/The-Top-Node.html

   "The contents of the 'Top' node should appear only in the online
   output; none of it should appear in printed output, so enclose it
   between @ifnottex and @end ifnottex commands. (TeX does not print
   either an @node line or a menu; they appear only in Info".

   I'll fix this by extending the existing @ifnottex to include the
   whole Top node, and will report the problem to the Texinfo
   maintainers. Sadly the fix will not be present in ed-1.17-rc1 which
   I'll announce later today.


   Best regards,
   Antonio.

Attachment: ed.texi
Description: Text Data

Attachment: fdl.texi
Description: Text Data


reply via email to

[Prev in Thread] Current Thread [Next in Thread]