- Package:
- developers-reference
- Source:
- developers-reference
- Submitter:
- Jonathan Dowland
- Date:
- 2026-06-26 15:49:02 UTC
- Severity:
- normal
- Tags:
E.g., quoting <https://www.debian.org/doc/manuals/debian-reference/ch05.en.html>: It would be very useful for `systemd-networkd(8)` there to hyperlink to <https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html>
control: tags -1 + help thanks agreed & thanks for the bug report!
Hi, This is an Interesting proposal which require good thought over how to be implemented. * URL choice: - https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html (proposed ) - https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html [1] (more stable over release) *Changing English XML directly for all manpage references is a very cumbersome task and breaks translation. - adding such links using script without changing English original RAWXML files is the desirable implementation. FROM: <literal>systemd-networkd</literal>(8) TO: <ulink url="https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html">?? ???(?) </ulink> Challenge: it is non-trivial to identify package name "systemd" here from the English text. $ apt-file find systemd-networkd.8 manpages-de: /usr/share/man/de/man8/systemd-networkd.8.gz systemd: /usr/share/man/man8/systemd-networkd.8.gz I suppose skip all manpages-?? packages as Since I don't want to break existing translation, I am not going to manually edit English text and wait until someone create such fillter. TASKS to do: * extranct candidates for manpages * identify paclage name for each manpage * replace matching part just before building HTML etc. Osamu [1] https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html
Hi, This is an Interesting proposal which require good thought over how to be implemented. * URL choice: - https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html (proposed ) - https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html [1] (more stable over release) *Changing English XML directly for all manpage references is a very cumbersome task and breaks translation. - adding such links using script without changing English original RAWXML files is the desirable implementation. FROM: <literal>systemd-networkd</literal>(8) TO: <ulink url="https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html">?? ???(?) </ulink> Challenge: it is non-trivial to identify package name "systemd" here from the English text. $ apt-file find systemd-networkd.8 manpages-de: /usr/share/man/de/man8/systemd-networkd.8.gz systemd: /usr/share/man/man8/systemd-networkd.8.gz I suppose skip all manpages-?? packages as Since I don't want to break existing translation, I am not going to manually edit English text and wait until someone create such fillter. TASKS to do: * extranct candidates for manpages * identify paclage name for each manpage * replace matching part just before building HTML etc. Osamu [1] https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html
Hi Osamu, Osamu Aoki <osamu@debian.org> wrote (Wed, 24 Jun 2026 14:08:02 +0900): https://manpages.debian.org/stable/systemd/systemd-networkd.8.en.html That will redirect you to the trixie page: https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html So that's as solid over releases as the unstable variant. There is no need to determine the package name. Just link to https://manpages.debian.org/unstable/systemd-networkd(8) and it will auto-magically redirect you to https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html ;-) We also do this in the Debian release-notes exactly like this BTW. see above. no need for this second task. Holger
Hi Osamu, Osamu Aoki <osamu@debian.org> wrote (Wed, 24 Jun 2026 14:08:02 +0900): https://manpages.debian.org/stable/systemd/systemd-networkd.8.en.html That will redirect you to the trixie page: https://manpages.debian.org/trixie/systemd/systemd-networkd.8.en.html So that's as solid over releases as the unstable variant. There is no need to determine the package name. Just link to https://manpages.debian.org/unstable/systemd-networkd(8) and it will auto-magically redirect you to https://manpages.debian.org/unstable/systemd/systemd-networkd.8.en.html ;-) We also do this in the Debian release-notes exactly like this BTW. see above. no need for this second task. Holger