Tomas Krizek <tomas.krizek(a)nic.cz> writes:
When I was trying to package the info files, I noticed
older texinfo
doesn't generate knot-resolver-figures directory and places the images
directly in the output directory.
It wouldn't be Texinfo doing that; it's Sphinx itself that creates that
subfolder and places the images there (and the subfolder's name in the
@image tags it outputs). This follows the advice in the Texinfo manual,
which says[0]
If you want to install image files for use by Info readers too, we
recommend putting them in a subdirectory like ‘foo-figures’ for a
package foo.
Isn't that something install-info could take care
of? I saw this issue
on Debian 10, for example.
Unfortunately I don't know much about Debian, and neither their Policy
Manual[1] nor their New Maintainer's Guide[2] says anything about images
when discussing how Info documents should be handled.
Apparently though Debian provides a dh_installinfo[3] tool that's meant
to install Info documents contained in packages. Does it not do the
right thing with regard to images?
At any rate, install-info's primary purpose seems to be updating the
system's Info directory. It wouldn't be the right tool for managing
image links and whatnot.
Are the figures even important for info documentation?
Could we install
just knot-resolver.info to simplify things?
Well, maybe, but then the info manual would contain references to images
that don't exist on the system. And the images _do_ display in Emacs
(and perhaps other Info readers), so it would be nice to have them there
for parity with the HTML manual.
[0]
https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Image-Syntax.…
[1]
https://www.debian.org/doc/debian-policy/ch-docs.html#info-documents
[2]
https://www.debian.org/doc/manuals/maint-guide/dother.en.html#info
[3]
https://manpages.debian.org/buster/debhelper/dh_installinfo.1.en.html
--
Simon South
simon(a)simonsouth.net