Dear Maintainer,

As I'm sure you know, when the "texinfo" package is installed, it creates
`/usr/share/info/texinfo.info.gz`, and a metadata chunk from the preamble of
that file is merged into `/usr/share/info/dir`.

For texinfo specifically, the metadata chunk includes the following line:

    * pod2texi: (pod2texi)Invoking pod2texi.

As I understand it, this is a hyperlink to the node named "Invoking pod2texi"
inside the "pod2texi" info file. Unfortunately, there is no such info file.

There *is* an "Invoking pod2texi" node in the "texinfo" info file, but it does
not actually describe invoking pod2texi. Instead, it explains that pod2texi is
a demonstration of itself, being a Perl script with POD documentation, so you
can get a TeXinfo file by running:

    pod2texi $(which pod2texi)

The actual content of the pod2texi documentation can be read at
http://www.gnu.org/software/texinfo/manual/pod2texi.html or (in Debian) via
`man pod2texi`, but follows manpage conventions and doesn't contain an
"Invoking pod2texi" section.

Probably the easiest fix is just to remove that line from the texinfo.info
metadata chunk, since `/usr/bin/info` and similar tools fall back to looking up
a manpage if there's no info reference, so `info pod2texi` will give people the
information they want instead of an error message.

The second easiest fix would be to change "(pod2texi)" in the link to
"(texinfo)", and then "info pod2texi" would take you to the intended node...
although since that node says "go look elsewhere for documentation" that
wouldn't be very helpful.

The most complete fix would be to use `pod2texi` to generate a `pod2texi.texi`
file, and then a `pod2texi.info` file that could be installed, and change the
link to be `(pod2texi).` (linking to the Top node of the manual). However, the
experience of browsing a manpage-style document in Info style (one node per
menu) is... not convenient, and this would basically make texinfo a build-time
dependency on itself, which is kind of a mess, so maybe this isn't such a great
idea.

Am 10.06.2022 um 11:29 teilte Timothy Allen mit:

Dear Timothy,
I've uploaded texinfo 7.0.1-3 to Debian experimental. Could you install
it and check if it solves the issue? Thanks!

Hilmar
--
sigfault

I downloaded the texinfo and texinfo-lib packages from the experimental
repository and installed them. The issue is not solved:

  - /usr/share/info/dir still mentions "(pod2texi)Invoking pod2texi."
  - /usr/share/info/texinfo.info.gz still includes that link in its
    START-INFO-DIR-ENTRY section.
  - There's still no /usr/share/info/pod2texi.info(.gz) file

Thank you for your packaging work!

Tim.