perl5.8 fixup

[Eric Hall]

On Thu, Mar 12, 2009 at 03:21:11PM -0700, Bradley Giesbrecht wrote:
> 
> On Mar 10, 2009, at 5:24 PM, Eric Hall wrote:
> 
> >[snip]
> >
> >	I've attached a set of patches to:
> >
> >	http://trac.macports.org/ticket/12950#comment:14
> >
> >	for testing.  So far so good for me.
> >
> >
> >		-eric
> 
> Eric, it appears that changing the man1dir and man3dir to man1p and  
> man3p causes these man dirs to be searched after all the man1 and man3  
> dirs in the search path. I didn't explain that well so I'll try again.
> 
> I think man must be searching all the man0 though man9 dirs before  
> searching man1p and man3p. Or something like it.


	Again, see /etc/man.conf, in particular the MANSECT line.


> 
> /usr/share/man/man3/CGI.3pm.gz is found before /opt/local/share/ 
> perl5.8/man/man3p/CGI.3pm even when MANPATH looks like this:
> 
> /opt/local/share/man:/usr/share/man:/usr/X11/man:/usr/local/share/man
> 
> I'm not saying I like this solution but changing the Portfile to add  
> perl5.8/man:
>     -D man1dir='${prefix}/share/perl5.8/man/man1' \
>     -D man3dir='${prefix}/share/perl5.8/man/man3' \
>     -D siteman1dir='${prefix}/share/man/man1' \
>     -D siteman3dir='${prefix}/share/man/man3' \
>     -D vendorman1dir='${prefix}/share/man/man1' \
>     -D vendorman3dir='${prefix}/share/man/man3'
> 
> and making my MANPATH look like:
> 
> /opt/local/share/man:/opt/local/share/perl5.8/man:/opt/local/man:/usr/ 
> share/man:/usr/X11/man:/usr/local/share/man
> 
> causes perl5.8 module man pages to be found before apple installed man  
> pages.

	I really don't like changing MANPATH, its auto-generated
(for the most part) and I think that's a Good Thing(tm).  Forcing
people to set a MANPATH will result in breakage.

	I agree it'd be better to get the MP installed man pages
first - that does happen for p5-* installed man pages, but
not for the base perl5.8 installed man pages.  I think that's
an acceptable loss, though not ideal.


		-eric