Bug#989029: info: scroll-backward is buggy

[Vincent Lefevre]

Control: retitle -1 gnuplot-doc: the list of terminals is absent from the info manual, also breaking navigation
Control: severity -1 important
Control: tags -1 - wontfix

The wontfix tag had to be removed...

The main issue is actually that the list of terminals is absent
from the info manual (the HTML and PDF manuals seem OK), which
makes the info manual *very* incomplete (this part is about 20%
of the PDF manual) as there are many options specific to
terminals, which are thus not documented; and in

  4.1 complete list of terminals

this list has been replaced by "Bugs::" in the menu, which also
breaks navigation, as explained below.

Moreover, due to the absent list of terminals, the terminal index
is obviously empty.

I suspect a bug in doc2texi.el, which generates the gnuplot.texi
file, from which the info manual is built by texinfo. More
precisely, the inclusion of the .trm files is buggy.

On 2022-11-22 10:34:26 +0100, Hilmar Preuße wrote:
> Control: reassign -1 gnuplot-doc
> 
> Am 24.05.2021 um 01:36 teilte Vincent Lefevre mit:
> 
> Hello,
> 
> as discussed in that bug the issue seems only to occur w/ gnuplot-doc so
> the issue is specific to the gnuplot documentation. Please be so kind to
> have a look at the issue.
> 
> Hilmar
> 
> > The info manual says:
> > 
> > <DEL> ('scroll-backward')
> > <PREVIOUS>
> >       Shift the text in this window down.  The inverse of
> >       'scroll-forward'.  If you are at the start of a node, <DEL> takes
> >       you to the "previous" node, so that you can read an entire manual
> >       from finish to start by repeating <DEL>.  The default scroll size
> >       can be changed by invoking the
> >       ('scroll-backward-page-only-set-window') command with a numeric
> >       argument.
> > [...]
> > 
> > But this doesn't behave like that in the gnuplot manual from the
> > gnuplot-doc 5.4.1+dfsg1-1 Debian package: Go to "Bugs". This gives
> > 
> > ------------------------------------------------------------
> > 5 Bugs
> > ******
> > 
> > Please e-mail bug reports to the gnuplot-bugs mailing list or upload the
> > report to the gnuplot web site on SourceForge.  Please give complete
> > information on the version of gnuplot you are using and, if possible, a
> > test script that demonstrates the bug.  See 'seeking-assistance'.
> > 
> > * Menu:
> > 
> > * known_limitations::
> > * External_libraries::
> > ------------------------------------------------------------
> > 
> > Then do a scroll-backward (with the Backspace or PageUp key).
> > This gives:
> > 
> > ------------------------------------------------------------
> > 5.2 External libraries
> > ======================
> > [...]
> > ------------------------------------------------------------
> > 
> > which is not the "previous" node, but some later node.

The issue comes from the fact that

  4.1 complete list of terminals

has "Bugs::" in the menu, while the "Bugs" node is not a child of
this node ("Bugs" is Section 5, not Section 4.1.x). This is not
supported by "info".

-- 
Vincent Lefèvre <vincent at vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)