Package: manpages-de
Version: 0.5-4.2
Severity: important
Tags: l10n

Hello,
German man pages are outdated. I just stumbled (at work) over the
option "-P" in the German man page for cp. It says "same as --parents,
soon to be changed into --no-dereference to comply with POSIX".

Well the english man page sure says:
-P, --no-dereference

Looking at the bugs this is not the only case of outdateness and I
guess comparing some "random" man pages with their English original
will yield other outdated translations.

While this in itself might be minor, two issues cause the importance:
a) There is not even a warning in the man page that it could be
   outdated and thus
b) your package "fails" policy 
      * Localized man pages should either be kept up-to-date with the
        original version or warn that they're not up-to-date, either with
        warning text or by showing missing or changed portions in the
        original language.                                        [12.1]

(Of course, policy change was made because users suffer from this,
they don't find a required option or use an incorrect option and
experience obsure bugs and might eventually give up or become rather
frustrated).

To rectify the situation, the following course of action could be used:
1) Patch *all* man pages such that they have the followin or a 
   simmilar message at the top (at the bottom of ÜBERSICHT or the top
   of BESCHREIBUNG):
   Diese Handbucheite ist u.U. veraltet. Im Zweifelsfall ziehen Sie
   die englischsprachige Handbuchseite zu Rate, indem Sie
   LC_ALL=C man cp
   eingeben.

2) Convert all man pages (step by step, I know 186 pages are a lot) to
   a format, which replaces untranslated text by the original english
   one and does not display outdated translated text.
   A possible candidate is po4a, but you might check with upstream for
   that.
   I suggest contacting the maintainer of po4a or asking on
   debian-i18n so that scripts might help you add in the previous
   translation, so ideally you would "only" need to shuffle around
   content. Still, if I randomly take 20 minutes per page for
   converting and basic sanity checking, I still end up at more than
   one week of work (full time). So this process probably should be
   spread out over time.

3) Over time, update all man pages. You might want to aks on
   debian-l10n-german for help (but I guess upstream could also
   provide some help).


-- System Information:
Debian Release: 5.0.3
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.27.10-grsec-cz03
Locale: lang=de...@euro, lc_ctype=de...@euro (charmap=UTF-8) (ignored: LC_ALL 
set to de_DE.UTF-8)
Shell: /bin/sh linked to /bin/bash

manpages-de depends on no packages.

manpages-de recommends no packages.

Versions of packages manpages-de suggests:
ii  konqueror [man-browser] 4:3.5.9.dfsg.1-6 KDE's advanced file manager, web b
ii  man-db [man-browser]    2.5.2-4          on-line manual pager
ii  manpages                3.05-1           Manual pages about using a GNU/Lin

-- no debconf information
-- 
      Dr. Helge Kreutzmann                     [email protected]
           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: Digital signature

Reply via email to