#630779 perl: wrong default installsite path for man pages

Package:
perl
Source:
perl
Description:
Larry Wall's Practical Extraction and Report Language
Submitter:
Vincent Lefevre
Date:
2011-08-20 22:33:03 UTC
Severity:
minor
#630779#5
Date:
2011-06-17 09:39:24 UTC
From:
To:
The generated Makefile for Math-MPFR-3.0 contains:

INSTALLMAN1DIR = $(PERLPREFIX)/share/man/man1
DESTINSTALLMAN1DIR = $(DESTDIR)$(INSTALLMAN1DIR)
INSTALLSITEMAN1DIR = $(SITEPREFIX)/man/man1
DESTINSTALLSITEMAN1DIR = $(DESTDIR)$(INSTALLSITEMAN1DIR)
INSTALLVENDORMAN1DIR = $(VENDORPREFIX)/share/man/man1
DESTINSTALLVENDORMAN1DIR = $(DESTDIR)$(INSTALLVENDORMAN1DIR)
INSTALLMAN3DIR = $(PERLPREFIX)/share/man/man3
DESTINSTALLMAN3DIR = $(DESTDIR)$(INSTALLMAN3DIR)
INSTALLSITEMAN3DIR = $(SITEPREFIX)/man/man3
DESTINSTALLSITEMAN3DIR = $(DESTDIR)$(INSTALLSITEMAN3DIR)
INSTALLVENDORMAN3DIR = $(VENDORPREFIX)/share/man/man3
DESTINSTALLVENDORMAN3DIR = $(DESTDIR)$(INSTALLVENDORMAN3DIR)

The INSTALLSITE* variables are incorrect:

INSTALLSITEMAN1DIR = $(SITEPREFIX)/man/man1
INSTALLSITEMAN3DIR = $(SITEPREFIX)/man/man3

They should be:

INSTALLSITEMAN1DIR = $(SITEPREFIX)/share/man/man1
INSTALLSITEMAN3DIR = $(SITEPREFIX)/share/man/man3

(with "share") to be consistent with other tools, such as the
autotools.

Similarly,

$ perl '-V:install.*man.*'
installman1dir='/usr/share/man/man1';
installman3dir='/usr/share/man/man3';
installsiteman1dir='/usr/local/man/man1';
installsiteman3dir='/usr/local/man/man3';
installvendorman1dir='/usr/share/man/man1';
installvendorman3dir='/usr/share/man/man3';

though this isn't really an error since the FHS says that
"/usr/local/share/man and /usr/local/man directories must
be synonomous".
#630779#14
Date:
2011-08-20 15:31:00 UTC
From:
To:
severity 630779 minor
thanks

On Fri, Jun 17, 2011 at 11:39:24AM +0200, Vincent Lefevre wrote:

[ExtUtils::MakeMaker Makefiles]

It's not clear whether your last comment is intended to refer to both
examples you give, although I don't see why it shouldn't apply to both.

If so, I'm not convinced that there is a justification for making the
change.

Cheers,
Dominic.
#630779#21
Date:
2011-08-20 22:25:47 UTC
From:
To:
My last comment refers only to the second example. AFAIK, the FHS
says nothing like that for the other prefixes. /usr/local is a
standard prefix, so that the symlink could be added when the system
is installed. But this is not true for other prefixes like the user's
home directory.

Moreover /usr/local/man exists just for historical reasons, and
using /usr/local/share/man is better anyway.

http://www.pathname.com/fhs/pub/fhs-2.3.html#FTN.AEN1530 says:

  /usr/local/man may be deprecated in future FHS releases, so if
  all else is equal, making that one a symlink seems sensible.
#630779#26
Date:
2011-08-20 22:31:02 UTC
From:
To:
Ah, right, I was forgetting that $(SITEPREFIX) could be something
other than /usr/local. Thanks for the clarification.

Dominic.