On Sun, Feb 17, 2002 at 10:59:45PM -0500, Joey Hess wrote: > Duncan Findlay wrote: > > I was wondering what the proper extensions for perl manpages are. > > > > My package, spamassassin, currently installs a lot of manpages in section 3 > > as *.3p.gz. In perl policy, it states that this should be *.3perl.gz, but > > I've also noticed a large number of packages we *.3pm.gz manpages. Could > > anyone explain what I should do, and whether all these other packages are > > deserving of bug reports? > > Hm, it seems to be nearly evenly split. I had thought .3pm was ok for > perl modules. >
But should I change from .3p to .3perl (and encourage the same upstream)? > > Also, spamassassin has 2 manpages for daemons, and these should, as I > > understand it, in section 8, since only system admins would run them. > > However, perl policy seems to indicate that only section 1 and 3 can be > > used. (I think this might have something to do with perl makefiles too.) > > Should I move the manpages to man8? > > Well perl policy says to use the standard directories. The fact that it > only bothers to list two of them does not override debian policy which > says sysadmin stuff goes in man8. Actually, I believe debian policy defers that to the FHS, which isn't particularly clear about what is section 1, and what is section 8, just gives guidelines, it seems. > MakeMaker, however, only supports man1 and man3, AFAIK. This is probably > because some of the other sections arn't present on all unices. It > shouldn't stop debian packages from doing the right thing. Alright. I will implement a nice kludge soon :-) -- Duncan Findlay -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]