- Package:
- developers-reference
- Source:
- developers-reference
- Submitter:
- Jonathan Dowland
- Date:
- 2026-07-08 06:21:01 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
Hi, Thanks to Holger. I now see it is easy. Basically add a few lines to Makefile can fix this. Let me do a few chores before uploading. Regards, Osamu
Hi, Thanks to Holger. I now see it is easy. Basically add a few lines to Makefile can fix this. Let me do a few chores before uploading. Regards, Osamu
We believe that the bug you reported is fixed in the latest version of debian-reference, which is due to be installed in the Debian FTP archive. A summary of the changes between this version and the previous one is attached. Thank you for reporting the bug, which will now be closed. If you have further comments please address them to 1129004@bugs.debian.org, and the maintainer will reopen the bug report if appropriate. Debian distribution maintenance software pp. Osamu Aoki <osamu@debian.org> (supplier of updated debian-reference package) (This message was generated automatically at their request; if you believe that there is a problem with it please contact the archive administrators by mailing ftpmaster@ftp-master.debian.org) Format: 1.8 Date: Wed, 08 Jul 2026 14:17:30 +0900 Source: debian-reference Architecture: source Version: 2.142 Distribution: unstable Urgency: medium Maintainer: Osamu Aoki <osamu@debian.org> Changed-By: Osamu Aoki <osamu@debian.org> Closes: 1129004 Changes: debian-reference (2.142) unstable; urgency=medium . [ Libre ] * Translated using Weblate (Spanish) . [ Andika Triwidada ] * Translated using Weblate (Indonesian) . [ Osamu Aoki ] * Add manpage URL (Closes: #1129004) * Change xdu(1x) to xdu(1) * make po Checksums-Sha1: b07fd6b9b725802ea06382e2f59dea6c58f04ab8 3214 debian-reference_2.142.dsc f4fa1933bc19db49b83e978bb84eaee20419bafa 2540116 debian-reference_2.142.tar.xz Checksums-Sha256: 2edc56dad7c7d799e07cd99623016670cb9692fd537f38364134365171406c78 3214 debian-reference_2.142.dsc 1a1ff18536d6805ee67d4dec17d647558ea3f3e2f799a8299c45d79448c3ddb9 2540116 debian-reference_2.142.tar.xz Files: 7759a0aef2aa33b751dded17698a1fdf 3214 doc optional debian-reference_2.142.dsc 5649bf92137e76fd3610e3c9d3f4b32d 2540116 doc optional debian-reference_2.142.tar.xz -----BEGIN PGP SIGNATURE----- iQJFBAEBCgAvFiEEMTNyTWIHiBV56V1iHhNWiB3Y15EFAmpN5W8RHG9zYW11QGRl Ymlhbi5vcmcACgkQHhNWiB3Y15HtchAAwQzBda3BrTZilZMpKP0I7MKoKkXA3bhB thmMc1zJ+0J7/m93yBe35lhb0nourBs8anT6fJpF2ZiutrJ1q54AzBQPIuXsaQ1e vLEWrormOd+Z8rOcpjGuqILSwkwSt/ieCaXchQUMqdXXn19I68qn95haeQ2p9Am5 ak8WIENSD661gJnskQqDAPnYwgpf/HFqbaY4dvMXWxgDAC7fclXp+Xex90k+DQ4P 8bkjd77XmAy84bUiFGhvGwEWvojn49fsP56Z9Vfdtq2qhYpg76n+4EipWgsLmgjL zrlQeUwQiMh4pQYPS3dGds5RETvVQ1ni73yRVD+tnfgS8MfnONVpcZKX0lIcBCKo JwjsNtboGADZzwDSEqvjTYDrciPVRXnrHp5WQQZ+HGAl5o4aJSEEs84fhEHztDW+ YeZmg6m3uCozSkDSHao/5OXwocgB2CRquZPq66G5ZnuuUAh84fRvu6fOmt9HmB5O LPpiGOsaw+DggMzMqtRsg3pNITwFoSv5hYs9b2k49KJW3BMK/IgCFQ+yVxaVs7BR v0h9oPK4wQAiHo2Jiup0hlCOYXKoEk1+kGBhEN5tB1l2m3jJzTMKbrvo9gtwVAsV 9iBUrdX+kuSK+ovvYCc6UTOeYa0FAxZ5NKyMZ7JT59mhc5M6EgTUfDMH9uxduCWa A59kRQ7z2vA= =bMsg -----END PGP SIGNATURE-----