[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.
ed.texi
Description: Text Data
fdl.texi
Description: Text Data
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- wrapping top node; texi2any inconsistent with texinfo manual?,
Matt Wette <=