[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1107627: unblock: manpages-l10n/4.27.0-1



Package: release.debian.org
Severity: normal
X-Debbugs-Cc: manpages-l10n@packages.debian.org
Control: affects -1 + src:manpages-l10n
User: release.debian.org@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.

Recently a bad formatting error in some man pages was fixed (see 
#1107741 and 
https://salsa.debian.org/manpages-l10n-team/manpages-l10n/-/merge_requests/30)

Additionally, a file transfer from rpm-i18n was now properly done 
according to https://wiki.debian.org/PackageTransition, see #1077994.
While the upload fixing it was in progress, it was also reported against 
the version in Testing as #1108105. So this upload fixes a release 
critical bug.

Additionally, translations were updated, but only for this I would not
request the unblock.

[ Impact ]
If the unblock is *not* granted, the upgrade from Bookworm to Trixie 
will not work for users having (at least) manpages-pl and rpm-i18n
installed.

Further, then non-english speakers will see some outdated and some
barely readable (formatting) translations and some missing 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/manpages-4.26.3.-1-3_4.27.0-1_full.diff.xz

      Or a reduced (still large) version here:
      https://www.helgefjell.de/data/manpages-4.26.3.-1-3_4.27.0-1_reduced.diff.xz

      Or a very reduced version here:
      https://www.helgefjell.de/data/manpages-4.26.3.-1-3_4.27.0-1_small.diff

      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.27.0-1

-- 
      Dr. Helge Kreutzmann                     debian@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 to: