Bug#467444: libpdf-api2-perl: PDF::API2::Outline.3pm and PDF::API2::Page.3pm are broken

[Vincent Fourmond]

Package: libpdf-api2-perl
Version: 0.69-1
Severity: minor


  Hello,

  mandb's crontab complains thus:

/etc/cron.daily/man-db:
/usr/bin/mandb: warning: whatis for PDF::API2::Page.3pm.gz exceeds 2048 bytes, truncating.
/usr/bin/mandb: warning: whatis for PDF::API2::Outline.3pm.gz exceeds 2048 bytes, truncating.

  Looking at those manual pages, it appears that they are broken, see:

[...]

.SH "NAME"
PDF::API2::Outline \- outline management
.ie n .SH "$otl = PDF::API2::Outline\->new $api,$parent,$prev"
    ^ ^^^
    1 2

1 should not be here
2 should be at the beginning of a line.

  It is likely that the other manual pages are also broken this way: for 
instance:

~ whatis PDF::API2::Resource
PDF::API2::Resource (3pm) - - generic PDF::API2 resource class n .SH "$res = PDF::API2::Resource->new $pdf,...

  They only don't trigger the problem because their text is less long.

  I'm unsure whether this is a bug in the structure of the original pages or if
it is a pod2man problem.

  Regards,

	Vincent Fourmond


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.24-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages libpdf-api2-perl depends on:
ii  libcompress-zlib-perl         2.008-1    Perl module for creation and manip
ii  perl                          5.8.8-12   Larry Wall's Practical Extraction 
ii  ttf-dejavu                    2.23-1     Metapackage to pull in ttf-dejavu-

libpdf-api2-perl recommends no packages.

-- no debconf information