On Sun, Sep 25, 2022 at 07:18:38PM +0200, Helge Kreutzmann wrote:
> Now let's take a different example, namely systemd-importd.service
> and systemd-importd.
> 
> Again manpages-de ships only one file, i.e.
> /usr/share/man/de/man8/systemd-importd.service.8.gz
> 
> With 
> man systemd-importd.service
> I'm able to read the German version, however, with
> man systemd-importd
> I get the english version (which exists on my system, different from
> the previous example).
> 
> If I manually enter (as root)
> ln -s /usr/share/man/de/man8/systemd-importd.service.8.gz 
> /usr/share/man/de/man8/systemd-importd.8.gz
> then it works as intended, i.e. I get the German page in both cases.
> 
> For information:
> helge@twentytwo:/usr/share/man/de/man8$ lexgrog nss-myhostname.8.gz
> nss-myhostname.8.gz: "nss-myhostname - Rechnernamenauflösung für die lokal 
> konfigurierten Systemrechnernamen"
> nss-myhostname.8.gz: "libnss_myhostname.so.2 - Rechnernamenauflösung für die 
> lokal konfigurierten Systemrechnernamen"
> 
> helge@twentytwo:/usr/share/man/de/man8$ lexgrog systemd-importd.service.8.gz
> systemd-importd.service.8.gz: "systemd-importd.service - VM- und 
> Container-Abbild-Import und -Exportdienst"
> systemd-importd.service.8.gz: "systemd-importd - VM- und 
> Container-Abbild-Import und -Exportdienst"
> 
> Thus for the English → English man page the alias system works, but it
> does not work for German → German, if the English exists. If it does
> not exist, then it works.

Please add the --debug option to the man(1) invocations that don't work
as expected, and attach the output to this bug.

> I really would like to avoid adding tons of links in manpages-l10n for
> each man page with aliases and each translation (we do ship quite a
> few man pages and translations). 

While I understand this, please note section 12.1 of the Debian Policy
Manual:

  If you do not create any links (whether symlinks, hard links, or .so
  directives) in the file system to the alternate names of the man page,
  then you should not rely on man finding your man page under those
  names based solely on the information in the man page's header.

The arrangements to make things work without symlinks are extremely
complicated and fragile.  If that's what's going on here, then I would
implore you to rethink and add the symlinks (perhaps it could be
automated in your build system without too much trouble).

-- 
Colin Watson (he/him)                              [[email protected]]

Reply via email to