Package: pod2pdf
Version: 0.42-1
Severity: minor
Tags: patch
The short description line claims that pod2pdf provides a
converts Perl Old Documentation to PDF format
This synopsis has a couple of problems.
* There's no such thing as Perl Old Documentation. Obviously you
mean (Perl's) Plain Old Documentation format.
* It's a verb phrase. The DevRef6.2.2-compliant format is a noun
phrase (something that fits the above "provides a..." template).
* (Severity level "pedantic") PDF format is a PIN-numberism -
"Portable Document Format format". Why not just expand it?
My patch changes it to
Plain Old Documentation to Portable Document Format converter
Your long description is fine (never mind my urge to fiddle with the
commas), but has a single minor typo: "lingua fraca".
Thanks for packaging pod2pdf!
-- System Information:
Debian Release: squeeze/sid
APT prefers testing
APT policy: (500, 'testing'), (50, 'unstable')
Architecture: i386 (i586)
Kernel: Linux 2.6.30.custom
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages pod2pdf depends on:
ii libgetopt-argvfile-perl 1.11-1 Perl module for reading script opt
ii libpdf-api2-perl 0.73-1 module for creating or modifying P
ii perl 5.10.0-24 Larry Wall's Practical Extraction
ii perl-modules 5.10.0-24 Core Perl modules
Versions of packages pod2pdf recommends:
ii libfile-type-perl 0.22-1.1 determine file type using magic st
ii libimage-size-perl 3.2-1 determine the size of images in se
pod2pdf suggests no packages.
-- no debconf information
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ur pod2pdf-0.42.pristine/debian/control pod2pdf-0.42/debian/control
--- pod2pdf-0.42.pristine/debian/control 2009-08-11 14:41:50.000000000 +0100
+++ pod2pdf-0.42/debian/control 2009-08-11 14:44:03.000000000 +0100
@@ -14,7 +14,7 @@
Depends: ${perl:Depends}, ${misc:Depends}, perl-modules,
libpdf-api2-perl (>= 0.6), libgetopt-argvfile-perl
Recommends: libimage-size-perl, libfile-type-perl
-Description: converts Perl Old Documentation to PDF format
+Description: Plain Old Documentation to Portable Document Format converter
POD allows for the documentation of Perl code, but with
a few tricks, e.g. when disguised as comments, it is
applicable to many other languages, too. It resembles
@@ -27,8 +27,7 @@
to PostScript and from there via ps2pdf to PDF.
Its major advantage lies in the inclusion of images
for the documentation. This renders POD suitable for
- many smallish projects as a lingua fraca for their
+ many smallish projects as a lingua franca for their
documentation - associated with the source and separate
documents - so texts (and graphics) can be shared more
easily between documenters and programmers.
-
