Re: where should manpages and .packlist for rt4 extensions go?

[Greg Troxel <gdt%lexort.com@localhost>]

"S.P.Zeidler" <spz%NetBSD.org@localhost> writes:

> Hi,
>
> (also directly paging ryoon@ who is MAINTAINER for devel/rt4)
>
> Thus wrote Greg Troxel (gdt%lexort.com@localhost):
>
>> "S.P.Zeidler" <spz%NetBSD.org@localhost> writes:
>> 
>> True, but I would try to fix this by  changing
>> 
>>     # INSTALLDIRS=vendor should install manpages into /usr/share/man.
>>     # That is the default path in most distributions. Need input from
>>     # Redhat, Centos etc.
>>     $self->makemaker_args( INSTALLVENDORMAN1DIR => "/usr/share/man/man1" );
>>     $self->makemaker_args( INSTALLVENDORMAN3DIR => "/usr/share/man/man3" );
>>     $self->makemaker_args( INSTALLVENDORARCH => "/usr/share/man" );
>> 
>> to instead substitute in the pgksrc paths (via patching to @MAN1@, and
>> then with SUBST_SED, in the build of the install module),
>
> $RT::BasePath is PREFIX and readily available.
>      $self->makemaker_args( INSTALLVENDORMAN1DIR => "$RT::BasePath/share/man/man1" );
>      $self->makemaker_args( INSTALLVENDORMAN3DIR => "$RT::BasePath/share/man/man3" );
>
> gives us manpages in the appropriate subdirs of (prefix=/usr/pkg)
> /usr/pkg/share/man and that makes sense.

/usr/pkg/share/man isn't the right place.  pkgsrc normally puts things
in ${PREFIX}/man as ${PREFIX}/man/man1/foo.1   Yes, this is different
from many other systems, and yes, it causes us some trouble.

$ make show-vars VARNAMES=PKGMANDIR
man

> However, if we point INSTALLVENDORARCH to PREFIX/share/man, we get
> auto/RT/Extension/ExtensionName/.packlist put there for a packlist
> listing the perl modules and the man pages, and I think that's ugly.
>
> $self->makemaker_args( INSTALLVENDORARCH => "$RT::PluginPath/$name/$Config{api_versionstring}/$Config{archname}"
>
> puts the .packlist into e.g. (prefix=/usr/pkg, perl=5.28, amd64):
> /usr/pkg/share/rt4/plugins/RT-Extension-ExtensionName/5.28.0/x86_64-netbsd-thread-multi/auto/RT/Extension/ExtensionName/.packlist
>
> with the rest of the parts of the extension plugin also under
> /usr/pkg/share/rt4/plugins/RT-Extension-ExtensionName, e.g.
> /usr/pkg/share/rt4/plugins/RT-Extension-ExtensionName/lib/RT/Extension/ExtensionName.pm
>
> The default for perl packages in pkgsrc would put things into
> /usr/pkg/lib/perl5/vendor_perl/5.28.0
> and the packlist into
> /usr/pkg/lib/perl5/vendor_perl/5.28.0/x86_64-netbsd-thread-multi/auto/RT/Extension/ExtensionName/.packlist
> so we would match the usual path for .packlist with a different topdir,
> giving if not least, less surprise.
>
> (p5-* manpages end up under /usr/pkg/lib/perl5/vendor_perl/man;
> that's not usually in MANPATH)

I am not really familiar with these perl details, so I'll defer to
ryoon.