Hi,

Recently I am attempting to enable shipping docs of the racket-mode
package[1].  However, its info page contains links to image files
(e.g. [2]) using the image syntax[3].  If I simply handle the image
files like the *.info files using debian/<package>.info, install-info
will treat those files as info files and emit warnings, and lintian is
not happy either.  I don't see suggestions in the Policy manual
regarding how images should be handled[4].  I am currently thinking of 2
ways to handle this situation:

* Put the image files in another directory (either
  /usr/share/doc/<package>/, or /usr/share/info/<package>-figures/ as
  suggested by [3]), and patch the path in the texi source.

* Just put them together under /usr/share/info/, ignore the install-info
  warnings, and add lintian-overrides.

As linking images may become more popular over time, I wonder whether
debhelper want to handle such case in a more uniform way, and I'd like
to experiment with the suggestions.  It would be even better if there is
a solution acceptable upstream so that I don't need to carry a patch.

Thanks in advance!

[1] https://salsa.debian.org/emacsen-team/racket-mode
[2] 
https://salsa.debian.org/emacsen-team/racket-mode/-/blob/master/doc/racket-mode.texi?ref_type=heads#L888
[3] 
https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Image-Syntax.html
[4] https://www.debian.org/doc/debian-policy/ch-docs.html#info-documents

-- 
Regards,
Xiyue Deng

Attachment: signature.asc
Description: PGP signature

Reply via email to