Re: Strange behaviour while building the libcvs-perl package
Ivo Marino dijo [Thu, Aug 25, 2005 at 11:38:51PM +0200]:
> Hello `Debian-Perl folks`,
>
> Recently I've packaged a new Debian package called libcvs-perl[1], it is
> available, as source package, on MDN (mentors.debian.net)[2].
>
> The package builds fine on my Debian testing system but returns some
> problems on pure and chrooted (pbuilder) sid systems.
>
> The problem regards the Perl make test process which fails on the so
> called "t/90release" test -- The strange thing is that this test fails
> _only_ during the first building process of the package, if I rebuild
> the package without cleaning the source tree the test passes
> successfully and the package builds completely.
Hmmm... On my just-updated Sid chroot:
# pbuilder build libcvs-perl_0.07-1.dsc
(...)
t/00checkout....ok
t/05commit......ok
t/10status......ok
t/20tag.........ok
t/21rtag........ok
t/30update......ok
t/40diff........ok
t/50export......ok
t/90release.....ok
All tests successful.
I built your package a couple of times, trying to note if there is a
difference between it before and after building (that is, if the clean
target does not really clean everything up), and I found nothing.
I didn't thoroughly check your package - I cannot say it is ready for
uploading in Debian. In fact, lintian is quite loud about possible
improvements:
$ lintian -i result/libcvs-perl_0.07-1_all.deb
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Checkout.3pm.gz
N:
N: Each manual page should start with a `NAME' section, which lists the
N: name and a brief description of the page seperated by '\-'. These
N: sections are parsed by `mandb' and stored in a database for the use of
N: `apropos' and `whatis', so they must be in a certain format. This
N: manual page apparently uses the wrong format and cannot be parsed by
N: `mandb'.
N:
N: For information on how `NAME' sections should be written see
N: lexgrog(1). See also groff_man(7) and groff_mdoc(7) for general
N: information on writing manual pages.
N:
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Tag.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Login.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Release.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Rdiff.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Base.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Export.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Logout.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Update.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Result::Base.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Rtag.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Cvsroot.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Result::Login.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Result::Export.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Result::Checkout.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Result::Logout.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Diff.3pm.gz
W: libcvs-perl: manpage-has-bad-whatis-entry usr/share/man/man3/Cvs::Command::Status.3pm.gz
Fix them. For what I see, many (I don't know if all) of those modules
contain the license informaation in POD, with no useful documentation
- They don't need, IMHO, documentation, as they are internal-use
modules, not to be called directly from the outside. Just specify in
the MAN3PODS section of the Makefile.PL (see the ExtUtils::MakeMaker
man page) which manpages you _do_ want to generate, and you should be
set.
Greetings!
--
Gunnar Wolf - gwolf@gwolf.org - (+52-55)1451-2244 / 5623-0154
PGP key 1024D/8BB527AF 2001-10-23
Fingerprint: 0C79 D2D1 2C4E 9CE4 5973 F800 D80E F35A 8BB5 27AF
Reply to: