Package: debhelper
Version: 13.9.1
Severity: wishlist

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hi, would it be possible for dh_installdocs to support installation of files in
subdirectories of the documentation directory?

This can be necessary in cases where, for example, an HTML file references some
images in a relative path like docs/images/.

Take this package.docs file for example:

    README.html
    docs/images/*.png
    docs/images/*.svg

The installed README.html file will point to nonexistent paths, as images will
get installed in /usr/share/doc/package/ instead of
/usr/share/doc/package/docs/images/.

What I suggest is extending the .docs format in a way similar to .install
files, but only allowing paths relative to the documentation directory. The
previous example would be converted to this:

    README.html
    docs/images/*.png docs/images/
    docs/images/*.svg docs/images/

I'm currently working around this by installing the images in a .install file,
but those do not honour the nodoc build profile; I also dislike having to
separate the same logical concept in two different places.

Thanks for your work on debhelper!


- -- System Information:
Debian Release: bookworm/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.19.0-1-amd64 (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_WARN, TAINT_OOT_MODULE, 
TAINT_UNSIGNED_MODULE
Locale: LANG=it_IT.UTF-8, LC_CTYPE=it_IT.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages debhelper depends on:
ii  autotools-dev            20220109.1
ii  dh-autoreconf            20
ii  dh-strip-nondeterminism  1.13.0-1
ii  dpkg                     1.21.9
ii  dpkg-dev                 1.21.9
ii  dwz                      0.14-1
ii  file                     1:5.41-4
ii  libdebhelper-perl        13.9.1
ii  libdpkg-perl             1.21.9
ii  man-db                   2.10.2-3
ii  perl                     5.34.0-5
ii  po-debconf               1.0.21+nmu1

debhelper recommends no packages.

Versions of packages debhelper suggests:
pn  dh-make  <none>

- -- no debconf information

-----BEGIN PGP SIGNATURE-----

iIoEARYIADIWIQS6VuNIvZRFHt7JcAdKkgiiRVB3pwUCYy8dOBQcYW5kcmVhQHBh
cHBhY29kYS5pdAAKCRBKkgiiRVB3p8JMAP9JWPqnVM5sD5lfK/ov/dA3p0xcqJHJ
1s9N8fwXincDKQD/UT4orF4yTuTvk8Wa/51Qm8fu4bFBleuz/LdjY6PYEwo=
=V9XP
-----END PGP SIGNATURE-----

Reply via email to