perl5 icon indicating copy to clipboard operation
perl5 copied to clipboard

Porting/Glossary: 'incpath' versus 'incpth'

Open jkeenan opened this issue 1 year ago • 2 comments

In Porting/Glossary, I observe these two entries right next to each other:

incpath (usrinc.U):
    This variable must precede the normal include path to get the
    right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
    Value can be "" or "/bsd43" on mips.

incpth (libpth.U):
    This variable must precede the normal include path to get the
    right one, as in "$incpath/usr/include" or "$incpath/usr/lib".
    Value can be "" or "/bsd43" on mips.

The body of the entry for incpath is identical to that for incpth, which means that the description for incpath, which twice mentions $incpath, seems internally inconsistent.

Can someone clarify what each of these things is supposed to do -- and whether the wording is accurate or not? (I'm asking because incpth was mentioned in https://github.com/timbunce/devel-nytprof/issues/217.) Thanks.

jkeenan avatar May 03 '24 22:05 jkeenan

I have the impression they're actually different things. I think the incpth description is correct but the incpath one isn't. I'm not sure I fully understand incpath but it seems to be some kind of prefix that was only used on BSD 4.3, probably we should just get rid of it to avoid future confusion.

Leont avatar May 04 '24 14:05 Leont

incpth is backported from a patch in Jan 2014. incpath is originated in the original meta/dist repository from a change by Manfredi in November 2010 and never touched by perl-people.

I am aware that this does only add to the confusion. It would require serious digging into the history of the two.

Tux avatar May 13 '24 14:05 Tux