Package: release.debian.org
Severity: normal
X-Debbugs-Cc: manpages-l...@packages.debian.org
Control: affects -1 + src:manpages-l10n
User: release.debian....@packages.debian.org
Usertags: unblock

Please unblock package manpages-l10n

[ Reason ]
manpages-l10n is a (set of) pure documentation packages. It works by
downloading the current version of the man pages from the target
distribution (here Debian) related to ~ 100 upstream packages. Then
the translators update the translations of theses man pages.

To be current, this process needs to be performed as late as possible,
so that man pages within Debian change as little as possible in this
time frame, i.e. the latest version scheduled for Trixie are used.

Thus the latest release (and upload to Debian) was synced to be just
before the hard freeze with an approximate 2 weeks window for the
final translation updates.

[ Impact ]
If the unblock is *not* granted then non-english speakers will see
some outdated translations and some missing translations. Especially
for less maintained languages the difference is bigger as upstream
works hard to keep the translations shipped by performing trivial
unfuzzy and translations. But also active teams like french, romanian,
polish and german are constantily improving the translations.

[ Tests ]
Firstly, upstream man pages features a CI/DI pipeline, which already
checks for some errors.

Secondly, of all the entire man pages are build daily in a private build
setting (automatically), uncovering syntax errors. Closer to the
release, additional manually initiated builds are added. All builds
are reviewed for (potential) errors.

Thirdly, the Debian build system (full builds done locally!) also
uncovers potential problems, like missing files or directories.

Fourthly, linitian checks the entire set of man pages for errors. These
linitian errors are mostly harmless, but regularly reviewed as well
(and fixed, if possible with reasonable effort).

Finally, some random man pages are manually reviewed. However, for
languages I don't speak (most of them) this is of limited value.

Additionally, I read the upstream git log and sometimes run a git diff
if I suspect suspicious changes and interact with most of the
translators on them.

I'd love to add non superficial auto packaging tests, I'm just a
little bit lost which make sense.

[ Risks ]
The risk is low. This is pure documentation. The new packages are a
little bit larger than the old ones on average, but no programm/code
works differently because of them. It is also a leaf package and the
user can decide to read the english original at any time, e.g. by
running

LC_ALL=C man command

As the set of actual Debian (upstream) packages we translate was not
changed sind the last version, changes for new undetected file conflicts
are very low. In the higly unlikey case something would be discovered,
I can quickly exclude those files and prepare another upload. However,
this is not expected at all.

[ Checklist ]
  [x] all changes are documented in the d/changelog
  [x] I reviewed all changes and I approve them
      See above, the content (translation) I cannot actually review,
      as I don't speak Danish, Hungarian, French, Swedish, …
  [x] attach debdiff against the package in testing

      You can pick up the full debdiff here:
      https://www.helgefjell.de/data/fulldiff.xz

      Or a reduced (still large) version here:
      https://www.helgefjell.de/data/nopoorigdiff.xz

      Or a very reduced version here:
      https://www.helgefjell.de/data/tinydiff

      The two smaller ones exclude the actual translation part 
      (po files, man pages) but give you an idea about the changes 
      which happend.

Do not hesitate to contact me for any question regarding the update,
e.g. if the above description is too brief or you need a different diff.

unblock manpages-l10n/4.26.2-1

-- 
      Dr. Helge Kreutzmann                     deb...@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

Attachment: signature.asc
Description: PGP signature

Reply via email to