Bug#686134: package descriptions incorrect, package content outdated
Package: src:manpages-pt
Version: 20040726-4
Severity: wishlist
X-Debbugs-CC: debian-l10n-english@lists.debian.org
Dear Maintainers,
as the date in the version string indicates, manpages-pt und manpages-pt-dev
are outdated. The Linux man-pages project is quite active (1), the
grouping of
the manual pages has changed (2).
Thus the descriptions of manpages-pt (3) and manpages-pt-dev (4) are
wrong as
well as the package descriptions are outdated/incorrect.
Surely the descriptions have to be updated and the content has to be
rearranged.
Description: Portuguese Versions of the Manual Pages
These are the manpages available in Portuguese
This package contains the following sections:
* 1 = User programs (e.g. ls, ln)
* 4 = Devices (e.g. hd, sd).
* 5 = File formats and protocols, syntaxes of several system
files (e.g. wtmp, /etc/passwd, nfs).
* 6 = Games etc.
* 7 = Conventions and standards, macro packages, etc.
(e.g. nroff, ascii).
The Developer's Reference does not mandate capitalization in the SD, it is
not sure that these are *all* Portuguese translations.
Description: Portuguese Versions of the Manual Pages (dev sections)
These are the manpages available in Portuguese
This package contains the following sections:
* 2 = Linux system calls.
* 3 = Libc calls (note that a more comprehensive source of
information may be found in the libc6-doc package).
* 8 = Kernel functions
Same objections here plus the change of section 8.
Please consider
Description: Portuguese manual page translations
This package contains Portuguese manual page translations from the
following sections:
* 1 = User programs (e.g. ls, ln)
* 4 = Devices (e.g. hd, sd).
* 5 = File formats and protocols, syntaxes of several system
files (e.g. wtmp, /etc/passwd, nfs).
* 6 = Games etc.
* 7 = Conventions and standards, macro packages, etc.
(e.g. nroff, ascii).
* 8 = System management commands.
Description: Portuguese manual page translations (development)
These are the manpages available in Portuguese
This package contains the following sections:
* 2 = Linux system calls.
* 3 = C library calls (note that a more comprehensive source of
information may be found in the libc6-doc package).
And there is the possible policy violation (5):
If a localized version of a manual page is provided, it should
either be
up-to-date or it should be obvious to the reader that it is
outdated and
the original manual page should be used instead. This can be done
either
by a note at the beginning of the manual page or by showing the
missing or
changed portions in the original language instead of the target
language.
It's quite easy to patch the manual pages (6).
If you consider to update the translations, I suggest starting from scratch,
using po4a to convert the manpages, creating a compendium and applying it to
the fresh PO files …
Cheers,
Martin
1: http://www.kernel.org/pub/linux/docs/man-pages/
2: man -LC man-pages
3: http://ddtp.debian.net/ddt.cgi?desc_id=9854
4: http://ddtp.debian.net/ddt.cgi?desc_id=66628
5: http://www.debian.org/doc/debian-policy/ch-docs.html#s12.1
6: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=567986#10
Reply to: