Your message dated Sun, 13 Jan 2008 21:54:56 +0100
with message-id <[EMAIL PROTECTED]>
and subject line Bug#449296: pod2man: .3pm manpages get wrong section 3
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
--- Begin Message ---
Package: perl
Version: 5.8.8-11.1
Severity: normal
Manpages with the extension 3pm will get section 3 assigned, which makes
lintian complain. Please add something to the script to assign it the
correct 3pm section.
This may be valid also for .1p manpages, but I didn't check.
Thanks!
Jan
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.22-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages perl depends on:
ii libc6 2.6.1-6 GNU C Library: Shared libraries
ii libdb4.6 4.6.21-4 Berkeley v4.6 Database Libraries [
ii libgdbm3 1.8.3-3 GNU dbm database routines (runtime
ii perl-base 5.8.8-11.1 The Pathologically Eclectic Rubbis
ii perl-modules 5.8.8-11.1 Core Perl modules
Versions of packages perl recommends:
pn perl-doc <none> (no description available)
-- no debconf information
--- End Message ---
--- Begin Message ---
The bug has been resolved within the package gwyddion 2.9-3, as it is
more or less a bug there. Anyway, I didn't reassign the bug, as
potentially affected people will probably find the solution more easily
here.
Details can be found below in the correspondence between me and Brendan
O'Dea, including the solution.
Regards,
Jan
Brendan O'Dea schrieb am 07.11.2007 1:36 Uhr:
On 06/11/2007, Jan Beyer <[EMAIL PROTECTED]> wrote:
An upstream Makefile for a software which I'm packaging (gwyddion)
simply runs pod2man over a (private) Perl module, containing inline POD
code. Maybe I'm wrong, but shouldn't pod2man better choose 3pm as
section instead of only 3?
The majority of packages used ExtUtils::MakeMaker at the time I wrote
the bit about extensions in the Perl Policy and I changed MakeMaker to
suit rather than pod2man, since I was only concerned about packages
built for Debian, not any other random use of that program.
More recently some packages have switched to Module::Build, and the
maintainer has made a similar change.
For packages like yours, I'm afraid that you're on your own, although
the change required to the makefile (as you have discovered) is a
small one.
It is actually as simple as adding the option --section="3pm" to the
call to pod2man.
Please bear with me, in case I'm totally wrong here. At the moment I
have to patch upstream's Makefile to call pod2man with --section="3pm".
Upstream doesn't want to change the Makefile.
Right. And they should not have to. The .3pm extension is a Debian
specific change, introduced primarily (as I recall) to allow the mandb
maintainer to tweak the search path so that "man open" would emit the
system call page (open(2)) rather than the perl pragma first (the
extension path is something like: 1, 3, 2, 3pm, ...).
In the perl package I carry two different classes of patches, those
which are relevant to upstream (and either come from there, or are
submitted back) and those which are Debian-specific.
An example of the latter would be replacing calls to "more" or "less"
with "sensible-pager" so as to comply with Debian policy. Not
relevant upstream.
[...] This is not followed in gwyddion, probably
because it's a private module, getting installed only in a subdirectory
of /usr/lib/gwyddion. Should I better assume, that these modules do not
have to follow the conventions for pure Perl vendor modules?
That would result in me putting a lintian override and not patching
upstreams Makefile.
As noted above, the reason for requiring .3pm rather than .3 is so
that manual pages are produced as expected.
If the manual page names don't shadow any system calls (section 2),
then it's probably not so important.
As you say, you could either patch the Makefile, or add an override.
I would be inclined to do the former, but use your own judgement in
the matter.
Sorry, if I have been wrong filing this bug. (A weak explanation is,
that this is my first Debian packagaging attempt...)
You're not wrong, it's a reasonable question. I believe however that
you should probably fix the issue in your package as described above.
When you do so, please add a "Closes: #449296" line in your changelog
to resolve this bug.
--bod
--- End Message ---
