Package: ganeti Version: 3.0.2-3 Severity: wishlist Hello!
I've recently tried to read the ganeti man pages on manpages.debian.org but found out that all of the man pages give out a 404 error there. According to https://github.com/Debian/debiman/issues/177 this problem happens in debiman specifically for the ganeti package because the files inside /usr/share/man/man[1-9]/ are symlinks to other files. The links end up following a pretty convoluted strings of symlinks through /etc/ganeti and back to /usr/share/ganeti/$version/, which are in the ganeti-$version package. If I understand the situation correctly, the manpages are organized this way so that it's possible to have documentation for multiple versions of ganeti installed simultaneously, especially during version upgrades. I wonder if there could be a way to organize things in a way that would better accomodate debiman? It seems that the crux of the issue is that the symlinks pass through /etc/ganeti/share which is not apart of the ganeti-$version pacakge. I don't know if this is an interesting technique for this specific package, but I took a quick peek at how php achieves having different versions of man pages and from what I can see, they use the alternatives system for this, so for example /usr/share/man/man1/php.1.gz is a symlink to /etc/alternatives/php.1.gz and in turn that links to the current version of the file. Could that be a useful trick for ganeti? Cheers! -- System Information: Debian Release: trixie/sid APT prefers unstable APT policy: (500, 'unstable'), (1, 'experimental') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 6.10.4-amd64 (SMP w/16 CPU threads; PREEMPT) Kernel taint flags: TAINT_WARN Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_CA.utf8), LANGUAGE not set Shell: /bin/sh linked to /usr/bin/dash Init: systemd (via /run/systemd/system) LSM: AppArmor: enabled Versions of packages ganeti depends on: ii adduser 3.137 pn ganeti-3.0 <none> pn ganeti-haskell-3.0 <none> pn ganeti-htools-3.0 <none> ii init-system-helpers 1.66 ii python3 3.12.5-1 ii sysvinit-utils [lsb-base] 3.10-1 Versions of packages ganeti recommends: pn drbd-utils | drbd8-utils <none> ii fdisk 2.40.2-6 pn ganeti-instance-debootstrap <none> pn ndisc6 <none> ii qemu-system-x86 [qemu-kvm] 1:9.0.2+ds-4 Versions of packages ganeti suggests: pn blktap-dkms <none> pn ganeti-doc <none> pn molly-guard <none>