Package: perl-doc
Version: 5.10.0-13
Severity: wishlist
Hello,
Thanks for packaging perl-doc.
I noticed in the caff(1) manpage in the signing-party package that there
is a fancy new "POD ERRORS" section:
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
Around line 138:
You forgot a ’=back’ before ’=head2’
[...loads more like that...]
While I appreciate that those are errors to be corrected, the manpage
itself definitely isn't the place where to put a list of them: they
are not documentation, they are a message to the developer: the
developer, I guess, hardly reads the manpage, while the users will be
quite puzzled ad seeing things that are mostly none of their concern,
and surely not helping them in understanding the software.
Plus, the "POD ERRORS" section also shows up in man -Tps, happily and
uselessly wasting paper should anyone decide to print a manpage.
Ciao,
Enrico
-- System Information:
Debian Release: lenny/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.26-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages perl-doc depends on:
ii perl 5.10.0-13 Larry Wall's Practical Extraction
perl-doc recommends no packages.
Versions of packages perl-doc suggests:
pn groff <none> (no description available)
ii konqueror [man-browser] 4:3.5.9.dfsg.1-5 KDE's advanced file manager, web b
ii man-db [man-browser] 2.5.2-2 on-line manual pager
-- no debconf information
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
