Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

incpth vs incpath documentation confusion #16153

Open
p5pRT opened this issue Sep 16, 2017 · 3 comments
Open

incpth vs incpath documentation confusion #16153

p5pRT opened this issue Sep 16, 2017 · 3 comments

Comments

@p5pRT
Copy link

p5pRT commented Sep 16, 2017

Migrated from rt.perl.org#132106 (status was 'open')

Searchable as RT132106$

@p5pRT
Copy link
Author

p5pRT commented Sep 16, 2017

From @ntyni

Quoting Porting/Glossary​:

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.

However, reading Configure, these are quite different things. It looks
like the description of incpth here is wrong and just accidentally
duplicated from incpath.

The incpth description was introduced in commit v5.19.8-19-g56b575b98e,
but the Configure functionality had been there since 2001 (5440bc8
/ 93bc48f), initially only for cross compilation but later
(since v5.19.7-266-gbe3e7e29fa) also for native builds.

Based on current Configure, I suggest this description for incpth​:

This variable contains a space separated list of the include directories
searched by the preprocessor. If that cannot be determined, it defaults
to the contents of 'usrinc'.

Perl Info

Flags:
    category=docs
    severity=low

Site configuration information for perl 5.27.4:

Configured by niko at Sat Sep 16 20:17:32 EEST 2017.

Summary of my perl5 (revision 5 version 27 subversion 4) configuration:
  Commit id: 07d51b5358c64b41da1bc50212be10cc23242c2a
  Platform:
    osname=linux
    osvers=4.11.0-2-amd64
    archname=x86_64-linux
    uname='linux estella 4.11.0-2-amd64 #1 smp debian 4.11.11-1 (2017-07-22) x86_64 gnulinux '
    config_args='-des -Dusedevel'
    hint=recommended
    useposix=true
    d_sigaction=define
    useithreads=undef
    usemultiplicity=undef
    use64bitint=define
    use64bitall=define
    uselongdouble=undef
    usemymalloc=n
    default_inc_excludes_dot=define
    bincompat5005=undef
  Compiler:
    cc='cc'
    ccflags ='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -D_FORTIFY_SOURCE=2'
    optimize='-O2'
    cppflags='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include'
    ccversion=''
    gccversion='7.1.0'
    gccosandvers=''
    intsize=4
    longsize=8
    ptrsize=8
    doublesize=8
    byteorder=12345678
    doublekind=3
    d_longlong=define
    longlongsize=8
    d_longdbl=define
    longdblsize=16
    longdblkind=3
    ivtype='long'
    ivsize=8
    nvtype='double'
    nvsize=8
    Off_t='off_t'
    lseeksize=8
    alignbytes=8
    prototype=define
  Linker and Libraries:
    ld='cc'
    ldflags =' -fstack-protector-strong -L/usr/local/lib'
    libpth=/usr/local/lib /usr/lib/gcc/x86_64-linux-gnu/7/include-fixed /usr/include/x86_64-linux-gnu /usr/lib /lib/x86_64-linux-gnu /lib/../lib /usr/lib/x86_64-linux-gnu /usr/lib/../lib /lib
    libs=-lpthread -lnsl -lgdbm -ldb -ldl -lm -lcrypt -lutil -lc -lgdbm_compat
    perllibs=-lpthread -lnsl -ldl -lm -lcrypt -lutil -lc
    libc=libc-2.24.so
    so=so
    useshrplib=false
    libperl=libperl.a
    gnulibc_version='2.24'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs
    dlext=so
    d_dlsymun=undef
    ccdlflags='-Wl,-E'
    cccdlflags='-fPIC'
    lddlflags='-shared -O2 -L/usr/local/lib -fstack-protector-strong'



@INC for perl 5.27.4:
    lib
    /usr/local/lib/perl5/site_perl/5.27.4/x86_64-linux
    /usr/local/lib/perl5/site_perl/5.27.4
    /usr/local/lib/perl5/5.27.4/x86_64-linux
    /usr/local/lib/perl5/5.27.4


Environment for perl 5.27.4:
    HOME=/home/niko
    LANG=en_US.UTF-8
    LANGUAGE (unset)
    LC_CTYPE=fi_FI.UTF-8
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/home/niko/bin:/home/niko/bin:/home/niko/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games:/sbin:/usr/sbin:/sbin:/usr/sbin
    PERL_BADLANG (unset)
    SHELL=/bin/zsh

@p5pRT
Copy link
Author

p5pRT commented Sep 30, 2017

From @jkeenan

On Sat, 16 Sep 2017 18​:17​:03 GMT, ntyni@​debian.org wrote​:

This is a bug report for perl from Niko Tyni <ntyni@​debian.org>,
generated with the help of perlbug 1.40 running under perl 5.27.4.

-----------------------------------------------------------------
[Please describe your issue here]

Quoting Porting/Glossary​:

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.

However, reading Configure, these are quite different things. It looks
like the description of incpth here is wrong and just accidentally
duplicated from incpath.

The incpth description was introduced in commit v5.19.8-19-
g56b575b98e,
but the Configure functionality had been there since 2001 (5440bc8
/ 93bc48f), initially only for cross compilation but later
(since v5.19.7-266-gbe3e7e29fa) also for native builds.

Based on current Configure, I suggest this description for incpth​:

This variable contains a space separated list of the include
directories
searched by the preprocessor. If that cannot be determined, it
defaults
to the contents of 'usrinc'.

Contacting people familiar with Configure.

Thank you very much.

--
James E Keenan (jkeenan@​cpan.org)

@p5pRT
Copy link
Author

p5pRT commented Sep 30, 2017

The RT System itself - Status changed from 'new' to 'open'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants