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!